WhatsApp Oficial (Cloud API)

O WhatsApp Oficial usa a Cloud API da Meta para enviar e receber mensagens. E o modo recomendado para produção: estável, com SLA e limites oficiais, e sem o risco de ser desconectado como pode acontecer no modo QR Code.

Pre-requisitos

Antes de conectar:

• Número de telefone dedicado ao WhatsApp Business, sem WhatsApp pessoal ativo nele.
• Conta no Facebook Business Manager (gratuita).
• (Opcional) Verificação do negócio no Meta Business Manager — necessária para remover limites de envio em produção e sair do modo sandbox.

Passo a passo

1. Abra Admin -> Agentes -> [seu agente] -> Gatilhos.
2. No card WhatsApp Oficial (identificado pela badge API Meta), clique em Conectar.
3. Uma janela da Meta abrira — siga o fluxo Embedded Signup:
   • Entre com sua conta do Facebook Business.
   • Selecione (ou crie) a conta WABA e o número.
   • Confirme as permissoes solicitadas.
4. Aguarde até 30 segundos enquanto o SquadOS registra o número na Cloud API. Mantenha a aba aberta durante esse tempo.
5. Quando o processo termina, o card fica Conectado e já comeca a receber mensagens.

Verificação em duas etapas (2FA)

Se o número que você esta conectando já tem verificação em duas etapas ativada — o PIN de 6 digitos que você configura no próprio WhatsApp — o SquadOS não consegue finalizar o registro automaticamente e abre um dialogo perguntando o que fazer.

Por que isso acontece: ao migrar o número para a Cloud API, a Meta exige o PIN atual como prova de titularidade. Sem ele, a chamada de register falha com o erro (#133005) Two step verification PIN Mismatch.

Você tem tres caminhos, listados do mais rápido para o último recurso:

1. Informar o PIN atual (mais rápido)

Se você lembra do PIN de 6 digitos, digite no campo do dialogo e clique em Registrar com este PIN. O SquadOS usa esse PIN para finalizar o registro. Nenhum outro passo necessário.

2. Redefinir o PIN no WhatsApp Manager (recomendado se esqueceu)

Se você não lembra do PIN, redefina no WhatsApp Manager:

1. Acesse o Manager e selecione seu número.
2. Va na aba Confirmação em duas etapas.
3. Clique em Inserir novo PIN e defina um novo código de 6 digitos.
4. Volte ao SquadOS e digite o novo PIN no dialogo.

Esse caminho não exige confirmação por e-mail e não desativa nenhuma camada de seguranca do seu número. E a forma oficial recomendada pela Meta quando você perde o PIN.

3. Desabilitar a verificação em duas etapas (último recurso)

So use se os caminhos acima não forem possiveis. No mesmo WhatsApp Manager, em Confirmação em duas etapas, clique em Desativar a confirmação em duas etapas.

• A Meta envia um e-mail de confirmação para o endereco associado ao portfolio de negócio.
• Você precisa clicar no link do e-mail para concluir a desativação.
• Depois disso, volte ao SquadOS e clique em Já desabilitei, tentar no dialogo.

Após o número estar conectado no SquadOS, você pode reativar a 2FA novamente no WhatsApp Manager — o PIN que a Cloud API configurou internamente continua valido.

Solucao de problemas

O número não aparece após o Embedded Signup. O registro pode ter falhado por motivo diferente de 2FA. Abra o console do navegador (F12 -> Console) durante o clique em “Conectar” e verifique se aparece algum erro — envie o texto para o suporte.

Mensagens não estão chegando. Verifique em Admin -> Agentes -> [seu agente] -> Gatilhos -> WhatsApp Oficial -> Informações se o status do número e Conectado. Se estiver Pendente ou Restrito, confira no Meta Business Manager se ha aprovações em andamento.

“Too many attempts” no PIN. A Meta bloqueia temporariamente após várias tentativas incorretas. Aguarde alguns minutos e tente de novo, ou use o caminho #2 (redefinir no Manager) — o contador reseta quando você define um PIN novo.