For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/fr/workflows/on-api-call.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.
On API Call
On API Call démarre le graphe depuis votre système - CRM, formulaire, bouton (Runs when: When an API call is made). Il n’a pas besoin d’attachement d’agent. Les triggers de téléphone en ont besoin.

Pourquoi ce trigger
Section intitulée « Pourquoi ce trigger »Une liste selon un calendrier est Campaigns. Un seul appel sortant IA est initiate-call. Ceci est “exécuter cette automation maintenant” avec un corps JSON - envoyer un email, mettre à jour une feuille, faire diverger des nœuds. Mettez Make Outbound Call sur le graphe seulement si l’étape suivante est réellement un appel.
Première configuration
Section intitulée « Première configuration »-
+ Add Trigger - On API Call
Payload Schema est le schéma JSON du corps POSTé au point de terminaison run-workflow (avec votre clé API). Validé en direct. L’objet vide par défaut sans champs requis accepte n’importe quel objet. Des schémas d’exemple et un assistant cURL apparaissent dans le panneau ; créez une clé API si vous en avez besoin.

on-api-call-form -
Depuis Work Flow Triggered, ajoutez des nœuds qui lisent ces clés.
-
Save & go live. Copiez l’id du workflow depuis l’URL ou la liste.
-
POST avec une clé API qui peut exécuter des workflows :
POST https://api.voicelogica.ai/api/v1/agentic/work-flows/run-workflow/YOUR_WORKFLOW_IDx-api-key: YOUR_API_KEYContent-Type: application/json{"order_id": "ORD123","email": "ada@example.com"} -
Confirmez que les nœuds se sont exécutés (email, feuille, ou un dry-run du constructeur d’abord).
Dépannage
Section intitulée « Dépannage »Dois-je utiliser initiate-call ou le trigger On API Call ?
Si vous voulez que l’agent appelle un numéro, utilisez initiate-call. Si vous voulez exécuter le workflow (e-mail, feuille, branches), utilisez le trigger On API Call.
Pourquoi ne puis-je pas enregistrer mon workflow On API Call à cause du schéma de charge utile ?
Le schéma doit être un JSON Schema valide pour le dialecte vérifié par le panneau. Partez de l’objet par défaut ou d’un schéma d’exemple, puis cliquez sur Beautify.
