Skip to Content
AutomatisationsActions

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.

ChampCe que vous saisissez
EndpointChoisissez l'un de vos endpoints webhook. Vous les reconnaissez à leur adresse. Obligatoire
Nom de l'événementLe nom envoyé avec le message pour que le destinataire puisse le reconnaître, par exemple automation.invoice_unpaid. Obligatoire
Charge utileLe 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 :

SortieQuand
RéussiVotre 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

ChampCe que vous saisissez
CheminLa partie de l'adresse après l'API de votre organisation, par exemple /tasks ou /tasks/{task.id}. Il doit commencer par /. Obligatoire
CorpsLes 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

ChampCe que vous saisissez
URLL'adresse. Elle doit commencer par https://. Obligatoire
En-têtesDonnées supplémentaires pour le destinataire, par exemple une clé. Cliquez sur Ajouter un en-tête et remplissez le Nom et la Valeur
CorpsLes 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 :

VariableContenu
{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.

Cette page t'a-t-elle été utile ?

Sur cette page