Salta ai contenuti
IT
Apri l’app

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

2 min di lettura
Copia come Markdown
Visualizza come MarkdownApri il file .md.md

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

Trigger On API Call sulla tela
wf-apiExpand

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.

  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.

    Impostazioni Payload Schema di On API Call
    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).

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.