Webhook

AI4CALL può chiamare URL configurati per gli esiti legati alle chiamate. La configurazione accetta URL http:// o https://; in produzione usa HTTPS, valida il JSON atteso e correla gli eventi con la richiesta o chiamata salvata dalla tua applicazione.

Callback esito outbound

Imposta callResultUrl quando avvii una chiamata outbound. AI4CALL invia:

{
  "internal_id": "<YOUR_CORRELATION_ID>",
  "dialstatus": "ANSWER",
  "duration": 42
}

La callback comunica solo l’esito outbound; non contiene la trascrizione della conversazione.

Conversazione e post-call

Configura l’endpoint di fine conversazione con PATCH /assistants/{assistantId}/runtime/hangup/conversation-webhook:

{
  "enabled": true,
  "url": "https://example.com/hooks/ai4call",
  "authName": "crm-bearer"
}

authName è il nome di un’autenticazione già salvata per il cliente. Le relative credenziali sono risolte lato server e non viaggiano nella richiesta. Invia authName: null per spedire senza autenticazione; disabilita l’integrazione con enabled: false.

Configura l’estrazione dati strutturati con PATCH /assistants/{assistantId}/runtime/hangup/schema:

{
  "hangupUrl": "https://example.com/hooks/extracted-data",
  "schema": [{
    "name": "customerIntent",
    "type": "string",
    "description": "Motivo principale della chiamata",
    "required": true
  }]
}

I tipi proprietà dello schema sono string, number, boolean, enum e object. Configura MCP post-call separatamente tramite /runtime/postcall/mcp-config.

Non presumere l’invio di una firma HMAC: la firma webhook non fa parte del contratto attuale. Per i payload di configurazione esatti consulta il Riferimento API.