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/comercial 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.

Verifique o console do seu navegador para mais detalhes.

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:

Entre em contato com o suporte ao cliente da Intercom para obter ajuda com este erro.

Certifique-se de que seu número do WhatsApp está conectado na página de instalação.

Verifique se o número de telefone está totalmente aprovado no Meta.

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 as etapas de integração da migração. Se não funcionar, contate o Suporte Intercom.

Este erro deve ser resolvido pelo Suporte 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 pelo Meta devido a qualquer erro de migração de telefone. Verifique a documentação do Meta para mais detalhes.

Além disso, se você encontrar o seguinte erro: Tipo: OAuthException Código: 1 Subcódigo de erro: 23881 Mensagem: Parâmetro inválido Título do erro para usuário: Não é possível criar certificado Mensagem do erro para usuário: 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 uma mensagem de erro como "(#1) Erro de parâmetro" ao conectar seu número do WhatsApp: Tire uma captura de tela da mensagem de erro. Frequentemente, resolver isso requer suporte do Meta. Confirme que todas as configurações no Meta e no Intercom estão configuradas corretamente antes de entrar em contato.

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.

Tire uma captura de tela e verifique suas configurações. A maioria dos erros de parâmetro se origina do lado do Meta e deve ser resolvida via Suporte Meta.

Esta mensagem de erro significa que o número de valores de parâmetros variáveis que você incluiu 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. Esta é a janela que você deve fechar 👇

Se você vir o erro:

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

Isso significa que o 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 no lado do Meta.

Nesses casos, vá para suas configurações no Meta para verificar os próximos passos necessários.

Verifique:

O Intercom 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.

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 mapeando 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 aplicativo WhatsApp (as versões mínimas exigidas incluem Android/SMBA 2.21.15.15, iOS/SMBI 2.21.170.4, KaiOS 2.2130.10 e Web 2.2132.6). Fatores adicionais que podem bloquear a entrega incluem a conta do destinatário estar sinalizada pelo Meta devido a ações pendentes ou ultrapassar os limites de frequência de mensagens.

Para resolver o problema, peça ao destinatário por outro canal de comunicação (como SMS, e-mail ou telefone) para confirmar que pode enviar uma mensagem para seu número WhatsApp Business, aceitar quaisquer solicitações pendentes de 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 pode receber em um determinado período.

Se você suspeitar que este é o motivo, a melhor ação é esperar pelo menos 24 horas antes de tentar reenviar a mensagem do modelo. Enviá-la novamente antes 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 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 Mensagens de Marketing do WhatsApp.

Esta mensagem não pôde ser entregue porque o WhatsApp não conseguiu enviar a 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 que 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 ao seu número WhatsApp, e o WhatsApp só permite mensagens livres dentro dessa janela ativa 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 modelo aprovada pelo WhatsApp. Assim que o destinatário responder, a janela de 24 horas será reaberta e mensagens livres poderão ser enviadas novamente.

Esta mensagem não pôde ser entregue porque a Conta Comercial do WhatsApp conectada ao seu aplicativo 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 resolvido o problema subjacente, a entrega de mensagens deve ser retomada normalmente.