🇮🇹 IT

📞 Chiamata Telefonica

Effettua una chiamata telefonica in uscita tramite Twilio. Supporta tre modalità: pronunciare un messaggio, ascoltare una risposta vocale, o eseguire un questionario al telefono.

Categoria: Comunicazione · Identificatore tipo: phone_call

Panoramica

Il nodo Chiamata Telefonica compone una chiamata in uscita tramite Twilio e gestisce la conversazione secondo una delle tre modalità disponibili. Ogni modalità è adatta a un diverso schema di interazione:

Speak — il nodo consegna un messaggio text-to-speech al destinatario. È possibile attendere facoltativamente la pressione di un tasto DTMF (cifre premute sul tastierino) per raccogliere una semplice conferma o selezione di menu prima di riagganciare.
Listen — il nodo pronuncia un messaggio e poi registra e trascrive la risposta verbale del destinatario. La trascrizione viene restituita come output per l'utilizzo nei passaggi successivi.
Questionnaire — il nodo esegue un flusso di questionario Flusso esistente durante la telefonata. Le domande vengono pronunciate in sequenza e le risposte del destinatario (DTMF o voce) vengono raccolte e restituite come output strutturato.

Prerequisito: Un account Twilio deve essere collegato in Impostazioni → Twilio prima che questo nodo possa effettuare chiamate. Il numero di telefono Twilio deve avere le funzionalità vocali abilitate e deve essere verificato per le chiamate in uscita verso il paese di destinazione.

Configurazione

Campo	Stato	Descrizione
Mode	Obbligatorio	`speak` — consegna un messaggio TTS, raccogliendo facoltativamente un tasto DTMF. `listen` — pronuncia un messaggio poi registra e trascrive la risposta del destinatario. `questionnaire` — esegue un flusso di questionario Flusso durante la chiamata.
To Number	Obbligatorio	Il numero di telefono in formato E.164 da chiamare, ad es. `+12025551234`. Supporta riferimenti `{{ variable }}`.
Message	Obbligatorio per speak / listen	Il testo da pronunciare al destinatario quando la chiamata viene risposta. Supporta riferimenti `{{ variable }}`. Non utilizzato nella modalità questionnaire.
Voice	Opzionale	La voce da usare per il text-to-speech. Seleziona una voce ElevenLabs configurata in Impostazioni, o lascia vuoto per usare la voce TTS predefinita di Twilio.
DTMF Enabled	Opzionale	Quando abilitato nella modalità `speak`, la chiamata attende che il destinatario prema delle cifre sul tastierino dopo la consegna del messaggio. Predefinito: disabilitato.
DTMF Timeout	Opzionale	Quanto tempo attendere la pressione di un tasto dopo la fine del messaggio, in secondi. Se nessun tasto viene premuto entro questo tempo, la chiamata termina. Predefinito: 5 secondi.
Max Digits	Opzionale	Il numero massimo di cifre da raccogliere in modalità DTMF. La raccolta si interrompe non appena vengono ricevute queste cifre o viene raggiunto il timeout. Predefinito: 1.
Record Max Length	Opzionale	Durata massima della registrazione in secondi per la modalità `listen`. La registrazione si interrompe automaticamente quando il destinatario smette di parlare o viene raggiunto questo limite. Predefinito: 30 secondi.
Transcribe	Opzionale	Quando abilitato nella modalità `listen`, l'audio registrato viene trascritto automaticamente in testo e restituito in `output.transcript`. Predefinito: abilitato.
Questionnaire ID	Obbligatorio per la modalità questionnaire	L'ID del questionario Flusso da eseguire durante la telefonata. Il questionario deve essere pubblicato e configurato per la consegna telefonica.

Dati di Output

I campi di output dipendono dalla modalità selezionata e dall'esito della chiamata.

Campo	Tipo	Descrizione
`status`	string	Stato finale della chiamata. Uno tra: `completed`, `no_answer`, `busy`, `refused`, `failed`, `timeout`.
`duration`	number	Durata della chiamata in secondi dalla risposta al riagganciamento. `0` se la chiamata non è stata risposta.
`transcript`	string	Trascrizione testuale della risposta vocale del destinatario. Presente nella modalità `listen` quando Transcribe è abilitato.
`recording_url`	string	URL del file audio registrato. Presente nella modalità `listen`.
`ended_by`	string	Chi ha terminato la chiamata: `caller` (Flusso), `recipient`, o `timeout`.
`dtmf`	string	La(e) cifra(e) premuta(e) dal destinatario. Presente nella modalità `speak` quando DTMF è abilitato.
`response_text`	string	Alias di `transcript` nella modalità `listen`. Fornito per comodità nelle espressioni template.
`questionnaire_answers`	object	Mappa chiave-valore degli ID delle domande con le risposte del destinatario. Presente nella modalità `questionnaire`.
`call_outcome`	string	Un'etichetta di esito strutturata impostata dal flusso del questionario o da un Logic Gate a valle, ad es. `confirmed`, `declined`.

// Riferisci gli output della chiamata nei passaggi successivi {{ call_step.output.status }} {{ call_step.output.duration }} {{ call_step.output.transcript }} {{ call_step.output.dtmf }} {{ call_step.output.questionnaire_answers.q1 }}

Esempi di Utilizzo

Promemoria appuntamento semplice (speak)

Un Schedule Trigger si attiva un'ora prima di ogni appuntamento recuperato da un'integrazione calendario.
Un nodo Chiamata Telefonica in modalità speak chiama il paziente. Il campo Message recita: "Salve {{ appointment.output.patient_name }}, questo è un promemoria che il suo appuntamento è alle {{ appointment.output.time }}. A presto."
Un Logic Gate controlla call_step.output.status. Se no_answer, viene inviato un SMS di follow-up tramite un nodo HTTP Request.

Raccolta conferma con DTMF

Un nodo Chiamata Telefonica in modalità speak con DTMF Enabled consegna: "Premi 1 per confermare la consegna, o premi 2 per riprogrammare." Max Digits è impostato a 1.
Un nodo Switch instrada su call_step.output.dtmf: valore 1 → ramo conferma, valore 2 → ramo riprogrammazione.

Registrazione feedback cliente (listen)

Un nodo Chiamata Telefonica in modalità listen consegna: "Lasci un breve messaggio descrivendo la sua esperienza." Record Max Length è impostato a 60 secondi e Transcribe è abilitato.
Un nodo Agent riceve {{ call_step.output.transcript }} e classifica il sentiment, scrivendo il risultato in un Google Sheet.

Esecuzione di un sondaggio (questionnaire)

Un questionario pre-costruito viene creato in Questionnaires con diverse domande per un sondaggio NPS post-servizio.
Un nodo Chiamata Telefonica in modalità questionnaire viene configurato con l'ID del questionario e il numero di telefono del cliente.
Dopo la chiamata, questionnaire_answers e call_outcome vengono passati a un nodo Transform per modellare i dati prima di scriverli in un CRM tramite HTTP Request.

Suggerimenti e Note

I numeri di telefono devono essere in formato E.164 (+ seguito dal prefisso internazionale e dal numero). Usa un nodo Transform per normalizzare i numeri che arrivano in altri formati.
Testa le chiamate con un numero di test Twilio verificato prima di abilitare in produzione per evitare addebiti.
Nella modalità listen, la precisione della trascrizione dipende dalla qualità audio della chiamata. Rumori di fondo o segnale debole possono ridurre la precisione. Considera di invitare il destinatario a parlare chiaramente nel messaggio.
La raccolta DTMF termina non appena viene raggiunto Max Digits — impostalo a 1 per semplici prompt sì/no o di menu per evitare di attendere il timeout.
Il campo call_outcome viene popolato solo quando il flusso del questionario o un passaggio a valle lo imposta esplicitamente. È null per le chiamate speak e listen di base.

Nodi Correlati

Chiamata Telefonica AI — conversazione telefonica AI in forma libera tramite un nodo Agent.
SMS — invia un messaggio di testo invece di effettuare una chiamata vocale.
Switch — instrada il workflow in base all'input DTMF o allo stato della chiamata.
Logic Gate — dirama in base al fatto che la chiamata sia stata risposta o completata con successo.