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.

wf-apiExpand

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

1. + 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-formExpand

2. Depuis Work Flow Triggered, ajoutez des nœuds qui lisent ces clés.

3. Save & go live. Copiez l’id du workflow depuis l’URL ou la liste.

4. 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_ID

   x-api-key: YOUR_API_KEY
   Content-Type: application/json

   {
     "order_id": "ORD123",
     "email": "ada@example.com"
   }

5. Confirmez que les nœuds se sont exécutés (email, feuille, ou un dry-run du constructeur d’abord).

Dépannage

Devrais-je utiliser initiate-call ?

Besoin que l’agent parle à un numéro - initiate-call. Besoin que le graphe s’exécute (email, feuille, branches) - ce trigger.

L'enregistrement est bloqué sur le schéma de charge utile

Le schéma doit être un JSON Schema valide pour le dialecte que le panneau valide. Commencez depuis l’objet par défaut, ou utilisez un bouton de schéma d’exemple, puis Beautify.

Prochaines étapes

Exécuter un workflow - Enregistrer, puis ce POST.→Workflow Nodes - quoi mettre après le trigger.→Clés API - clé avec portée d’exécution de workflow.→