> 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 ## Visão geral Você pode conectar sua conta comercial do WhatsApp a um Agente da ElevenLabs. O agente poderá então gerenciar: * Conversas por mensagem — texto, mensagens de voz, mídia e [mensagens interativas](/docs/pt/eleven-agents/whatsapp/interactive-messages) * Chamadas — recebidas e [realizadas](/docs/pt/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call) Agentes em outros canais também podem enviar mensagens pelo WhatsApp usando as [ferramentas do WhatsApp](/docs/pt/eleven-agents/whatsapp/tools). É novo no WhatsApp da ElevenLabs? Siga o [guia de introdução](/docs/pt/eleven-agents/whatsapp/getting-started). ## Importar uma conta comercial do WhatsApp #### Importe sua conta Acesse a [página do WhatsApp](https://elevenlabs.io/app/agents/whatsapp) e clique no botão ***Importar conta***: ![Página do WhatsApp](/docs/_fern-img/734d6e0c2af1c50b769700e084368bed2a8c7eccf47aece6cfb6fc5ca7623f44.webp) #### Autorize a ElevenLabs Isso abrirá o fluxo de autorização, no qual você selecionará sua conta e dará à ElevenLabs permissão para gerenciá-la: ![Fluxo de autorização do WhatsApp](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp) #### Atribua um agente Ao terminar de importar sua conta, você será direcionado à página de configurações, onde poderá atribuir um agente a ela: ![Página da conta do WhatsApp](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp) > **Info** > > Se você não atribuir um agente à sua conta, as mensagens recebidas serão ignoradas e as chamadas recebidas > serão recusadas. No entanto, você ainda poderá fazer chamadas realizadas. #### Configure o Gerenciador do WhatsApp Acesse o [Gerenciador do WhatsApp](https://business.facebook.com/latest/whatsapp_manager/) para: * Configurar sua foto de perfil etc.: abra a página ***Números de telefone***, selecione um número e acesse a aba ***Perfil*** * Permitir chamadas de voz: abra a página ***Números de telefone***, selecione um número e acesse a aba ***Configurações de chamada*** * Se quiser fazer chamadas realizadas, adicione uma forma de pagamento: abra a página ***Visão geral*** e clique no botão ***Adicionar forma de pagamento*** ## Configurações da conta Cada número importado tem configurações que controlam o comportamento do agente: * **Ativar mensagens** — define se o agente responde às mensagens. Desative para que a ElevenLabs gerencie apenas as chamadas, enquanto seu próprio aplicativo gerencia as mensagens. * **Ativar resposta a mensagens de áudio** — quando ativada (padrão), o agente responde a mensagens de voz com mensagens de voz; quando desativada, ele sempre responde com texto. * **Ativar indicador de digitação** — quando ativada (padrão), o agente marca as mensagens recebidas como lidas e exibe um indicador de digitação enquanto elabora a resposta. ## Conversas por mensagem As conversas por mensagem no WhatsApp terminam quando o agente usa a ferramenta de sistema [***Encerrar conversa***](/docs/pt/eleven-agents/customization/tools/system-tools/end-call), quando a **\_Duração máxima da conversa \_** configurada termina ou quando o tempo limite de inatividade padrão termina após a resposta mais recente do agente. > **Info** > > As conversas por mensagem no WhatsApp têm um tempo limite de inatividade padrão de 15 minutos, contado a partir da > resposta mais recente do agente. Saiba mais sobre os [tempos limite de conversa](/docs/pt/eleven-agents/customization/conversation-flow#maximum-conversation-duration). ### Recebidas Você pode enviar uma mensagem para sua conta comercial do WhatsApp, e o agente responderá: ![Conversa de texto no WhatsApp](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp) Quando qualquer um dos tempos limite expira, o ElevenAgents envia a **\_Mensagem de duração máxima da conversa \_** configurada antes de encerrar a conversa. Se a mensagem estiver vazia, a conversa será encerrada sem despedida. O agente entende mais do que texto simples: * **Respostas citadas** — quando o usuário mantém uma mensagem pressionada e responde a ela, o agente sabe a qual mensagem ele está respondendo. * **Reações** — reações com emoji às mensagens do agente são repassadas ao agente. * **Toques em botões de modelo** — quando o usuário toca em um botão de resposta rápida em um modelo, o agente vê qual botão foi escolhido. * **Respostas interativas** — toques em [botões e listas interativas](/docs/pt/eleven-agents/whatsapp/interactive-messages) chegam com a opção selecionada. > **Note** > > O agente responde a cada mensagem recebida individualmente. Mensagens consecutivas enviadas rapidamente não são > agrupadas em uma única resposta. ### Realizadas Você pode iniciar uma conversa enviando um modelo de mensagem aprovado pela Meta, pelo painel ou pela API, e agendar chamadas realizadas com uma solicitação de permissão de chamada. Consulte [Mensagens realizadas e modelos](/docs/pt/eleven-agents/whatsapp/outbound) para saber sobre a criação de modelos, exemplos de código, regras de formato de destinatários e campanhas em lote. ### Tipos de mensagem Além de texto, você também pode enviar: * áudio * Mensagens de voz recebidas são transcritas para texto antes de serem repassadas ao agente. * Por padrão, o agente responde a mensagens de voz com mensagens de voz, geradas na voz configurada do agente — qualquer voz, qualquer idioma. Desative ***Ativar resposta a mensagens de áudio*** nas configurações da conta para sempre responder com texto. Se a geração de áudio falhar, o agente usará uma resposta em texto. * Mensagens de áudio geram cobranças adicionais por conversão de fala em texto e texto em fala. Os preços são os mesmos das APIs de STT e TTS. * imagem * documento * figurinha * localização * contato ![Conversa de áudio no WhatsApp](/docs/_fern-img/372158bc0f86d62b6742f2bb44a741e5299ee7b95e36e38c3df1f9c06cffe2a0.webp)![Conversa com imagem no WhatsApp](/docs/_fern-img/cbfbadb9d0a20f35537ce3bd137eb12b1005a862a7e1cf0155d271502fb713da.webp)![Conversa com documento no WhatsApp](/docs/_fern-img/2b91d4077ac19a56dda9c5c016a47ed7d574ba2cb77ac89eb8785925bc89fa13.webp)![Conversa com localização no WhatsApp](/docs/_fern-img/bcd0d8f7df69d6c381be5be7c7a91ec7752b2b1894a80539823b7d9266beb3dd.webp)![Conversa com contatos no WhatsApp](/docs/_fern-img/75e56544700c87817a7f842943301a95e9e0b1fb84fc87e19139adb77f49ea5a.webp) ## Chamadas ### Recebidas Você pode ligar para sua conta comercial do WhatsApp, e o agente responderá. Durante a chamada, você também pode enviar mensagens de texto, que serão incorporadas à conversa. ### Realizadas Chamadas realizadas exigem a permissão do usuário, solicitada por meio de um modelo. Consulte [agendar uma chamada realizada](/docs/pt/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call) para ver o fluxo, exemplos de código e chamadas em lote. ## Personalização Definimos as [variáveis dinâmicas](/docs/pt/eleven-agents/customization/personalization/dynamic-variables) `{{system__caller_id}}` e `{{system__called_number}}` com o ID de usuário do WhatsApp e o ID do número de telefone do seu WhatsApp (ou o inverso, dependendo de quem iniciou a conversa). Você pode usá-las em uma ferramenta ou em um [webhook de início de conversa](/docs/pt/eleven-agents/customization/personalization#conversation-initiation-webhooks) para buscar informações sobre o usuário na conversa. > **Info** > > Você pode encontrar o ID do número de telefone do seu WhatsApp acessando a [página do WhatsApp](https://elevenlabs.io/app/agents/whatsapp), clicando no menu ao lado da sua conta e > selecionando ***Copiar ID do número de telefone***. ### Contexto de inicialização Se o seu agente usar [variáveis dinâmicas](/docs/pt/eleven-agents/customization/personalization/dynamic-variables) além das variáveis de sistema acima, você precisará planejar de onde virão seus valores. Se o seu agente não usar variáveis dinâmicas, nada disso se aplica. As **conversas recebidas** começam sem variáveis dinâmicas fornecidas pelo usuário. A forma compatível de fornecer valores é um [webhook de início de conversa](/docs/pt/eleven-agents/customization/personalization#conversation-initiation-webhooks): quando uma mensagem do WhatsApp inicia uma conversa, o ElevenAgents chama seu endpoint com o ID de usuário do WhatsApp como `caller_id` e o ID do número de telefone do seu WhatsApp como `called_number`, e aplica as variáveis dinâmicas retornadas pela sua resposta. Faça o webhook sempre retornar todas as variáveis necessárias para o agente — um valor do CRM quando você tiver um, ou uma constante alternativa caso contrário. > **Warning** > > Os valores inseridos em **Variáveis dinâmicas** no editor do agente são espaços reservados de teste para > visualizar o agente. Eles não são usados em produção e não funcionam como padrões para conversas > recebidas. As **conversas realizadas** recebem seus valores do campo `conversation_initiation_client_data.dynamic_variables` da [solicitação de mensagem ou chamada realizada](/docs/pt/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments). Esses valores permanecem durante toda a conversa e continuam disponíveis quando o usuário responde. Os parâmetros do modelo são um campo separado e não preenchem variáveis dinâmicas. Uma variável obrigatória que ficar sem valor fará a conversa falhar. Consulte [variáveis dinâmicas ausentes](/docs/pt/eleven-agents/whatsapp/troubleshooting#the-agent-doesnt-respond-to-inbound-messages) no guia de solução de problemas. > **Note** > > O valor de `system__called_number` é o **ID do número de telefone** do seu WhatsApp, não o número de telefone > em si. Os identificadores de usuários do WhatsApp também estão migrando para [IDs de usuário com escopo empresarial (BSUIDs)](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids); > o ElevenAgents oferece suporte a BSUIDs, então as conversas funcionam mesmo quando a Meta fornece um ID em vez do > número de telefone do usuário. ## Limitações Atualmente, não há suporte para: * **Fluxos do WhatsApp** — formulários interativos não podem ser enviados, e as respostas de Fluxo não são repassadas ao agente. * **Mensagens de vídeo** — vídeos recebidos não são repassados ao agente. * **Agrupamento de mensagens** — o agente responde a cada mensagem individualmente, em vez de combinar mensagens consecutivas enviadas rapidamente. * **Números gerenciados por outro provedor** — um número registrado com outro provedor do WhatsApp ou ativo no aplicativo WhatsApp Business não pode ser importado. Estamos trabalhando com a Meta para habilitar [Conversas com Múltiplas Soluções](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations); configurações apenas de voz já podem ser possíveis via SIP (consulte as [Perguntas frequentes](/docs/pt/eleven-agents/whatsapp/troubleshooting#faq)). * **WABAs criadas em um aplicativo de desenvolvedor** — não podem ser importadas pelo fluxo padrão. * **Metadados de referência de anúncios** — dados de atribuição de anúncios Click-to-WhatsApp não são expostos ao agente (consulte as [Perguntas frequentes](/docs/pt/eleven-agents/whatsapp/troubleshooting#faq)). * **Transferência para atendimento humano** — em breve (consulte as [Perguntas frequentes](/docs/pt/eleven-agents/whatsapp/troubleshooting#faq)). ## Perguntas frequentes Dúvidas comuns — preços, configurações com vários provedores, transferência para atendimento humano, Modo de Retenção Zero, OTP, conformidade — são respondidas em [Solução de problemas e perguntas frequentes](/docs/pt/eleven-agents/whatsapp/troubleshooting).