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

wf-apiExpand

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

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 se ne ha bisogno.

   

   on-api-call-formExpand

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

   x-api-key: YOUR_API_KEY
   Content-Type: application/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. 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 - Salvi, poi questo POST.→Workflow Nodes - cosa mettere dopo il trigger.→API keys - chiave con ambito di esecuzione workflow.→