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. 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.
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.
5. Limites de marketing — a Meta limita quantos modelos de marketing 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.
• 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 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 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 que retorne todas as variáveis exigidas pelo agente; consulte contexto de inicialização. 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 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.
• 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.
• O espaço de trabalho do agente está no Modo de retenção zero, 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.

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:

Para ver a lista completa, consulte a referência de códigos de erro da Meta.

Perguntas frequentes