Como solucionar erros de conexão do WhatsApp

Ao conectar um número de telefone à API do WhatsApp Business, a maioria dos erros é causada pela Meta, e não pela SendPulse. A Meta informa esses erros por meio de códigos que são difíceis de interpretar à primeira vista.

Vamos falar sobre os erros que aparecem durante a conexão, por que um código de verificação pode não chegar e o que enviar ao suporte caso nada resolva o problema.

Conteúdo

Encontre seu erro durante a conexão

Os erros podem aparecer na janela de cadastro da Meta ou na SendPulse depois que o assistente é fechado. Encontre sua mensagem de erro na tabela abaixo:

Erro	Causa	O que fazer
`#2655122` ou `#2655093` — o número de telefone ou a conta do WhatsApp Business já pertence a um parceiro	Outro provedor ainda possui o número, ou uma conexão anterior feita por você ainda o mantém.	Exclua o número de telefone no Gerenciador do WhatsApp. Se o número usar Coexistência, desconecte-o do parceiro no aplicativo WhatsApp Business. Se o número ainda estiver registrado com um provedor anterior, somente esse provedor poderá liberá-lo.
`(#133005)PIN de verificação em duas etapas não corresponde`	A verificação em duas etapas está habilitada para o número de telefone, geralmente configurada por um provedor anterior.	Desative a verificação em duas etapas no Gerenciador do WhatsApp e tente novamente. Saiba mais: Como preparar seu número de telefone antes de conectá-lo.
`Certifique-se de que a autenticação de dois fatores esteja desativada`	A verificação em duas etapas está habilitada para o número de telefone.	Desative a verificação em duas etapas no Gerenciador do WhatsApp e confirme a alteração usando o link enviado pela Meta por e-mail.
A janela de cadastro fica esmaecida e não mostra nenhum erro.	A Meta exibe sua própria janela nesse momento. Seu portfólio empresarial pode ter atingido o limite de números de telefone registrados, que começa em dois para um novo portfólio.	Verifique sua empresa na Meta para aumentar o limite para 20. Saiba mais: Como verificar uma empresa no Facebook Business Manager.
A Meta rejeita o código de verificação, e o assistente é fechado sem criar um chatbot.	Você executou o assistente em um navegador para dispositivos móveis. O Safari para iOS corresponde à maioria desses casos.	Execute o assistente de conexão em um navegador para computador.
A Meta não permite migrar um número de telefone que começa com +1 555.	Esses são números de telefone comerciais de teste fornecidos pela Meta, e a Meta não permite portá-los.	Conecte o número de telefone como um novo número, nunca como uma migração.
A Meta não aceita o número de telefone.	A Meta não oferece suporte a números de telefone do seu país.	Use um número de telefone de um país compatível.

O status exibido pela Meta na interface pode ser diferente do status retornado pela API. Um status verde no Gerenciador do WhatsApp nem sempre significa que o número de telefone pode enviar mensagens.

Para ver a lista completa de códigos de erro da Meta, consulte Códigos de erro.

Descubra por que o código de verificação não chegou

Quando o assistente solicita um código que nunca chega, uma das situações descritas abaixo provavelmente é a causa.

Observe que a Meta envia o código de confirmação, e não a SendPulse. A SendPulse não pode reenviar o código nem verificar se a Meta o entregou, portanto o suporte não pode agilizar esse processo. Todas as causas abaixo estão relacionadas aos requisitos da própria Meta para um número de telefone comercial.

Saiba mais: Como preparar seu número de telefone antes de conectá-lo.

O número de telefone está sendo usado no WhatsApp

A Meta não pode registrar um número que já esteja vinculado a uma conta do WhatsApp. Primeiro, exclua sua conta no aplicativo do WhatsApp. Desinstalar o aplicativo não exclui a conta.

Para excluir sua conta, abra o aplicativo do WhatsApp. Acesse Configurações > Conta e clique em Apagar minha conta. Insira seu número de telefone no formato internacional e clique em Apagar minha conta.

Ao excluir uma conta, você perde permanentemente o histórico de conversas desse número. Antes de fazer isso, veja se a Coexistência funciona com seu número de telefone. Dessa forma, você poderá conectar o número de telefone pelo aplicativo WhatsApp Business e manter sua conta.

Para confirmar que o número de telefone não está mais vinculado a uma conta existente, abra https://wa.me/11111111111 em um navegador, substituindo 11111111111 pelo seu número de telefone no formato internacional, e clique em Iniciar conversa. Se o número de telefone estiver pronto para ser conectado, você verá o erro O número de telefone compartilhado pelo URL é inválido.

Às vezes, o WhatsApp não exibe nenhum erro. Para verificar novamente, envie uma mensagem para o número usando outro telefone. Se você vir uma marca de seleção (Enviada) ou duas marcas de seleção (Entregue), o número ainda está vinculado a uma conta do WhatsApp.

Se o número de telefone não estiver vinculado a uma conta e você ainda não receber o código, verifique se ele pode receber SMS ou chamadas do exterior. Números de telefone de sistemas de PABX de escritórios e números virtuais costumam bloquear mensagens e chamadas internacionais.

Outro provedor possui o número de telefone

Outro provedor já conectou o número de telefone à API do WhatsApp Business. Nesse caso, faça a migração em vez de registrá-lo novamente.

Saiba mais: Como mudar de outros provedores do WhatsApp para a SendPulse.

O número de telefone não pode receber o código

Para verificar um novo número de telefone, a Meta envia um código de uso único. Certifique-se de que você tenha acesso ao número de telefone durante a configuração e de que ele atenda a todos estes requisitos:

Pode receber SMS ou chamadas de voz.
Aceita chamadas e SMS internacionais.
Qualquer menu de voz automatizado (IVR) do número de telefone direciona a chamada para uma pessoa.

Os números de telefone recebem os dois tipos de código de forma confiável. Se você usar um telefone fixo, VoIP, número gratuito ou número com tarifa premium, selecione a opção de chamada de voz.

Números de telefone de PABX e números virtuais costumam bloquear chamadas e SMS internacionais. Você não verá nenhum erro indicando esse problema.

Saiba mais: Requisitos de elegibilidade.

Identifique os erros que a SendPulse não pode resolver

A Meta gerencia alguns problemas inteiramente do lado dela, e nenhuma ação na SendPulse pode alterá-los. Isso inclui a verificação da empresa, restrições e bloqueios na sua conta e um número de telefone que não foi liberado por um provedor anterior.

Como seu provedor, a SendPulse executa novamente as solicitações de conexão e atualiza as permissões de uma conta do WhatsApp Business à qual tem acesso. A SendPulse não verifica sua empresa, remove uma restrição nem atua em uma conta da qual não é parceira.

Entre em contato com o suporte com os dados corretos

Se o seu erro não estiver listado neste artigo, entre em contato com a equipe de suporte da SendPulse e inclua as seguintes informações:

Uma gravação de tela do processo de conexão, desde o primeiro clique até o erro.
O ID da sua conta da SendPulse, não o endereço de e-mail da conta.
O número de telefone no formato internacional.
O ID do seu portfólio empresarial da Meta.
O ID da sua conta do WhatsApp Business.
Uma captura de tela do status do número de telefone no Gerenciador do WhatsApp.

Informe o ID da sua conta em vez do endereço de e-mail. Isso ajuda nossa equipe de suporte a encontrar sua conta mais rapidamente.