Passa al contenuto principale
Azioni

Invia i dati della chiamata al tuo sistema

Dopo ogni chiamata, invia il riepilogo, la trascrizione e i dati raccolti al tuo CRM, al tuo webhook o al tuo database.

Chiamata API invia la chiamata al tuo sistema quando è terminata: il riepilogo, la trascrizione, lo stato d'animo e tutto ciò che l'agente ha raccolto. Usala per creare un lead nel tuo CRM, avviare un'automazione o tenere i tuoi archivi. Se il tuo sistema non è raggiungibile, la richiesta viene ritentata e non si perde nulla.

Configurarla​

  1. Aggiungi l'azione

    Apri l'agente → Azioni → Aggiunga strumento → Post call → Chiamata API.

  2. Puntala al tuo endpoint
    CampoCosa inserire
    Nomead es. Sincronizzazione lead CRM
    CondizioneQuando inviarla, ad es. se chi chiama vuole acquistare. Vuoto: dopo ogni chiamata
    URL endpoint APIIl tuo endpoint, ad es. https://hooks.example.com/hanc
    Metodo HTTPPOST per la maggior parte dei sistemi; funzionano anche GET, PUT, PATCH, DELETE
    Header, Parametri queryFacoltativi, ad es. una chiave API
  3. Dai forma alla richiesta (facoltativo)
    • Corpo (JSON): i tuoi campi. Digita {{ per inserire una variabile della chiamata, ad es. {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Invia solo i miei campi: esclude i dati standard della chiamata, per un sistema che accetta solo la propria struttura.
  4. Decidi cosa succede in caso di errore
    • Nuovi tentativi in caso di errore: le pause prima di ogni nuovo tentativo quando il tuo endpoint non risponde con 2xx. Predefinito: 1 min, 5 min, 30 min, 2 h, 6 h, 24 h, 48 h.
    • Notifica in caso di errore: un'email dopo l'ultimo tentativo (predefinito), dopo ogni tentativo fallito oppure mai. Invia a: vuoto significa il proprietario dell'account.

Che cosa riceverà il mio endpoint? nell'editor mostra la richiesta esatta.

Cosa riceve il tuo endpoint​

Per POST, PUT e PATCH, un corpo JSON: i tuoi campi uniti ai campi della chiamata:

{
  "id": "6ac7ea6eca60c6024b465c70",
  "agent_id": "6ac2a93e36bad261cf088684",
  "call_from": "+431234567890",
  "call_to": "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "success",
  "start_timestamp": 1730000000000,
  "end_timestamp": 1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user", "content": "Hi…", "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": { "name": "John", "email": "john@example.com" },
  "collected_data": {},
  "transfer_history": [],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

Per GET e DELETE gli stessi campi vanno nella query string, senza quelli annidati (trascrizione, stato d'animo, dati raccolti).

Ogni richiesta porta X-Hanc-Delivery-Id — uguale in tutti i tentativi di una stessa consegna, così puoi scartare i duplicati — più X-Hanc-Attempt con il numero del tentativo. Ogni tentativo scade dopo 30 secondi. Tutti i tentativi sono elencati in CRM → Comunicazioni, dove una consegna fallita si può inviare di nuovo. Dettagli: Webhook e consegna.

Casi d'uso​

  • Creare un lead o un ticket nel tuo CRM.
  • Avviare un'automazione no-code con i dati della chiamata.
  • Tenere un tuo archivio delle chiamate.
In questa pagina