# On API Call

**On API Call** avvia il grafico dal *suo* sistema - CRM, modulo, pulsante (**Runs when: When an API call is made**). **Non** richiede un collegamento all'agent. I trigger telefonici sì.

  <ShotPlaceholder
    src="/assets/workflows/on-api-call.png"
    name="wf-api"
    alt="Trigger On API Call sulla tela"
    capture="Tela On API Call."
  />

## Perché questo trigger

Un elenco su un programma sono le [Campaigns](https://docs.voicelogica.ai/it/outbound-calls/campaigns/). Una singola chiamata in uscita IA è [initiate-call](https://docs.voicelogica.ai/it/outbound-calls/api/). Questo è "esegui questa automazione ora" con un corpo JSON - invii email, aggiorni un foglio, distribuisca nodi. Metta **Make Outbound Call** sul grafico solo se il passo successivo è effettivamente una chiamata.

## Prima configurazione

1. **+ Add Trigger - On API Call**

   **Payload Schema** è lo schema JSON del corpo inviato tramite POST all'endpoint run-workflow (con la sua chiave API). Convalidato in tempo reale. L'oggetto vuoto predefinito senza campi obbligatori accetta qualsiasi oggetto. Schemi di esempio e un helper cURL appaiono nel pannello; crei una [chiave API](https://docs.voicelogica.ai/it/getting-started/api-keys/) se ne ha bisogno.

     <ShotPlaceholder
       src="/assets/workflows/on-api-call-form.png"
       name="on-api-call-form"
       alt="Impostazioni Payload Schema di On API Call"
       capture="Impostazioni trigger On API Call."
     />

2. Da **Work Flow Triggered**, aggiunga nodi che leggono quelle chiavi.

3. **Save & go live**. Copi l'id del workflow dall'URL o dall'elenco.

4. Invii POST con una chiave API che può eseguire workflow:

   ```
   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. Confermi che i nodi sono stati eseguiti (email, foglio, o prima un dry-run del builder).

## Risoluzione dei problemi

**Dovrei usare initiate-call?**

Ha bisogno che l'*agent* parli a un numero - [initiate-call](https://docs.voicelogica.ai/it/outbound-calls/api/). Ha bisogno che il *grafico* venga eseguito (email, foglio, rami) - questo trigger.

**Il salvataggio è bloccato sullo schema del payload**

Lo schema deve essere un JSON Schema valido per il dialetto che il pannello convalida. Parta dall'oggetto predefinito, o utilizzi un pulsante dello schema di esempio, poi Beautify.

## Prossimi passi

[Get a workflow running](https://docs.voicelogica.ai/it/workflows/) - Salvi, poi questo POST.  
[Workflow Nodes](https://docs.voicelogica.ai/it/workflow-nodes/) - cosa mettere dopo il trigger.  
[API keys](https://docs.voicelogica.ai/it/getting-started/api-keys/) - chiave con ambito di esecuzione workflow.