> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # 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](/docs/it/eleven-agents/whatsapp/interactive-messages) * Chiamate: in entrata e [in uscita](/docs/it/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call) Gli agenti su altri canali possono anche inviare messaggi WhatsApp tramite gli [strumenti WhatsApp](/docs/it/eleven-agents/whatsapp/tools). Non conosci ancora WhatsApp su ElevenLabs? Segui la [guida introduttiva](/docs/it/eleven-agents/whatsapp/getting-started). ## Importare un account WhatsApp Business #### Importa il tuo account Vai alla [pagina WhatsApp](https://elevenlabs.io/app/agents/whatsapp) e fai clic sul pulsante ***Importa account***: ![Pagina WhatsApp](/docs/_fern-img/734d6e0c2af1c50b769700e084368bed2a8c7eccf47aece6cfb6fc5ca7623f44.webp) #### Autorizza ElevenLabs Si aprirà il flusso di autorizzazione, in cui potrai selezionare il tuo account e dare a ElevenLabs l'autorizzazione per gestirlo: ![Flusso di autorizzazione WhatsApp](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp) #### Assegna un agente Al termine dell'importazione del tuo account, verrai portato alla relativa pagina delle impostazioni, dove potrai assegnargli un agente: ![Pagina dell'account WhatsApp](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp) > **Info** > > 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. #### Configura WhatsApp Manager Vai a [WhatsApp Manager](https://business.facebook.com/latest/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***](/docs/it/eleven-agents/customization/tools/system-tools/end-call), scade la configurata **\_Durata massima della conversazione \_** oppure scade il timeout di inattività predefinito dopo la risposta più recente dell'agente. > **Info** > > Le conversazioni WhatsApp tramite messaggi hanno un timeout di inattività predefinito di 15 minuti, calcolato dalla > risposta più recente dell'agente. Scopri di più sui [timeout delle conversazioni](/docs/it/eleven-agents/customization/conversation-flow#maximum-conversation-duration). ### In entrata Puoi inviare un messaggio al tuo account WhatsApp Business e l'agente risponderà: ![Conversazione di testo WhatsApp](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp) 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](/docs/it/eleven-agents/whatsapp/interactive-messages) arrivano con l'opzione selezionata. > **Note** > > L'agente risponde singolarmente a ogni messaggio in arrivo. I messaggi consecutivi inviati rapidamente non vengono > raggruppati in un'unica risposta. ### 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](/docs/it/eleven-agents/whatsapp/outbound) 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 ![Conversazione audio WhatsApp](/docs/_fern-img/372158bc0f86d62b6742f2bb44a741e5299ee7b95e36e38c3df1f9c06cffe2a0.webp)![Conversazione con immagini WhatsApp](/docs/_fern-img/cbfbadb9d0a20f35537ce3bd137eb12b1005a862a7e1cf0155d271502fb713da.webp)![Conversazione con documenti WhatsApp](/docs/_fern-img/2b91d4077ac19a56dda9c5c016a47ed7d574ba2cb77ac89eb8785925bc89fa13.webp)![Conversazione con posizione WhatsApp](/docs/_fern-img/bcd0d8f7df69d6c381be5be7c7a91ec7752b2b1894a80539823b7d9266beb3dd.webp)![Conversazione con contatti WhatsApp](/docs/_fern-img/75e56544700c87817a7f842943301a95e9e0b1fb84fc87e19139adb77f49ea5a.webp) ## 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](/docs/it/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call) per il flusso, gli esempi di codice e le chiamate in batch. ## Personalizzazione Impostiamo le [variabili dinamiche](/docs/it/eleven-agents/customization/personalization/dynamic-variables) `{{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](/docs/it/eleven-agents/customization/personalization#conversation-initiation-webhooks) per recuperare informazioni sul tuo utente nella conversazione. > **Info** > > Puoi trovare l'ID del tuo numero di telefono WhatsApp andando alla [pagina WhatsApp](https://elevenlabs.io/app/agents/whatsapp), facendo clic sul menu accanto al tuo account e > selezionando ***Copia ID numero di telefono***. ### Contesto di inizializzazione Se il tuo agente utilizza [variabili dinamiche](/docs/it/eleven-agents/customization/personalization/dynamic-variables) 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](/docs/it/eleven-agents/customization/personalization#conversation-initiation-webhooks): 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. > **Warning** > > I valori inseriti in **Variabili dinamiche** nell'editor dell'agente sono segnaposto di test per > visualizzare l'anteprima dell'agente. Non vengono utilizzati in produzione e non fungono da valori predefiniti per le conversazioni > in entrata. Le **conversazioni in uscita** ricevono i propri valori dal campo `conversation_initiation_client_data.dynamic_variables` della [richiesta di messaggio o chiamata in uscita](/docs/it/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments). 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](/docs/it/eleven-agents/whatsapp/troubleshooting#the-agent-doesnt-respond-to-inbound-messages) nella guida alla risoluzione dei problemi. > **Note** > > Il valore `system__called_number` è l'**ID del numero di telefono** WhatsApp, non il numero di telefono > stesso. Anche gli identificatori utente WhatsApp stanno passando agli [ID utente con ambito aziendale (BSUID)](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids); > ElevenAgents supporta i BSUID, quindi le conversazioni funzionano anche quando Meta fornisce un ID anziché il > numero di telefono dell'utente. ## 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations); le configurazioni solo vocali potrebbero già essere possibili tramite SIP (consulta le [FAQ](/docs/it/eleven-agents/whatsapp/troubleshooting#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](/docs/it/eleven-agents/whatsapp/troubleshooting#faq)). * **Passaggio a un operatore umano**: in arrivo (consulta le [FAQ](/docs/it/eleven-agents/whatsapp/troubleshooting#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](/docs/it/eleven-agents/whatsapp/troubleshooting).