Sviluppatori

Tutto ciò che fa il pannello può farlo anche il vostro codice

Un’API pubblica con autenticazione a chiave, webhook firmati alla fine della chiamata, scrittura dell’attività nel CRM e un server MCP che consente di costruire l’intero spazio di lavoro da Claude o ChatGPT.

In breve

Esiste un’API per l’agente telefonico?

Sì. Esiste un’API REST pubblica autenticata con una chiave inviata nell’header Authorization, e permette di mettere in coda una chiamata in uscita, leggere conversazioni e trascrizioni e gestire agenti, flussi di chiamata e base di conoscenza. Quando una chiamata termina, un webhook firmato con HMAC viene recapitato a un endpoint che configurate voi, così non dovete mai fare polling. Se lavorate con Salesforce o HubSpot, il sistema può riportare la chiamata come attività completata collegata al lead o al contatto. Tutto questo è esposto anche tramite un server MCP remoto, che consente a un client LLM di costruire e gestire lo spazio di lavoro senza che scriviate una riga di codice. Il riferimento completo, campo per campo e rotta per rotta, si trova nella documentazione OpenAPI collegata da questa pagina.

Il riferimento vivo

Il riferimento è generato dal codice stesso, quindi corrisponde sempre a ciò che è realmente in esecuzione. Una rotta, un campo o un codice di errore che vedete lì è ciò che il server restituisce.

Apri il riferimento dell’API

https://api.phone.daber.ai/v1/docs

L’API REST pubblica

Autenticazione a chiave su ogni richiesta, snake_case sul filo e scope per rotta: ogni chiave porta un insieme definito di scope, e una chiave priva dello scope corretto semplicemente non ottiene la rotta. Una chiave viene mostrata una sola volta, alla creazione; dalla nostra parte si conserva solo il suo hash.

Mettere in coda una chiamata in uscita, facoltativamente collegata a una campagna perché l’esito confluisca nei suoi KPI
Leggere le conversazioni: metadati, trascrizione, riassunto, sentiment e il motivo del passaggio a un operatore
Gestire agenti e flussi di chiamata, inclusa la generazione di un flusso da un documento di copione esistente
Scrivere nella base di conoscenza — le voci create via API entrano come bozze, ed è l’approvazione nel pannello a renderle recuperabili
Ogni modifica di agente o flusso viene versionata, anche quando arriva dall’API — e si può tornare indietro

Mettere in coda una chiamata in uscita

La richiesta minima: un id di agente e un numero da chiamare. La chiamata entra in coda e percorre lo stesso percorso di composizione usato dalle campagne, così non esiste un secondo percorso di codice che si comporta diversamente.

curl -X POST https://api.phone.daber.ai/v1/calls \
  -H "Authorization: Bearer dbr_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "3f9c1a52-7b41-4f0e-9c8d-2a5b6e7d8f10",
    "phone": "+972501234567"
  }'

La risposta restituisce l’id della richiesta di chiamata. L’esito — risposta o mancata risposta, che cosa è stato detto e che cosa è stato riassunto — arriva sul webhook di completamento, non nella risposta a questa richiesta.

Webhook al completamento

Invece di interrogare l’API finché la chiamata non finisce, registrate un endpoint e l’evento arriva a voi. Ogni richiesta porta una firma HMAC-SHA256 su marca temporale e corpo del messaggio — verificarla dalla vostra parte è la differenza tra un endpoint e un endpoint che chiunque può alimentare.

Eventi del ciclo di vita di una chiamata richiesta tramite API: messa in coda, completata, fallita
Un evento di conversazione completata per ogni conversazione vocale conclusa, non solo per quelle richieste tramite API
La firma viaggia in un header dedicato e include una marca temporale, così potete rifiutare un vecchio reinvio
Il segreto può essere rivelato e ruotato dalle impostazioni, e un registro di consegna conserva i tentativi recenti per ogni endpoint

Dove va una chiamata una volta conclusa

Una chiamata conclusa è un record in almeno due sistemi: il nostro e il vostro. Due modi per colmare quel divario senza scrivere a mano una sincronizzazione.

Scrittura dell’attività nel CRM

Se la chiamata non è nel CRM, per il commerciale non è avvenuta. Al termine, il sistema può creare un’attività completata in Salesforce o HubSpot, collegata al lead o al contatto giusto e assegnata al suo titolare, con il riassunto e l’esito. Un errore di scrittura nel CRM non fa mai fallire la chiamata in sé — viene registrato e segnalato, e la conversazione resta integra dalla nostra parte.

Server MCP remoto

La stessa API, esposta come server MCP — così potete collegare lo spazio di lavoro a un client LLM come Claude o ChatGPT e costruirlo conversando: trasformare un documento di copione in un flusso di chiamata, creare un agente, collegargli flusso e modelli, aggiungere voci alla base di conoscenza ed effettuare una chiamata di prova. L’autenticazione usa la stessa chiave API e gli strumenti esposti al client sono solo quelli consentiti dagli scope di quella chiave: un client LLM non ottiene mai più di quanto ottenga la chiave che ha in mano.

Prima di andare in produzione

Una chiave attiva è un segreto come un altro: viene mostrata una sola volta e non viene mai inviata da un browser
Esiste un limite di frequenza per chiave, e un’ondata di chiamate rilevata può sospendere automaticamente una chiave — la sospensione è reversibile dalle impostazioni
Verificare la firma del webhook dalla vostra parte è obbligatorio, non facoltativo
Riassunto e sentiment vengono scritti dopo la fine della chiamata e non al momento della chiusura — per questo arrivano sul webhook e non nella risposta alla richiesta di composizione

Chiamate subito l’agente IA

Una telefonata vera, non una registrazione. Esattamente ciò che sentirebbe chi vi chiama.

Fatevi richiamare dall’agente IA

Lasciate un numero — l’agente vi richiama in meno di un minuto.