Erros de conexão do WhatsApp Oficial

Quando a conexão do WhatsApp Oficial não termina, o SquadOS mostra um aviso com um título e o próximo passo. O botão Ver documentação do aviso abre a seção correspondente desta página.

A maioria dos erros se resolve repetindo Conectar com WhatsApp e fazendo uma escolha diferente na janela da Meta. Ajustes na conta, como excluir um número pendente, são feitos no Gerenciador do WhatsApp da Meta, em business.facebook.com.

A autorização da Meta expirou

O código que a Meta entrega ao fim da janela vale por poucos segundos e só pode ser usado uma vez. Ele expira quando a janela fica parada ou quando a mesma tentativa é reenviada.

Clique em Conectar com WhatsApp de novo e conclua a janela da Meta sem pausas. Mantenha a aba do SquadOS aberta até aparecer Conectado.

A Meta recusou a autorização

A Meta não confirmou o acesso concedido na janela. Isso acontece quando o perfil do Facebook usado não administra a conta do WhatsApp Business, ou quando a autorização foi revogada.

Clique em Conectar com WhatsApp de novo.
Na janela da Meta, entre com o perfil do Facebook que administra o portfólio empresarial e a conta do WhatsApp Business.
Conclua todas as telas e aprove o acesso pedido pelo SquadOS.

Faltaram permissões do WhatsApp

O SquadOS precisa de duas permissões: gerenciar a conta do WhatsApp Business e enviar mensagens. Se uma delas for desmarcada na janela da Meta, a conexão é recusada.

Conecte de novo e mantenha marcadas as duas permissões da tela de acesso.

Nenhuma conta do WhatsApp Business foi compartilhada

A janela da Meta foi encerrada antes da etapa em que você escolhe ou cria a conta do WhatsApp Business.

Conecte de novo e avance por todas as telas, até escolher ou criar a conta e o número. Fechar a janela no meio do caminho não cria a conexão.

Mais de uma conta do WhatsApp Business foi compartilhada

Várias contas foram marcadas na janela da Meta, e o SquadOS não sabe qual delas usar.

Conecte de novo e, na janela da Meta, marque só a conta e o número desta caixa de entrada. Para conectar outro número, crie outra caixa de entrada.

O SquadOS não recebeu acesso à conta do WhatsApp Business

A conta escolhida não foi incluída no acesso concedido ao SquadOS, ou o perfil usado não tem permissão para compartilhá-la.

Confirme no Gerenciador do WhatsApp que o seu perfil é administrador da conta.
Clique em Conectar com WhatsApp de novo.
Na tela de acesso da Meta, marque a conta do WhatsApp Business que você quer conectar.

A conta do WhatsApp Business não tem número

A conta compartilhada ainda não tem nenhum número de telefone.

Adicione o número à conta no Gerenciador do WhatsApp, em Números de telefone, e conecte de novo. Na Coexistência, a própria janela da Meta adiciona o número do app WhatsApp Business.

O número não está na conta escolhida

A janela da Meta devolveu um número que não pertence à conta escolhida. Isso costuma acontecer quando tentativas anteriores deixaram o mesmo número pendente em mais de uma conta.

Abra o Gerenciador do WhatsApp e revise as contas do seu portfólio empresarial.
Se o número aparece como Pendente ou Não verificado numa conta que você não usa, exclua esse registro. A Meta pede a senha da sua conta para confirmar.
Clique em Conectar com WhatsApp de novo e escolha a conta em que o número deve ficar.

O SquadOS não recebeu acesso ao número

A conta foi compartilhada, mas o número escolhido ficou de fora do acesso concedido.

Conecte de novo e, na janela da Meta, marque o número que você quer usar nesta caixa de entrada.

Esta caixa de entrada usa outro número

Ao reconectar, a janela da Meta devolveu um número ou uma conta diferente dos que esta caixa de entrada já usa. O SquadOS recusa a troca para não misturar as conversas de dois números.

Para reconectar, escolha na janela da Meta o mesmo número e a mesma conta desta caixa.
Para usar outro número, conecte uma caixa de entrada nova.

O número pede outro modo de conexão

O modo escolhido não combina com o número.

Se o número está no app WhatsApp Business do celular, escolha Coexistência.
Se o número não está no app, escolha Somente API oficial.
Na reconexão, use o mesmo modo com que a caixa de entrada foi criada.

Este número não está no app WhatsApp Business

A Coexistência só funciona com um número ativo no app WhatsApp Business do celular. O app WhatsApp comum não serve.

No celular, confirme que o número está no app WhatsApp Business, na versão mais recente.
Clique em Conectar com WhatsApp de novo.
Na janela da Meta, escolha conectar a conta existente do app WhatsApp Business e siga as instruções que aparecem no celular.

Para um número que não está no app, escolha Somente API oficial.

A Meta não ativou o recebimento de mensagens

A conexão foi autorizada, mas a Meta não ativou o envio das mensagens recebidas para o SquadOS.

Conecte de novo. Se o erro continuar, confira no Gerenciador do WhatsApp se a conta está ativa e sem restrições, e resolva os avisos que a Meta mostrar lá.

A Meta não registrou o número

No modo Somente API oficial, o número precisa ser registrado na API da Meta, e o registro foi recusado.

Confira no Gerenciador do WhatsApp se o número está ativo e se não está em uso em outro serviço da API.
Se o número tem verificação em duas etapas, siga a seção Verificação em duas etapas.
Para continuar usando o app WhatsApp Business no celular, conecte pelo modo Coexistência.

A conexão do WhatsApp está indisponível no momento

O erro é do lado do SquadOS, não da sua conta. O suporte é avisado automaticamente.

Tente de novo mais tarde. Nada precisa ser alterado na Meta.

Não foi possível conectar o WhatsApp

A conexão foi recusada por um motivo que ainda não tem orientação própria. O aviso mostra um código, por exemplo invalid_connection_mode.

Tente de novo. Se o erro continuar, fale com o suporte do SquadOS e informe o código mostrado no aviso.