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://server.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://server.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, in ebraico. Esattamente ciò che sentirebbe chi vi chiama.

Fatevi richiamare dall’agente IA

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