For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/it/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 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ì.

Perché questo trigger
Sezione intitolata “Perché questo trigger”Un elenco su un programma sono le Campaigns. Una singola chiamata in uscita IA è initiate-call. 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
Sezione intitolata “Prima configurazione”-
+ 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 se ne ha bisogno.

on-api-call-form -
Da Work Flow Triggered, aggiunga nodi che leggono quelle chiavi.
-
Save & go live. Copi l’id del workflow dall’URL o dall’elenco.
-
Invii POST con una chiave API che può eseguire workflow:
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"} -
Confermi che i nodi sono stati eseguiti (email, foglio, o prima un dry-run del builder).
Risoluzione dei problemi
Sezione intitolata “Risoluzione dei problemi”Devo usare initiate-call o il trigger On API Call?
Se vuole che l’agent chiami un numero, usi initiate-call. Se vuole eseguire il workflow (email, foglio, rami), usi il trigger On API Call.
Perché non riesco a salvare il mio workflow On API Call a causa dello schema del payload?
Lo schema deve essere un JSON Schema valido per il dialetto che il pannello convalida. Parta dall’oggetto predefinito o da uno schema di esempio, poi clicchi su Beautify.
