> 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. # Solução de problemas e perguntas frequentes ## Mensagem aceita, mas não entregue Uma resposta `200` do endpoint de mensagens de saída significa que a ElevenLabs aceitou e encaminhou a solicitação — a entrega ainda depende da Meta. Se a mensagem nunca chegar, verifique nesta ordem: 1. **Aprovação do modelo** — o modelo precisa ter o status Aprovado no [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates). Modelos pendentes ou rejeitados não são entregues. 2. **Pagamentos** — a ausência de uma forma de pagamento ou pagamentos pendentes na sua conta comercial do WhatsApp bloqueiam a entrega de modelos (erro 131042 da Meta). Adicione ou atualize a forma de pagamento no WhatsApp Manager. 3. **Formato dos parâmetros** — as entradas de `template_params` precisam ser objetos de componente (`{"type": "body", "parameters": [...]}`), todos os espaços reservados no modelo precisam ser preenchidos, e modelos nomeados precisam de um `parameter_name` em cada valor. Consulte [parâmetros do modelo](/docs/pt/eleven-agents/whatsapp/outbound#template-parameters). 4. **Formato do destinatário** — `whatsapp_user_id` deve conter apenas dígitos com o código do país, sem `+`. Consulte [formato do número do destinatário](/docs/pt/eleven-agents/whatsapp/outbound#recipient-number-format). 5. **Limites de marketing** — a Meta limita quantos [modelos de marketing](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits) um usuário pode receber em determinado período (erro 131049). Modelos de utilidade não estão sujeitos a esse limite. ## Problemas de importação * **Não é possível importar o número** — ele está registrado com outro provedor do WhatsApp ou ativo no app WhatsApp Business. Um número só pode ser registrado com um provedor; consulte [Limitações](/docs/pt/eleven-agents/whatsapp#limitations). * **Sua WABA não aparece no fluxo de importação** — confirme que você está conectado a uma conta do Facebook com acesso de administrador ao portfólio empresarial que é proprietário da WABA e tente importar novamente. * **WABAs criadas em um app de desenvolvedor da Meta** não podem ser importadas pelo fluxo padrão. ### Verifique se outro parceiro gerencia o número Um número que parece inelegível, não aparece no fluxo de importação ou apresenta erro ao ser importado geralmente continua registrado com um provedor anterior. Um parceiro que controla o número explica tanto uma importação com falha quanto uma WABA ausente. 1. Acesse [business.facebook.com](https://business.facebook.com) e selecione o portfólio empresarial. 2. Abra **Configurações do negócio** > **Contas do WhatsApp**. 3. Verifique **Números de telefone** em cada conta do WhatsApp até encontrar aquela que contém seu número. 4. Abra **Parceiros**. 5. Desconecte o número desse parceiro (ou remova todo o portfólio empresarial) e tente importar novamente alguns minutos depois. ## O agente não responde às mensagens recebidas A confirmação de leitura e o indicador de digitação ajudam a identificar a causa: eles são enviados no momento em que uma mensagem é aceita para processamento, antes de o agente produzir uma resposta. Com **Ativar indicador de digitação** ativado (o padrão), envie uma mensagem de teste e veja se ela é marcada como lida e se o indicador de digitação aparece. **O indicador de digitação aparece, mas nenhuma resposta chega.** A mensagem chegou à ElevenLabs e o agente começou a trabalhar; a falha ocorre durante a produção ou a entrega da resposta: * O agente exige uma [variável dinâmica](/docs/pt/eleven-agents/customization/personalization/dynamic-variables) sem valor. Conversas recebidas pelo WhatsApp começam sem variáveis dinâmicas fornecidas pelo usuário — apenas as variáveis do sistema são preenchidas. A solução é um [webhook de início de conversa](/docs/pt/eleven-agents/customization/personalization#conversation-initiation-webhooks) que retorne todas as variáveis exigidas pelo agente; consulte [contexto de inicialização](/docs/pt/eleven-agents/whatsapp#initialization-context). Os valores inseridos em **Variáveis dinâmicas** no editor do agente são espaços reservados para teste e não são usados em produção. * A Meta recusou a resposta do agente — por exemplo, devido a um limite de taxa para esse par empresa–usuário ou a um problema de pagamento no nível da conta. Consulte a [referência de erros](#meta-error-reference) abaixo. A conversa falha se essas variáveis dinâmicas obrigatórias não estiverem presentes. **Nenhum indicador de digitação aparece.** A mensagem foi descartada antes de chegar ao agente: * Nenhum agente está atribuído ao número, ou a opção **Ativar mensagens** está desativada — verifique as configurações da conta na [página do WhatsApp](https://elevenlabs.io/app/agents/whatsapp). * A autorização da conta não é mais válida — o token de acesso expirou ou foi revogado pela Meta. Importe a conta novamente na [página do WhatsApp](https://elevenlabs.io/app/agents/whatsapp). * O espaço de trabalho do agente está no [Modo de retenção zero](/docs/pt/eleven-api/resources/zero-retention-mode), que ignora completamente as mensagens recebidas pelo WhatsApp. * A mensagem recebida é de um tipo não compatível (por exemplo, vídeo ou resposta de um Fluxo do WhatsApp) — consulte [Limitações](/docs/pt/eleven-agents/whatsapp#limitations). > **Note** > > Se **Ativar indicador de digitação** estiver desativado para a conta, essa verificação não se aplica — > analise as duas listas. ## A primeira resposta após um modelo se comporta de forma inesperada Se seu agente tiver a substituição de **Primeira mensagem** ativada na guia **Segurança**, ela poderá entrar em conflito com conversas iniciadas por modelos de saída — o modelo já serviu como primeira mensagem. Se as respostas aos modelos se comportarem de forma inesperada, remova a substituição de primeira mensagem dos agentes usados com mensagens de saída do WhatsApp. ## Referência de erros da Meta Os erros retornados pela Meta durante a entrega são exibidos com orientações de correção quando possível. Os mais comuns: | Código | Significado | O que fazer | | ------ | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | 131042 | Problema de pagamento na conta comercial do WhatsApp | Adicione ou corrija a forma de pagamento no WhatsApp Manager | | 131056 | Limite de taxa para este par empresa–usuário | Reduza o ritmo de envio de mensagens para este usuário | | 131047 | É necessário reengajar | A Janela de Atendimento ao Cliente foi encerrada — reengaje usando um modelo | | 130497 | Empresa restrita de enviar mensagens para usuários em um país | A Meta restringiu as mensagens entre países da conta — resolva com o suporte da Meta | | 132000 | A quantidade de parâmetros não corresponde ao modelo | Envie exatamente os parâmetros definidos pelo modelo — consulte [parâmetros do modelo](/docs/pt/eleven-agents/whatsapp/outbound#template-parameters) | | 132001 | O modelo não existe | Verifique o nome e o código de idioma do modelo e se ele foi aprovado | | 131037 | Problema com o nome de exibição do número de telefone | Conclua a aprovação do nome de exibição no WhatsApp Manager | | 190 | Token de acesso expirado | Importe a conta novamente na [página do WhatsApp](https://elevenlabs.io/app/agents/whatsapp) | Para ver a lista completa, consulte a [referência de códigos de erro da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes). ## Perguntas frequentes #### Como é cobrado o uso do WhatsApp? Duas partes fazem cobranças separadamente. **ElevenLabs** cobra pelo uso do agente — tempo de conversa, mensagens, conversão de fala em texto e conversão de texto em fala para mensagens de voz, além do uso de LLM — por meio dos créditos do seu plano, seguindo a [cobrança padrão da ElevenLabs](/docs/pt/overview/administration/billing). **Meta** cobra separadamente pelas taxas do WhatsApp, como mensagens de modelo, chamadas de saída e solicitações de permissão de chamada, cobradas pela forma de pagamento no WhatsApp Manager. As tarifas variam conforme a categoria da mensagem e o país, e a Meta anunciou atualizações de preços que entrarão em vigor em 1º de outubro de 2026 — consulte os [preços do WhatsApp da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing) para conhecer as tarifas aplicáveis aos seus mercados. #### Posso usar a ElevenLabs junto com outro provedor do WhatsApp? Atualmente, um número só pode ser registrado com um provedor de mensagens. Se um provedor terceirizado (por exemplo, Gupshup) gerencia sua conta, ela também não pode ser importada para a ElevenLabs. Estamos trabalhando com a Meta para habilitar as [Conversas com Múltiplas Soluções ](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations), que permitem vários provedores em um mesmo número. **Voz por SIP.** Se seu objetivo é manter as mensagens com o provedor atual e usar um agente da ElevenLabs para voz, já há uma opção disponível: o WhatsApp Business Calling oferece suporte a SIP, portanto, um provedor que disponibiliza configuração SIP pode encaminhar as chamadas do WhatsApp do seu número para um [tronco SIP](/docs/pt/eleven-agents/phone-numbers/sip-trunking) da ElevenLabs. Seu provedor continua gerenciando as mensagens no número; as chamadas são atendidas pelo seu agente via SIP. Isso funciona ou não depende de seu provedor oferecer suporte ao roteamento de chamadas SIP — [entre em contato](https://elevenlabs.io/contact-sales) para que possamos avaliar sua configuração. Se você opera seu próprio app do WhatsApp na mesma conta (em vez de usar um provedor terceirizado), já pode configurar a ElevenLabs para atender apenas chamadas: desative a opção ***Ativar mensagens*** nas configurações da conta. #### Como transfiro uma conversa para uma pessoa? Em breve. Estamos trabalhando com a Meta na Coexistência com o WhatsApp Business, que permitirá que sua equipe participe de conversas no mesmo número usado pelo agente. #### O Modo de retenção zero funciona com o WhatsApp? O [Modo de retenção zero](/docs/pt/eleven-api/resources/zero-retention-mode) limita nossa capacidade de oferecer recursos do WhatsApp: mensagens recebidas são ignoradas e chamadas de saída não são permitidas. #### Posso personalizar com base no anúncio do WhatsApp em que um usuário clicou? Ainda não. O agente recebe e responde a conversas iniciadas por anúncios Click-to-WhatsApp, mas os metadados de indicação de anúncios da Meta (como `ctwa_clid` e identificadores de campanha ou de criativo) não são expostos atualmente ao agente, às variáveis dinâmicas ou aos webhooks; portanto, a personalização e a atribuição baseadas em anúncios não têm suporte nativo. Isso está registrado como uma solicitação de recurso — se a atribuição de anúncios for importante para seu caso de uso, [entre em contato](https://elevenlabs.io/contact-sales). #### Como envio códigos de verificação (OTP)? Use um modelo de Utilidade com o código como parâmetro do corpo, enviado pelo [endpoint de mensagens de saída](/docs/pt/eleven-agents/whatsapp/outbound). A categoria de modelo de Autenticação da Meta (com botões para copiar código) ainda não recebe suporte especial. #### Quem é o provedor de tecnologia da minha conta do WhatsApp? Quando você importa uma conta comercial do WhatsApp, a ElevenLabs atua como **Provedor de tecnologia** dessa conta no modelo de parceiros da Meta. A ElevenLabs é uma parceira de tecnologia da Meta, não uma revendedora: a Meta cobra diretamente de você as taxas do WhatsApp pela forma de pagamento no WhatsApp Manager. #### Há suporte para residência de dados na UE? A residência de dados na UE para o ElevenAgents, incluindo dados de conversas do WhatsApp, está disponível em planos Enterprise por meio do ambiente isolado da UE. Isso abrange os dados processados pela infraestrutura da ElevenLabs; o transporte de mensagens pelo próprio WhatsApp é regido pelo seu contrato com a Meta.