WhatsApp

Panoramica

Puoi collegare il tuo account WhatsApp Business a un agente ElevenLabs. L’agente potrà quindi gestire:

• Conversazioni tramite messaggi: testo, note vocali, contenuti multimediali e messaggi interattivi
• Chiamate: in entrata e in uscita

Gli agenti su altri canali possono anche inviare messaggi WhatsApp tramite gli strumenti WhatsApp.

Non conosci ancora WhatsApp su ElevenLabs? Segui la guida introduttiva.

Importare un account WhatsApp Business

1

Importa il tuo account

Vai alla pagina WhatsApp e fai clic sul pulsante Importa account:

2

Autorizza ElevenLabs

Si aprirà il flusso di autorizzazione, in cui potrai selezionare il tuo account e dare a ElevenLabs l’autorizzazione per gestirlo:

3

Assegna un agente

Al termine dell’importazione del tuo account, verrai portato alla relativa pagina delle impostazioni, dove potrai assegnargli un agente:

Se non assegni un agente al tuo account, i messaggi in entrata verranno ignorati e le chiamate in entrata verranno rifiutate. Potrai comunque effettuare chiamate in uscita.

4

Configura WhatsApp Manager

Vai a WhatsApp Manager per:

• Configurare l’immagine del profilo e altro: apri la pagina Numeri di telefono, seleziona un numero di telefono e vai alla scheda Profilo
• Consentire le chiamate vocali: apri la pagina Numeri di telefono, seleziona un numero di telefono e vai alla scheda Impostazioni chiamate
• Se vuoi effettuare chiamate in uscita, aggiungere un metodo di pagamento: apri la pagina Panoramica e fai clic sul pulsante Aggiungi metodo di pagamento

Impostazioni dell’account

Ogni numero importato dispone di impostazioni che controllano il comportamento dell’agente:

• Abilita messaggistica: indica se l’agente risponde ai messaggi. Disattivala per lasciare che ElevenLabs gestisca soltanto le chiamate, mentre la tua applicazione gestisce i messaggi.
• Abilita risposta ai messaggi audio: quando è attiva, impostazione predefinita, l’agente risponde alle note vocali con note vocali; quando è disattiva, risponde sempre con testo.
• Abilita indicatore di digitazione: quando è attivo, impostazione predefinita, l’agente contrassegna i messaggi in arrivo come letti e mostra un indicatore di digitazione mentre compone la risposta.

Conversazioni tramite messaggi

Le conversazioni WhatsApp tramite messaggi terminano quando l’agente usa lo strumento di sistema Termina conversazione, scade la configurata _Durata massima della conversazione _ oppure scade il timeout di inattività predefinito dopo la risposta più recente dell’agente.

In entrata

Puoi inviare un messaggio al tuo account WhatsApp Business e l’agente risponderà:

Alla scadenza di uno dei due timeout, ElevenAgents invia il configurato _Messaggio di durata massima della conversazione _ prima di chiudere la conversazione. Se il messaggio è vuoto, la conversazione viene chiusa senza un saluto finale.

L’agente comprende più del semplice testo:

• Risposte citate: quando l’utente tiene premuto un messaggio e vi risponde, l’agente sa a quale messaggio sta rispondendo.
• Reazioni: le reazioni emoji ai messaggi dell’agente vengono inoltrate all’agente.
• Tocchi sui pulsanti dei template: quando l’utente tocca un pulsante di risposta rapida in un template, l’agente vede quale pulsante è stato scelto.
• Risposte interattive: i tocchi su pulsanti e liste interattivi arrivano con l’opzione selezionata.

In uscita

Puoi avviare una conversazione inviando un template di messaggio approvato da Meta, dalla dashboard o dall’API, e programmare chiamate in uscita con una richiesta di autorizzazione alla chiamata. Consulta Messaggi e template in uscita per la creazione dei template, esempi di codice, regole sul formato dei destinatari e campagne in batch.

Tipi di messaggio

Oltre al testo, puoi anche inviare:

• audio
  • Le note vocali in entrata vengono trascritte in testo prima di essere inoltrate all’agente.
  • Per impostazione predefinita, l’agente risponde alle note vocali con note vocali, generate con la voce configurata per l’agente: qualsiasi voce, qualsiasi lingua. Disattiva Abilita risposta ai messaggi audio nelle impostazioni dell’account per rispondere sempre con testo. Se la generazione audio non riesce, l’agente passa a una risposta di testo.
  • I messaggi audio comportano costi aggiuntivi per speech-to-text e text-to-speech. I prezzi sono gli stessi delle API STT e TTS.
• immagine
• documento
• sticker
• posizione
• contatto

Chiamate

In entrata

Puoi chiamare il tuo account WhatsApp Business e l’agente risponderà. Durante la chiamata, puoi anche inviare messaggi di testo, che verranno integrati nella conversazione.

In uscita

Le chiamate in uscita richiedono l’autorizzazione dell’utente, richiesta tramite un template. Consulta programmare una chiamata in uscita per il flusso, gli esempi di codice e le chiamate in batch.

Personalizzazione

Impostiamo le variabili dinamiche {{system__caller_id}} e {{system__called_number}} rispettivamente sull’ID utente WhatsApp e sull’ID del tuo numero di telefono WhatsApp, o viceversa, a seconda di chi ha avviato la conversazione. Puoi usarle in uno strumento o in un webhook di avvio della conversazione per recuperare informazioni sul tuo utente nella conversazione.

Contesto di inizializzazione

Se il tuo agente utilizza variabili dinamiche oltre alle variabili di sistema sopra indicate, dovrai pianificare da dove provengono i relativi valori. Se il tuo agente non usa variabili dinamiche, questa sezione non è pertinente.

Le conversazioni in entrata iniziano senza variabili dinamiche fornite dall’utente. Il metodo supportato per fornire valori è un webhook di avvio della conversazione: quando un messaggio WhatsApp avvia una conversazione, ElevenAgents chiama il tuo endpoint con l’ID utente WhatsApp come caller_id e l’ID del tuo numero di telefono WhatsApp come called_number, quindi applica le variabili dinamiche restituite dalla tua risposta. Fai in modo che il webhook restituisca sempre tutte le variabili richieste dall’agente: un valore CRM quando disponibile, altrimenti una costante di fallback.

Le conversazioni in uscita ricevono i propri valori dal campo conversation_initiation_client_data.dynamic_variables della richiesta di messaggio o chiamata in uscita. Questi valori persistono per tutta la conversazione e sono ancora disponibili quando l’utente risponde. I parametri del template sono un campo separato e non popolano le variabili dinamiche.

Una variabile obbligatoria che rimane senza valore causerà l’errore della conversazione. Consulta variabili dinamiche mancanti nella guida alla risoluzione dei problemi.

Limitazioni

Al momento non sono supportati:

• WhatsApp Flows: non è possibile inviare moduli interattivi e le risposte ai Flow non vengono inoltrate all’agente.
• Messaggi video: i video in entrata non vengono inoltrati all’agente.
• Raggruppamento dei messaggi: l’agente risponde a ogni messaggio singolarmente anziché unire messaggi consecutivi inviati rapidamente.
• Numeri gestiti da un altro provider: un numero registrato con un altro provider WhatsApp o attivo nell’app WhatsApp Business non può essere importato. Stiamo collaborando con Meta per abilitare le Multi-Solution Conversations; le configurazioni solo vocali potrebbero già essere possibili tramite SIP (consulta le FAQ).
• WABA creati con un’app per sviluppatori: non possono essere importati tramite il flusso standard.
• Metadati di referral degli annunci: i dati di attribuzione degli annunci Click-to-WhatsApp non sono esposti all’agente (consulta le FAQ).
• Passaggio a un operatore umano: in arrivo (consulta le FAQ).

FAQ

Le domande più comuni — prezzi, configurazioni multi-provider, passaggio a un operatore umano, modalità Zero-Retention, OTP, conformità normativa — trovano risposta in Risoluzione dei problemi e FAQ.