Conectando o WhatsApp

O WhatsApp faz parte do módulo Atendimento, para quando um agente atende cliente. Os agentes do time não precisam de canal nenhum: funcionam no chat interno.

A ControlHub se conecta ao WhatsApp via Meta Cloud API — a API oficial da Meta. Não é WhatsApp pessoal, não é WhatsApp Web, e não é Z-API ou terceiros. É oficial.

Isso significa:

• Conta nunca bloqueada por uso de bot (é permitido pela Meta).
• Volume alto suportado (mensagens por segundo negociadas com a Meta).
• Botões interativos, listas, templates, mídia — tudo disponível.
• Você precisa de uma conta Meta Business + número verificado.

Pré-requisitos

Antes de começar, você vai precisar de:

1. Conta Meta Business (Business Manager). Se já tem Instagram ou Facebook business, já tem.
2. Número de telefone novo — não pode ser um número que já está em uso no WhatsApp comum. Se estiver, precisa desvincular primeiro.
3. Formas de verificação do número: SMS ou ligação (você escolhe na hora do setup).

Se nunca usou Meta Cloud API antes, a primeira configuração é mais demorada (cerca de 30 minutos). Depois, adicionar números extras é rápido.

Passo 1: ir para a área de WhatsApp

Dashboard → Canais → WhatsApp.

Clique Conectar WhatsApp. Você é redirecionado para um fluxo oficial da Meta que roda dentro de um modal embutido (Embedded Signup).

Passo 2: autorizar a ControlHub

Na tela da Meta:

1. Faça login com a conta que gerencia seu Business Manager.
2. Selecione qual Business Manager usar (se tiver mais de um).
3. Autorize a ControlHub a acessar sua conta WhatsApp Business.

Passo 3: adicionar o número

Ainda dentro do fluxo:

1. Adicione um número — o tal número novo, ou um número existente que você desvinculou.
2. Verificação — SMS ou ligação (a Meta envia o código).
3. Confirmar.

Quando concluir, a Meta te retorna para a ControlHub com o número já ativo.

Passo 4: associar a um agente

Na tela de WhatsApp da ControlHub, clique no número recém-adicionado. Na aba Associação, escolha:

• Agente único — uma única instância do agente atende todas as mensagens do número.
• Squad — um squad de agentes assume o número, com handoffs internos. Veja Montando um squad.

Passo 5: testar

Mande uma mensagem do seu celular pessoal para o número que você cadastrou. Em até 2 segundos o agente deve responder.

A conversa aparece em tempo real no Inbox da ControlHub.

Templates aprovados

Algumas mensagens exigem template aprovado pela Meta — principalmente mensagens de saída iniciadas por você (não respostas a mensagens do cliente). Configurar o template leva cerca de 24 horas para a Meta analisar. Vá em WhatsApp → Templates e submeta.

Quando você está apenas respondendo mensagens que o cliente iniciou, pode escrever livremente — sem template.

Limites por plano

Problemas comuns

"Este número já está em uso no WhatsApp"

Abra o WhatsApp comum no celular → Configurações → Contas Vinculadas → Desvincular. Depois tente de novo na ControlHub.

"Meta bloqueou a verificação"

Pode ser limite de tentativas. Espere 1 hora e tente novamente. Se persistir, fale com a gente.

"Mensagens não chegam"

No painel de WhatsApp, verifique o status: deve estar Connected. Se estiver Flagged ou Restricted, é limite de qualidade da Meta — reduza volume temporariamente até o status voltar.