# 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.

  <ShotPlaceholder
    src="/assets/workflows/on-api-call.png"
    name="wf-api"
    alt="Trigger On API Call sur le canevas"
    capture="Canevas On API Call."
  />

## Pourquoi ce trigger

Une liste selon un calendrier est [Campaigns](https://docs.voicelogica.ai/fr/outbound-calls/campaigns/). Un seul appel sortant IA est [initiate-call](https://docs.voicelogica.ai/fr/outbound-calls/api/). 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](https://docs.voicelogica.ai/fr/getting-started/api-keys/) si vous en avez besoin.

     <ShotPlaceholder
       src="/assets/workflows/on-api-call-form.png"
       name="on-api-call-form"
       alt="Paramètres Payload Schema de On API Call"
       capture="Paramètres du trigger On API Call."
     />

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
   ```

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

   ```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](https://docs.voicelogica.ai/fr/outbound-calls/api/). 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](https://docs.voicelogica.ai/fr/workflows/) - Enregistrer, puis ce POST.  
[Workflow Nodes](https://docs.voicelogica.ai/fr/workflow-nodes/) - quoi mettre après le trigger.  
[Clés API](https://docs.voicelogica.ai/fr/getting-started/api-keys/) - clé avec portée d'exécution de workflow.