Este erro aparece quando o número de telefone foi usado anteriormente com outro provedor da WhatsApp Business API ou com o aplicativo móvel/empresarial do WhatsApp. Se o número foi usado no aplicativo padrão do WhatsApp, você deve desconectá-lo antes de conectá-lo ao Intercom.

Se usado com outro provedor de API:
Siga o fluxo de integração para migrar um número de telefone WhatsApp existente e saia da integração embutida após o Passo 2.

Se usado com o aplicativo móvel do WhatsApp:
Siga os passos no link Saiba mais mostrado no erro para desconectar o número dessa conta do WhatsApp, então você poderá tentar novamente nosso processo de integração com sucesso.

Se nenhuma das opções se aplicar, entre em contato com o Suporte com seu:

Podemos tentar uma conexão manual.

Abra as ferramentas de desenvolvedor do seu navegador (pressione F12 ou clique com o botão direito na página e selecione Inspecionar), depois vá para a aba Console para ver a mensagem completa de erro.

Se isso ocorreu durante a migração:
A migração pode já ter sido concluída. Tente usar o fluxo “Estou integrando o WhatsApp pela primeira vez” e selecione as contas recém-criadas.

Se você não consegue salvar as configurações do perfil comercial e está recebendo um erro 500 no console do navegador, provavelmente é um erro de validação retornado pelo WhatsApp na configuração do perfil que você está tentando atualizar. Há alguns detalhes sobre as restrições, como o número máximo de caracteres aqui.

Erro completo: "Não é possível migrar o número de telefone. A conta do WhatsApp em que este número está registrado não está configurada corretamente".

Verifique:

Se ambas as verificações falharem: Enviar ao Suporte uma captura de tela do número verificado no Business Manager ajuda a acelerar a resolução.

Forneça ao Suporte seu:

Isso acontece quando sua WhatsApp Business Account (WABA) não foi compartilhada com o Intercom durante o cadastro embutido da Meta, então o Intercom não consegue acessá-la. Execute novamente o fluxo de conexão e certifique-se de conceder acesso ao Intercom à WABA quando solicitado. Se o erro persistir, entre em contato com o Suporte do Intercom com seu ID da WABA.

Certifique-se de que seu número do WhatsApp está conectado na página de instalação. Se não estiver, complete primeiro o fluxo de configuração do WhatsApp. Uma vez conectado, desative a autenticação de dois fatores no WhatsApp (veja a nota abaixo) e tente criar o certificado novamente.

Verifique se o número de telefone está totalmente aprovado no Meta Business Manager. Se houver etapas de revisão pendentes ou requisitos de aprovação para o número, conclua-os antes de tentar novamente no Intercom.

Isso geralmente ocorre devido a palavras restritas ou proibidas nos campos de título ou descrição.

Isso ocorre frequentemente para números fornecidos por provedores terceirizados. Tente novamente os passos de integração da migração. Se não funcionar, contate o Suporte do Intercom.

Este erro deve ser resolvido pelo Suporte da Meta e não pode ser corrigido dentro do Intercom.

Erro completo: "Solicitação get não suportada. Objeto com ID XXXXXXXXXXXX não existe, não pode ser carregado devido a permissões ausentes ou não suporta esta operação"

Ao tentar conectar um número, certifique-se de que o código mostrado é um ID de conta do WhatsApp.

Isso geralmente é sinalizado pela Meta devido a qualquer erro de migração de telefone. Verifique a documentação da Meta para mais detalhes.

Além disso, se você encontrar o seguinte erro: Tipo: OAuthException Código: 1 Erro_subcódigo: 23881 Mensagem: Parâmetro inválido Título_erro_usuario: Não é possível criar certificado Mensagem_erro_usuario: Seu negócio não atende aos requisitos da política do WhatsApp. Se você acredita que seu negócio se qualifica, entre em contato com o Suporte do Meta Business Suite. A documentação oficial pode ser encontrada aqui.

Se você encontrar um (#1) Erro de Parâmetro ao conectar seu número, veja a seção dedicada abaixo.

Exemplos:

Esses erros indicam que seu negócio pode não atender aos padrões da política do WhatsApp. Se você acredita que seu negócio se qualifica, entre em contato com o Suporte do Meta Business Suite. A documentação oficial pode ser encontrada aqui.

Para solucionar esse erro:

Esta mensagem de erro significa que o número de valores de parâmetros variáveis incluídos na sua solicitação de mensagem do WhatsApp não corresponde ao número de parâmetros variáveis definidos no seu modelo do WhatsApp. Você deve editar seu modelo e adicionar valores para todas as variáveis.

Siga estes passos:

Nota: Fechar o popup no momento correto é essencial para evitar este erro. Feche o popup de criação da Conta Comercial do WhatsApp mostrado abaixo após a conta ser criada, mas antes de adicionar seu número de telefone:

Se você vir o erro:

“Sua conta comercial tem uma ação pendente, você deve concluí-la antes de enviar”

Isso significa que a Meta (WhatsApp Business Manager) está bloqueando o envio de mensagens porque sua Conta Comercial do WhatsApp (WABA) ou configuração do número de telefone não está totalmente concluída/verificada do lado da Meta.

Acesse sua conta do Meta Business Manager, navegue até Contas do WhatsApp e verifique se há ações pendentes sinalizadas na sua Conta Comercial do WhatsApp (WABA) ou número de telefone. Complete as etapas de verificação pendentes e tente enviar sua mensagem novamente.

Antes de contatar o suporte, verifique o seguinte — modelos que não aparecem no Intercom geralmente falham em uma destas verificações:

O WhatsApp exige que os modelos usem espaços reservados numéricos (por exemplo, {{1}}) em vez de descritivos como {{sf_full_name}}. Exemplo: Olá {{1}}, seu pedido {{2}} foi enviado. O Intercom mapeia esses posicionais para seus atributos.

Se seus modelos usando variáveis como {{sf_full_name}} falharem, edite seu modelo no Meta para substituir os espaços reservados descritivos por numéricos e mapeie-os no Intercom. Isso garante compatibilidade entre WhatsApp e Intercom ao mapear variáveis diretamente para atributos do Intercom.

Para garantir que os modelos permaneçam não comerciais:

O WhatsApp não conseguiu entregar esta mensagem porque a conta WhatsApp do destinatário não está atualmente apta a receber mensagens. Isso pode acontecer se o número de telefone não estiver registrado no WhatsApp, se o destinatário não aceitou os Termos de Serviço ou Política de Privacidade mais recentes do WhatsApp, ou se estiver usando uma versão desatualizada do WhatsApp (os requisitos mínimos de versão estão listados na tabela abaixo). Fatores adicionais que podem bloquear a entrega incluem a conta do destinatário estar sinalizada pelo Meta devido a ações pendentes ou ultrapassar limites de frequência de mensagens. O Intercom mapeia isso como código de erro 131026, exibido como "mensagem não entregue" ou "destinatário incapaz."

Para resolver o problema, peça ao destinatário por outro canal de comunicação (como SMS, e-mail ou telefone) para confirmar se ele pode enviar uma mensagem para seu número Comercial do WhatsApp, aceitar quaisquer solicitações pendentes dos Termos de Serviço indo em Configurações > Ajuda ou Configurações > Informações do aplicativo, e atualizar o cliente WhatsApp para a versão mais recente.

Depois que eles concluírem essas etapas, o WhatsApp deverá conseguir entregar suas mensagens com sucesso.

Esta mensagem não foi entregue porque o WhatsApp a bloqueou para manter o engajamento saudável do ecossistema, o que geralmente significa que o destinatário atingiu um limite de quantas mensagens de modelo de marketing ele pode receber em um determinado período. O Intercom identifica isso como código de erro 131049 (engajamento do ecossistema). Para etapas de solução de problemas e prazos de redefinição, consulte o guia de solução de falhas de mensagens do WhatsApp.

Se você suspeita que esta é a causa, a melhor ação é esperar pelo menos 24 horas antes de tentar reenviar a mensagem do template. Enviá-la novamente antes disso provavelmente resultará no mesmo erro, pois o limite pode permanecer ativo por períodos variados. A duração para liberar o limite de frequência pode variar, então consulte a documentação do WhatsApp para orientações sobre os prazos específicos de reinício.

Esta mensagem não foi enviada como parte de um experimento. Para mais detalhes sobre experimentos, veja a documentação do Experimento de Mensagem de Marketing do WhatsApp.

Esta mensagem não pôde ser entregue porque o WhatsApp não conseguiu fazer o upload da mídia incluída nela, o que normalmente ocorre quando o arquivo usa um formato não suportado ou não atende aos requisitos de mídia do WhatsApp.

Para resolver isso, revise o arquivo de mídia que você está tentando enviar e confirme se seu formato e tamanho são suportados pelo WhatsApp. Uma vez que a mídia atenda aos requisitos do WhatsApp, você deverá conseguir reenviar a mensagem com sucesso.

Esta mensagem não pôde ser entregue porque mais de 24 horas se passaram desde a última resposta do destinatário para o seu número do WhatsApp, e o WhatsApp só permite mensagens livres dentro dessa janela ativa de conversa de 24 horas. Esse erro também pode ocorrer se o número de telefone do destinatário mudou durante a conversa, o que efetivamente reinicia a sessão.

Para continuar enviando mensagens, você precisará enviar uma mensagem de template aprovada pelo WhatsApp. Uma vez que o destinatário responda, a janela de 24 horas será reaberta e mensagens livres regulares poderão ser enviadas novamente.

Esta mensagem não pôde ser entregue porque a Conta Comercial do WhatsApp conectada ao seu app foi restringida ou desativada. Isso geralmente acontece quando o WhatsApp detecta uma violação das políticas da plataforma, ou quando os detalhes na solicitação não podem ser verificados em relação à configuração da conta — por exemplo, um PIN incorreto de verificação em duas etapas.

Para resolver isso, revise as diretrizes de Aplicação de Políticas do WhatsApp para entender o tipo de violação e os passos necessários para restaurar a conta. Você também pode verificar a API de Status de Saúde do WhatsApp para obter uma visão mais específica do motivo pelo qual a conta foi bloqueada ou restringida. Uma vez que o problema subjacente seja resolvido, a entrega de mensagens deve voltar ao normal.