Integrazioni
Invia un webhook o chiama un'API da un'automazione.
Ultimo aggiornamento il
Questi passaggi si trovano nel gruppo Integrazioni. Una consegna non riuscita prosegue tramite Non riuscito. Per le altre azioni leggi Se un passaggio fallisce.
Invia webhook
Consegna un messaggio personalizzato a uno degli endpoint webhook della tua organizzazione. È utile per avvisare un altro sistema, per esempio il tuo sistema di cassa o il tuo sito web.
| Campo | Cosa inserire |
|---|---|
| Endpoint | Scegli uno dei tuoi endpoint webhook. Li riconosci dal loro indirizzo. Obbligatorio |
| Nome dell'evento | Il nome che viaggia con il messaggio, così il destinatario può riconoscerlo, per esempio automation.invoice_unpaid. Obbligatorio |
| Payload | Il contenuto del messaggio, in JSON. Le variabili vengono compilate prima dell'invio. Obbligatorio |
Crei e gestisci gli endpoint dal menu del profilo sotto Sviluppatori. L'endpoint deve esistere ed essere attivo. In caso contrario il passaggio fallisce e l'esecuzione si interrompe.
Il messaggio viene firmato con la chiave propria dell'endpoint, esattamente come gli altri webhook che l'endpoint riceve. Tillor riprova alcune volte se il tuo server non risponde correttamente. L'endpoint non deve seguire il nome del tuo evento: il messaggio arriva comunque.
Il passaggio ha due uscite:
| Uscita | Quando |
|---|---|
| Riuscito | Il tuo server ha risposto con uno stato di successo |
| Non riuscito | La consegna è fallita dopo tutti i tentativi. Il messaggio viene poi riprovato in background, come un normale webhook |
Il modello Invia le prenotazioni a un altro sistema usa Non riuscito per creare un'attività, così qualcuno se ne occupa.
Un payload ha per esempio questo aspetto:
{
"reservation": "{reservation.displayId}",
"checkIn": "{reservation.checkIn}",
"adults": {reservation.numberOfAdults},
"customer": {
"firstName": "{reservation.customer.firstName}",
"email": "{reservation.customer.email}"
}
}Metti il testo tra virgolette e i numeri senza. Le date passano in JSON come data e ora internazionali, come 2026-10-05T08:00:00.000Z. Leggi Variabili e modelli per i dettagli. Il lato tecnico, come la struttura del messaggio, è descritto in Sviluppatori > Automazioni.
Richiesta API
Chiama la Tillor API della tua organizzazione, oppure un altro indirizzo su internet. Con questa puoi fare quasi tutto ciò che fa Tillor e cercare dati per poi farci qualcosa.
In Invia a scegli tra Tillor API e URL personalizzato. In Metodo scegli GET (richiedere), POST (creare), PUT o PATCH (modificare) oppure DELETE (eliminare).
Tillor API
| Campo | Cosa inserire |
|---|---|
| Percorso | La parte dell'indirizzo dopo l'API della tua organizzazione, per esempio /tasks o /tasks/{task.id}. Deve iniziare con /. Obbligatorio |
| Corpo | I dati che invii, in JSON. Lascia vuoto se non invii nulla |
In cima al campo trovi Scegli un endpoint API. Fai clic e cerca nell'elenco, per esempio tasks. Quando scegli un endpoint, Tillor compila il metodo e il percorso. Se il Corpo è ancora vuoto, ottieni anche un esempio di ciò che l'endpoint si aspetta. Sostituisci i nomi tra parentesi graffe nel percorso con variabili di passaggi precedenti. Se ci sono parametri di query, li vedi sotto il campo.
La chiamata avviene come utente Flusso di lavoro e non può mai uscire dalla tua organizzazione. Un'automazione non può gestire automazioni, quindi le chiamate che riguardano automazioni o le loro esecuzioni vengono rifiutate.
URL personalizzato
| Campo | Cosa inserire |
|---|---|
| URL | L'indirizzo. Deve iniziare con https://. Obbligatorio |
| Intestazioni | Dati aggiuntivi per il destinatario, per esempio una chiave. Fai clic su Aggiungi intestazione e compila Nome e Valore |
| Corpo | I dati che invii, in JSON. Lascia vuoto se non invii nulla |
Valgono queste regole:
- Gli indirizzi senza
https://vengono rifiutati - Gli indirizzi privati e interni vengono rifiutati, anche se un nome normale punta a essi
- I reindirizzamenti non vengono seguiti. Se il server risponde con un reindirizzamento, conta come Non riuscito
- Le intestazioni vengono salvate cifrate. Puoi quindi inserirvi una chiave o un token
- Con GET e DELETE non viene inviato alcun corpo
Uscite e risposta
La richiesta ha due uscite: Riuscito (il server ha risposto con uno stato di successo) e Non riuscito (il server ha risposto con uno stato di errore). Se Tillor non raggiunge affatto il server, per esempio per un timeout dopo 15 secondi o un indirizzo rifiutato, l'esecuzione si interrompe con lo stato Non riuscita.
Per i passaggi successivi ci sono tre variabili:
| Variabile | Contenuto |
|---|---|
{response.status} | Il codice di stato, per esempio 200 |
{response.body} | La risposta come testo, abbreviata ai primi 4000 caratteri |
{response.data} | La risposta come dati, così puoi estrarne campi con {response.data.items.0.id} |
Come usarla è spiegato in Usare una risposta API. Un esempio completo con una ricerca si trova in Controllo della casa mobile in affitto.