Intégrations
Envoyez un webhook ou appelez une API depuis une automatisation.
Dernière mise à jour le
Ces étapes se trouvent dans le groupe Intégrations. Une livraison échouée continue via Échoué. Pour les autres actions, lisez Quand une étape échoue.
Envoyer un webhook
Livre un message personnalisé à l'un des endpoints webhook de votre organisation. C'est pratique pour prévenir un autre système, par exemple votre système de caisse ou votre site web.
| Champ | Ce que vous saisissez |
|---|---|
| Endpoint | Choisissez l'un de vos endpoints webhook. Vous les reconnaissez à leur adresse. Obligatoire |
| Nom de l'événement | Le nom envoyé avec le message pour que le destinataire puisse le reconnaître, par exemple automation.invoice_unpaid. Obligatoire |
| Charge utile | Le contenu du message, au format JSON. Les variables sont remplacées avant l'envoi du message. Obligatoire |
Vous créez et gérez les endpoints via le menu du profil sous Développeurs. L'endpoint doit exister et être activé. Sinon, l'étape échoue et l'exécution s'arrête.
Le message est signé avec la clé propre à l'endpoint, exactement comme les autres webhooks que l'endpoint reçoit. Tillor réessaie plusieurs fois si votre serveur ne répond pas correctement. L'endpoint n'a pas besoin de suivre le nom de votre événement : le message arrive de toute façon.
L'étape a deux sorties :
| Sortie | Quand |
|---|---|
| Réussi | Votre serveur a répondu avec un statut de réussite |
| Échoué | La livraison a échoué après toutes les tentatives. Le message est ensuite encore réessayé en arrière-plan, comme un webhook ordinaire |
Le modèle Envoyer les réservations vers un autre système utilise Échoué pour créer une tâche afin que quelqu'un s'en occupe.
Une charge utile ressemble par exemple à ceci :
{
"reservation": "{reservation.displayId}",
"checkIn": "{reservation.checkIn}",
"adults": {reservation.numberOfAdults},
"customer": {
"firstName": "{reservation.customer.firstName}",
"email": "{reservation.customer.email}"
}
}Mettez le texte entre guillemets et les nombres sans guillemets. Les dates sont transmises en JSON sous forme de date et d'heure internationales, comme 2026-10-05T08:00:00.000Z. Lisez Variables et modèles pour les détails. Le côté technique, comme la structure du message, se trouve sous Développeurs > Automatisations.
Requête API
Appelle la Tillor API de votre propre organisation, ou une autre adresse sur Internet. Vous pouvez ainsi faire presque tout ce que Tillor sait faire, et rechercher des données pour en faire ensuite quelque chose.
Sous Envoyer à, vous choisissez entre Tillor API et URL personnalisée. Sous Méthode, vous choisissez GET (consulter), POST (créer), PUT ou PATCH (modifier) ou DELETE (supprimer).
Tillor API
| Champ | Ce que vous saisissez |
|---|---|
| Chemin | La partie de l'adresse après l'API de votre organisation, par exemple /tasks ou /tasks/{task.id}. Il doit commencer par /. Obligatoire |
| Corps | Les données que vous envoyez, au format JSON. Laissez vide si vous n'envoyez rien |
En haut du champ se trouve Choisissez un endpoint API. Cliquez dessus et cherchez dans la liste, par exemple tasks. Quand vous choisissez un endpoint, Tillor remplit la méthode et le chemin. Si le Corps est encore vide, vous obtenez aussi un exemple de ce que l'endpoint attend. Remplacez les noms entre accolades dans le chemin par des variables d'étapes précédentes. S'il y a des paramètres de requête, vous les voyez sous le champ.
L'appel est effectué en tant qu'utilisateur Flux de travail et ne peut jamais sortir de votre propre organisation. Une automatisation ne peut pas gérer des automatisations : les appels qui touchent aux automatisations ou à leurs exécutions sont refusés.
URL personnalisée
| Champ | Ce que vous saisissez |
|---|---|
| URL | L'adresse. Elle doit commencer par https://. Obligatoire |
| En-têtes | Données supplémentaires pour le destinataire, par exemple une clé. Cliquez sur Ajouter un en-tête et remplissez le Nom et la Valeur |
| Corps | Les données que vous envoyez, au format JSON. Laissez vide si vous n'envoyez rien |
Ces règles s'appliquent :
- Les adresses sans
https://sont refusées - Les adresses privées et internes sont refusées, même si un nom ordinaire y renvoie
- Les redirections ne sont pas suivies. Si le serveur répond par une redirection, cela compte comme Échoué
- Les en-têtes sont stockés chiffrés. Vous pouvez donc y mettre une clé ou un jeton
- Avec GET et DELETE, aucun corps n'est envoyé
Sorties et réponse
La requête a deux sorties : Réussi (le serveur a répondu avec un statut de réussite) et Échoué (le serveur a répondu avec un statut d'erreur). Si Tillor n'atteint pas du tout le serveur, par exemple à cause d'un délai dépassé après 15 secondes ou d'une adresse refusée, l'exécution s'arrête avec le statut Échoué.
Trois variables sont disponibles pour les étapes suivantes :
| Variable | Contenu |
|---|---|
{response.status} | Le code de statut, par exemple 200 |
{response.body} | La réponse sous forme de texte, tronquée aux 4000 premiers caractères |
{response.data} | La réponse sous forme de données, pour en extraire des champs avec {response.data.items.0.id} |
Vous trouverez comment les utiliser sous Utiliser une réponse d'API. Un exemple complet avec une recherche se trouve sous Contrôle d'une caravane de location.