Telefonate automatiche API: chiamate AI da CRM e form
Scopri come collegare le telefonate automatiche API a CRM, form web ed e-commerce per avviare chiamate vocali AI e registrare gli esiti in modo trasparente.
## Telefonate automatiche API: come funzionano dal sito e dal CRM
Le **telefonate automatiche API** collegano i tuoi sistemi aziendali a un agente vocale basato su intelligenza artificiale per far partire chiamate telefoniche al verificarsi di un evento digitale. L'agente conduce una conversazione a due vie gestita da un modello linguistico con voce naturale.
Questo meccanismo risponde a diversi casi d'uso:
* Contattare un nuovo contatto appena compila un modulo sul sito web;
* Lanciare una campagna su una lista di anagrafiche;
* Telefonare quando un contatto cambia stato o fase dentro la pipeline del CRM;
* Confermare la presenza prima di un appuntamento o di un evento registrato a calendario;
* Ricevere chiamate in ingresso per qualificare la richiesta e aprire ticket operativi.
Al termine di ogni contatto, il sistema restituisce al tuo software l'esito della conversazione, la trascrizione completa, la disponibilità di data e ora concordata o i dati del ticket aperto.
## Quali eventi possono far partire una chiamata automatica
L'avvio di una conversazione dipende da un trigger generato dal tuo stack software. DeepAgent riceve il payload dell'evento tramite endpoint o connettore e assegna la chiamata all'agente vocale configurato per quello specifico scopo.
| Evento scatenante | Sistema sorgente | Azione dell'agente vocale | Caso reale |
| :--- | :--- | :--- | :--- |
| Invio di un form web | Sito web o landing page | Chiama il contatto per qualificare l'interesse e fissare una consulenza | Flor de Pacifico |
| Nuovo contatto in un funnel multicanale | CRM o software di automazione | Invia prima un messaggio WhatsApp (tramite integrazione) e prosegue al telefono | Bludental |
| Iscrizione a un evento | Modulo di registrazione / calendario eventi | Telefona per confermare la partecipazione e chiarire dettagli pratici | Lunaga |
| Mancata consegna di una spedizione | Gestionale ordini o logistica | Telefona al destinatario per raccogliere istruzioni di svincolo o reso | Operatore logistico integrato |
| Importazione di contatti qualificati | Database aziendale / HubSpot | Chiama lotti di lead per verificare la corrispondenza con l'offerta | Azienda manifatturiera italiana |
| Chiamata telefonica in ingresso | Centralino o linea telefonica aziendale | Esegue il triage tecnico e apre una segnalazione nel CRM | Azienda di trattamento acque |
Nel caso di Flor de Pacifico, operatore negli investimenti immobiliari internazionali, la chiamata parte pochi secondi dopo l'invio del form web. In un test di 5,5 giorni sono state gestite 207 chiamate, con 76 risposte e 18 appuntamenti qualificati, registrando una conversione del 25% su chi ha risposto nella fascia oraria 08:00-21:00. Questo flusso sfrutta la velocità di risposta, un aspetto approfondito nella guida su come richiamare subito i lead.
Per la catena di cliniche dentali Bludental, con oltre 70 sedi, il trigger invia un messaggio su WhatsApp (tramite apposita integrazione) entro 5 secondi e fa partire la telefonata dopo circa 1 minuto usando le informazioni già raccolte, con un confronto tra conversione dell'agente AI e del personale umano del 28% contro il 22% su 10.000 lead mensili totali. Questa architettura multicanale è illustrata nell'articolo dedicato alla qualifica lead tra voce e WhatsApp.
Nel settore eventi, Lunaga ha collegato l'agente al form di registrazione e al calendario eventi, registrando gli esiti su Google Sheet: su 10.133 chiamate in 18 giorni ha ottenuto 770 presenze confermate all'evento online.
Per un operatore logistico integrato italiano, la gestione dei pacchi in giacenza è stata affidata all'agente vocale GIULIA, attivato via API dai ticket di fallita consegna: su 18.364 chiamate outbound in 20 settimane, il sistema ha totalizzato 1.549 esiti positivi per svincolo o rientro merci.
L'azienda manifatturiera italiana ha invece impostato il lancio di lead inbound in blocchi da 500 contatti verso HubSpot, lavorando 2.000 lead con un calo del tempo di gestione manuale superiore al 70%. Per l'azienda di trattamento acque, l'agente SARA ha gestito 2.260 chiamate inbound in un mese aprendo 1.730 ticket con obiettivo raggiunto direttamente nel CRM via API.
## Chiamate automatiche da CRM via API o caricamento da file
La scelta tra un'**integrazione telefonate automatiche** sincrona e il caricamento di file dipende dalla natura dell'evento sorgente.
| Metodo di avvio | Quando si usa | Velocità di esecuzione | Impegno tecnico | Contesto tipico |
| :--- | :--- | :--- | :--- | :--- |
| **Integrazione API / Webhook** | Eventi singoli e puntuali | Immediata o programmata al minuto | Richiede configurazione di endpoint o regole CRM | Form sul sito, carrelli abbandonati, ticket di supporto, cambi di stato CRM |
| **Caricamento lista (CSV / XLSX)** | Campagne periodiche, riattivazione o database storici | Batch avviato dall'operatore | Nessun codice: caricamento manuale da dashboard | Liste fiere, database dormienti, conferme massive per eventi |
Se devi contattare un utente che ha chiesto informazioni pochi istanti fa, **avviare chiamate AI dal sito** tramite API ti permette di chiamare subito. Quando gestisci campagne su elenchi B2B pregressi, puoi caricare il file direttamente sulla piattaforma, selezionare l'agente e avviare i contatti senza scrivere codice. Prima di valutare campagne su elenchi a freddo, consulta l'approfondimento sulle chiamate commerciali a freddo su liste B2B.
## Quali dati servono per eseguire la telefonata
L'agente vocale richiede alcuni campi minimi per comporre il numero, rispettare le regole di contatto e contestualizzare il dialogo. Tra i dati inviati rientrano solitamente il recapito con prefisso internazionale, i riferimenti anagrafici del contatto, l'attestazione del consenso raccolto, la causale della chiamata, eventuali variabili di contesto (come prodotto o servizio richiesto), la lingua dell'agente e l'identificativo del record nel CRM.
Questo blocco mostra una struttura illustrativa di esempio concettuale per raggruppare i dati prima dell'invio (non costituisce la specifica tecnica dell'API di DeepAgent, non include percorsi o parametri di produzione):
```json
{
"external_id": "",
"contact": {
"first_name": "",
"last_name": "",
"phone_number": ""
},
"context": {
"campaign": "",
"service_interest": "",
"preferred_slot": ""
},
"compliance": {
"consent_confirmed": true,
"consent_source": ""
}
}
```
## Gestione dei tentativi, fasce orarie e regole di arresto
La configurazione della campagna stabilisce la gestione degli esiti quando l'interlocutore risulta occupato, non risponde o chiude la chiamata. Le finestre orarie e il numero di tentativi derivano dalle esigenze operative di ciascun contesto reale.
Nel caso studio di Bludental, i tentativi di contatto sono stati calendarizzati con una sequenza a intervalli di +0h, +6h, +12h e +18h, escludendo chiamate dopo le 19:00. Per l'operatore logistico italiano, l'agente vocale GIULIA è stato impostato 7 giorni su 7 nella fascia 08:00-18:00, con un massimo di 6 tentativi giornalieri per raggiungere i destinatari delle giacenze (il 64,2% dei contatti ha risposto al primo tentativo, mentre il 35,8% ha risposto ai tentativi successivi). L'azienda manifatturiera ha invece impostato fino a 5 tentativi per contatto all'interno di una finestra compresa tra le 08:30 e le 17:30, dal lunedì al venerdì.
Per esaminare i criteri di pianificazione dei richiami, puoi leggere l'analisi su quante volte richiamare un lead non raggiungibile.
Le regole di arresto interrompono la sequenza in casi definiti:
* L'interlocutore richiede esplicitamente di non essere più contattato (opt-out);
* Il numero risulta inesistente o non valido;
* L'obiettivo della chiamata viene raggiunto con successo al primo contatto.
## Cosa restituisce il webhook dell'agente vocale ai sistemi
Al termine di ogni chiamata, il server trasmette un evento al webhook configurato nel tuo applicativo. I sistemi esterni ricevono i dati strutturati per aggiornare la scheda cliente.
Tra gli esiti tipici restituiti rientrano il completamento della conversazione con obiettivo raggiunto (come un appuntamento fissato o un interesse confermato), la richiesta di richiamata, il mancato interesse, la mancata risposta, il numero non valido o la richiesta di non essere ricontattati.
Insieme all'esito, il payload trasmette la trascrizione integrale del dialogo, una sintesi generata dall'AI, l'orario registrato per un eventuale appuntamento e l'identificativo del ticket. L'azienda manifatturiera ha registrato il 100% degli esiti delle conversazioni dentro HubSpot in modo automatico. Per i dettagli architetturali, consulta la guida sull'integrazione tra voice agent e HubSpot o Salesforce e il tutorial operativo su come connettere DeepAgent al funnel di HubSpot.
Per analizzare metriche aggregate, tassi di risposta e tenore dei dialoghi, trovi indicazioni specifiche nell'articolo sull'analisi delle chiamate AI e delle trascrizioni.
## Controlli operativi prima della messa in produzione
Prima di attivare le chiamate automatiche API su volumi consistenti, verifica questi passaggi per tutelare l'infrastruttura e rispettare i requisiti normativi:
1. **Verifica del consenso esplicito**: accertati che ogni lead inviato tramite API contenga la traccia del consenso a ricevere chiamate, requisito indispensabile per usare la piattaforma self-service;
2. **Controllo delle duplicazioni**: predisponi un filtro a monte per evitare che aggiornamenti ripetuti sul CRM inoltrino richieste multiple per lo stesso numero nella stessa giornata;
3. **Formattazione del numero telefonico**: valida i numeri prima dell'invio controllando la presenza del prefisso del paese di destinazione;
4. **Test su numeri interni**: effettua chiamate verso numerazioni interne per verificare le risposte dell'agente, la gestione delle interruzioni e la pronuncia della terminologia tecnica;
5. **Gestione degli errori HTTP del webhook**: configura log e tentativi di reinvio sul tuo server se il CRM dovesse risultare momentaneamente non raggiungibile;
6. **Pianificazione del trasferimento di chiamata**: se l'agente prevede il passaggio a un operatore umano per lead qualificati, verifica la presenza di personale disponibile sul centralino negli orari di campagna;
7. **Informativa sulla natura dell'AI**: assicurati che la frase iniziale dell'agente dichiari l'interazione con un sistema di intelligenza artificiale, in conformità con l'Articolo 50 dell'EU AI Act;
8. **Verifica legale e registri delle opposizioni**: verifica gli orari di chiamata e la base giuridica con il tuo DPO o consulente legale, come illustrato nell'approfondimento sul GDPR per agenti vocali AI e nella guida sui limiti e opportunità delle chiamate commerciali automatiche.
## Piani e costi di DeepAgent
I piani di DeepAgent sono disponibili in abbonamento mensile oppure annuale, con un risparmio del 17% per la fatturazione annuale. Tutti i prezzi indicati escludono l'IVA:
* **Starter**: 99 € al mese;
* **Pro**: 299 € al mese;
* **Growth**: 500 € al mese;
* **Scale**: 799 € al mese;
* **Enterprise**: preventivo personalizzato su richiesta.
Puoi testare le funzioni della piattaforma con la prova self-serve di 30 minuti gratis, senza carta. Consulta tutti i dettagli aggiornati sulla pagina dei prezzi di DeepAgent.
## Domande frequenti sulle telefonate automatiche API
### Posso avviare una chiamata telefonica AI direttamente dal mio CRM?
Sì, se il tuo CRM supporta webhook in uscita o chiamate HTTP verso API esterne. Puoi configurare un workflow che invia i dati del contatto a DeepAgent quando il contatto entra in una lista specifica o cambia fase nella pipeline.
### Come si collegano i contatti di un form web a un agente vocale?
All'invio del form, il tuo server o il sistema di gestione dei lead invia una richiesta POST tramite webhook all'endpoint dell'agente. Il payload include numero di telefono, nome ed eventuali risposte al modulo per contestualizzare la chiamata.
### L'esito della chiamata e la trascrizione possono rientrare nel CRM in modo automatico?
Sì, al termine della conversazione l'agente vocale genera un webhook di ritorno verso il tuo CRM con esito, sintesi, trascrizione completa e parametri raccolti, aggiornando la scheda contatto.
### Posso caricare un file invece di configurare una chiamata API?
Sì, sulla piattaforma puoi caricare direttamente una lista di contatti in formato foglio di calcolo, selezionare l'agente vocale configurato e avviare la campagna outbound senza scrivere codice.
### Serve un programmatore per usare le API delle telefonate automatiche?
Per l'integrazione via API o webhook serve configurare la chiamata tecnica dal tuo sistema, operazione comune per sviluppatori o amministratori CRM. Per lanciare campagne tramite caricamento di liste, non è richiesta alcuna competenza tecnica.
## Integrare le telefonate vocali AI nei tuoi applicativi
Collegare i flussi software a un agente telefonico permette di gestire tempestivamente ogni contatto e registrare in modo ordinato gli esiti operativi.
Parla con sales → · Crea il tuo agente →