Skip to main content
Le nœud Déclencheur (trigger) est le point d’entrée d’un workflow lorsqu’un appel est déclenché par API (votre CRM, un script, un autre service) plutôt que par un appel entrant classique. Un workflow contient au plus un déclencheur.

​
Champs du nœud

​
Le chemin

Le chemin est la partie variable de l’URL de votre agent. Choisissez un identifiant stable et explicite, par exemple prise-rdv-acme ou relance_panier.
Si vous laissez le chemin vide, aucune URL n’est générée et le déclencheur n’est pas opérationnel. Renseignez un chemin pour l’activer.

​
L’URL générée

À partir du chemin, Bookivox génère une URL de webhook dédiée à votre agent. Vous la trouvez dans le panneau du nœud ainsi que dans Clés d’API.
Utilisez la version de test de l’agent pour valider vos modifications avant publication, puis l’URL de production une fois l’agent publié. Voir Versions.

​
Corps de la requête

L’endpoint accepte un corps JSON.
  • Vous devez fournir une clé d’API dans l’en-tête X-API-Key.
  • telephony_configuration_id doit appartenir à la même organisation que le déclencheur. Sinon, la configuration téléphonique sortante par défaut de l’organisation est utilisée.

​
Exemple d’appel

Les clés de initial_context deviennent des variables accessibles dans vos prompts : {{initial_context.first_name}}, {{initial_context.order_ref}}.

​
Quand l’utiliser

Votre CRM déclenche un appel et transmet le nom du client, la commande, etc.
Un service planifie des relances et appelle via l’API à heure fixe.
L’agent démarre avec du contexte déjà connu, sans avoir à le demander au client.
Un événement métier déclenche un appel immédiat (livraison, incident, rendez-vous manqué).

​
Contraintes

  • Un workflow contient au plus un déclencheur.
  • Le nœud est isolé : il n’a ni entrée, ni sortie. C’est une porte d’entrée, pas une étape du chemin.
  • Le chemin est unique dans votre organisation.
  • Le déclencheur n’apparaît que si vous concevez l’agent pour être appelé par API.

​
Sécurité

  • Ne partagez jamais votre clé d’API et ne la placez pas dans du code client (navigateur, application mobile).
  • Traitez initial_context comme une entrée non fiable : validez-la côté serveur avant de la transmettre.
  • Désactivez le déclencheur si vous ne l’utilisez pas : l’URL renverra 404.
  • Surveillez l’usage : un endpoint public peut être la cible d’abus. Voir Clés d’API.

Clés d'API

Créer et gérer les clés.

Endpoints

La référence des endpoints.

Réglages de l'agent

Variables et contexte.

Le canevas du builder

Revenir à l’éditeur.
Last modified on October 28, 2026