Integrări
Trimite un webhook sau apelează un API dintr-o automatizare.
Ultima actualizare la
Acești pași se află în grupul Integrări. O livrare eșuată continuă prin Eșuat. Pentru celelalte acțiuni citești Când un pas eșuează.
Trimite webhook
Livrează un mesaj propriu la unul dintre endpoint-urile webhook ale organizației tale. E util pentru a anunța un alt sistem, de exemplu sistemul de casă sau site-ul tău.
| Câmp | Ce completezi |
|---|---|
| Endpoint | Alege unul dintre endpoint-urile tale webhook. Le recunoști după adresă. Obligatoriu |
| Numele evenimentului | Numele care însoțește mesajul, pentru ca destinatarul să îl poată recunoaște, de exemplu automation.invoice_unpaid. Obligatoriu |
| Payload | Conținutul mesajului, ca JSON. Variabilele sunt completate înainte ca mesajul să fie trimis. Obligatoriu |
Endpoint-urile le creezi și le gestionezi din meniul de profil, la Dezvoltatori. Endpoint-ul trebuie să existe și să fie activat. Dacă nu este, pasul eșuează și execuția se oprește.
Mesajul este semnat cu cheia proprie a endpoint-ului, exact ca celelalte webhook-uri pe care le primește endpoint-ul. Tillor încearcă din nou de câteva ori dacă serverul tău nu răspunde corect. Endpoint-ul nu trebuie să urmeze numele evenimentului tău: mesajul ajunge oricum.
Pasul are două ieșiri:
| Ieșire | Când |
|---|---|
| Reușit | Serverul tău a răspuns cu o stare de succes |
| Eșuat | Livrarea a eșuat după toate încercările. Mesajul mai este apoi reîncercat în fundal, ca un webhook obișnuit |
Șablonul Trimite rezervările către alt sistem folosește Eșuat pentru a crea o sarcină, astfel încât cineva să se ocupe de ea.
Un payload arată, de exemplu, așa:
{
"reservation": "{reservation.displayId}",
"checkIn": "{reservation.checkIn}",
"adults": {reservation.numberOfAdults},
"customer": {
"firstName": "{reservation.customer.firstName}",
"email": "{reservation.customer.email}"
}
}Pune textul între ghilimele și numerele fără. Datele se transmit în JSON ca dată și oră internaționale, de exemplu 2026-10-05T08:00:00.000Z. Citește Variabile și șabloane pentru detalii. Partea tehnică, cum ar fi structura mesajului, se află la Dezvoltatori > Automatizări.
Cerere API
Apelează API-ul Tillor al propriei organizații sau o altă adresă de pe internet. Cu el poți face aproape tot ce poate face Tillor și poți căuta date pentru a face apoi ceva cu ele.
La Trimite către alegi între Tillor API și URL personalizat. La Metodă alegi GET (interogare), POST (creare), PUT sau PATCH (modificare) ori DELETE (ștergere).
Tillor API
| Câmp | Ce completezi |
|---|---|
| Cale | Partea din adresă de după API-ul organizației tale, de exemplu /tasks sau /tasks/{task.id}. Trebuie să înceapă cu /. Obligatoriu |
| Corp | Datele pe care le trimiți, ca JSON. Lasă gol dacă nu trimiți nimic |
Deasupra câmpului se află Alege un endpoint API. Fă clic pe el și caută în listă, de exemplu tasks. Când alegi un endpoint, Tillor completează metoda și calea. Dacă Corp este încă gol, primești și un exemplu a ceea ce așteaptă endpoint-ul. Înlocuiește numele dintre acolade din cale cu variabile din pașii anteriori. Dacă există parametri de interogare, îi vezi sub câmp.
Apelul se face ca utilizatorul Flux de lucru și nu poate ieși niciodată din organizația ta. O automatizare nu poate gestiona automatizări, așa că apelurile care afectează automatizările sau rulările lor sunt refuzate.
URL personalizat
| Câmp | Ce completezi |
|---|---|
| URL | Adresa. Trebuie să înceapă cu https://. Obligatoriu |
| Anteturi | Date suplimentare pentru destinatar, de exemplu o cheie. Fă clic pe Adaugă antet și completează Nume și Valoare |
| Corp | Datele pe care le trimiți, ca JSON. Lasă gol dacă nu trimiți nimic |
Se aplică aceste reguli:
- Adresele fără
https://sunt refuzate - Adresele private și interne sunt refuzate, chiar dacă un nume obișnuit trimite la ele
- Redirecționările nu sunt urmate. Dacă serverul răspunde cu o redirecționare, se consideră Eșuat
- Anteturile sunt stocate criptat. Poți deci pune în ele o cheie sau un token
- La GET și DELETE nu se trimite corp
Ieșiri și răspuns
Cererea are două ieșiri: Reușit (serverul a răspuns cu o stare de succes) și Eșuat (serverul a răspuns cu o stare de eroare). Dacă Tillor nu ajunge deloc la server, de exemplu din cauza unui timeout după 15 secunde sau a unei adrese refuzate, execuția se oprește cu starea Eșuat.
Pentru pașii următori există trei variabile:
| Variabilă | Conținut |
|---|---|
{response.status} | Codul de stare, de exemplu 200 |
{response.body} | Răspunsul ca text, scurtat la primele 4000 de caractere |
{response.data} | Răspunsul ca date, astfel încât să poți extrage câmpuri din el cu {response.data.items.0.id} |
Cum le folosești se explică la Folosirea unui răspuns API. Un exemplu complet cu o căutare se află la Verificare caravană de închiriat.