Aller au contenu
FR
Ouvrir l’app

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

2 min de lecture
Copier en Markdown
Voir en MarkdownOuvrir le fichier .md brut.md

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.

Trigger On API Call sur le canevas
wf-apiExpand

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.

  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.

    Paramètres Payload Schema de On API Call
    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).

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.