Você conecta o WhatsApp oficial numa janela da própria Meta, aberta de dentro do Codewo: faz login, escolhe a conta do WhatsApp Business e o número, e volta com o canal pronto. Não precisa copiar token nem configurar webhook à mão.
O que você vai precisar
- Login no Facebook de quem administra a empresa na Meta, com acesso ao portfólio empresarial (o antigo Business Manager).
- Um número para a API. Se ele já tem WhatsApp no celular, comum ou Business, a Meta pede que essa conta seja apagada no aplicativo antes do cadastro. As conversas do celular não vêm junto.
- Acesso ao número para receber o código de verificação que a Meta manda por SMS ou ligação.
- Documento da empresa, se a Meta pedir verificação do negócio.
- Permissão para configurar canais no Codewo. Se o botão Adicionar Canal não aparece para você, peça a quem administra a conta.
Como funciona
A janela da Meta cuida do login, da escolha (ou criação) da conta do WhatsApp Business, do número e da verificação. Quando ela fecha, o Codewo registra o número na API, passa a receber as mensagens dele e cria o canal. A partir daí, tudo o que chega nesse número cai na Caixa de Entrada.
Passo a passo
Cenário: a Loja Exemplo vai conectar o número (19) 99999-9999 como "WhatsApp Vendas".
Em Configurações → Comunicação → Canais, clique em Adicionar Canal. O assistente tem três etapas: Canal → Conectar → Detalhes.
- Canal. Escolha o card WhatsApp Business (WhatsApp Business Cloud API) e clique em Próximo.
- Conectar. Clique em Conectar com WhatsApp. Abre a janela da Meta.
- Na janela da Meta, faça login e siga as telas: escolha (ou crie) o portfólio da empresa, a conta do WhatsApp Business e o número. Se o número ainda não está na API, a Meta manda um código por SMS ou ligação; digite o código na janela. Defina também o nome de exibição, que é o nome que o cliente vê no perfil.
- Volta ao Codewo. A janela fecha, aparece "Conectado:" com o nome ou o número, e o assistente segue para Detalhes.
- Detalhes. Preencha Nome do Canal (interno, por exemplo "WhatsApp Vendas"). Deixe Compartilhar contatos ligado para os canais de WhatsApp da empresa reconhecerem o mesmo cliente pelo telefone. Se já houver contatos em outros canais de WhatsApp, aparece Vincular contatos existentes, que liga esses contatos ao número novo em segundo plano.
- Clique em Criar Canal. O card do número aparece na lista de canais com o selo Conectado e a linha Atende: Todos da empresa.
- Quem atende. Para reservar o número a equipes ou pessoas, clique na linha Atende: do card, ou em Quem atende no menu do card, e escolha em Quem atende este canal.
Em algumas instalações o assistente tem quatro etapas, Conectar → Número → Webhook → Detalhes. A diferença é que a conta e o número são escolhidos numa lista dentro do Codewo, o número já precisa estar cadastrado na API pela Meta, e a etapa Webhook só confirma que o recebimento será configurado ao criar o canal.
Depois de conectar
- Confira o card. Em Canais, o card mostra o número e o selo Conectado.
- Mande um teste. De outro celular, escreva para o número e responda pela Caixa de Entrada.
- Traga os modelos aprovados. Em Configurações → Comunicação → Templates de Mensagem, aba Templates de Canal (HSM), clique em Sincronizar para trazer os modelos que já existem na Meta, ou em Novo Template para criar um.
- Use o menu do card (os três pontos):
| Opção | Para quê |
|---|---|
| Configurar | Mudar o nome, ligar ou desligar o canal (Canal Ativo) e Compartilhar contatos. Mostra, só para leitura, o número, o Phone Number ID, o WABA ID, o status e a mensagem de erro, se houver |
| Quem atende | Reservar o número a equipes ou pessoas |
| Chamadas de Voz | Ligar o recebimento de ligações neste número (aparece para quem tem a permissão Configurar chamadas) |
| Importar Contatos | Ligar a este número os contatos que já existem nos outros canais de WhatsApp |
| Desativar Canal / Excluir Canal | Parar de receber e enviar, ou remover o canal |
A janela de 24 horas
No WhatsApp oficial, a empresa responde livremente por 24 horas depois da última mensagem do cliente. Passado esse prazo, só sai modelo aprovado pela Meta.
- Na Caixa de Entrada, fora da janela, o campo de texto dá lugar ao aviso Janela fechada · Use um template para reabrir a conversa e ao botão Template. Para contato que nunca escreveu, o aviso diz Sem interação.
- Quando o cliente responde ao modelo, a janela abre de novo.
- Se a Meta recusar uma mensagem por janela fechada mesmo quando ela parecia aberta, o Codewo passa a tratar a janela como fechada até o cliente escrever de novo, e bloqueia o reenvio como texto livre.
- Mensagem que falha mostra um selo com o erro da Meta traduzido, como "Janela 24h expirada — envie template" ou "Template não existe ou não aprovado".
Detalhes em Modelos aprovados do WhatsApp e a janela de 24 horas.
Pegadinhas comuns
- Outro provedor ainda ligado à conta. Se o número vinha de outra ferramenta, o Codewo avisa: "Outro provedor de mensagens (...) continua assinado nesta conta". Peça ao provedor anterior para remover o acesso, ou abra chamado na Meta. Com os dois ligados, eventos podem duplicar e mensagens podem não chegar.
- Número ainda em uso no aplicativo. A verificação falha enquanto o número tem conta ativa no WhatsApp do celular.
- O nome de exibição passa por revisão da Meta. Nome genérico ou que não bate com a empresa pode ser recusado. O motivo aparece no gerenciador da Meta.
- Fechou o assistente depois da janela da Meta? O canal já foi criado quando a janela fechou, com o nome que a Meta informou para o número. Ele aparece na lista; use Configurar para renomear.
- Não conecte o mesmo número duas vezes. Cada conexão cria um canal novo.
- Modelo novo fica Pendente até você sincronizar. A aprovação costuma levar minutos, às vezes horas. Clique em Sincronizar para trazer o status atualizado.
- Algumas coisas não existem na API oficial: editar ou apagar mensagem enviada, grupos, e a reação da equipe chegar ao cliente (ela fica só na tela da equipe).
Boas práticas
- Use um número dedicado à empresa. Não misture com o celular pessoal de ninguém.
- Tenha modelos de utilidade aprovados antes de precisar: confirmação de pedido, lembrete de pagamento, retomada de conversa.
- Configure o horário de atendimento em Configurações → Organização → Horário de Atendimento. O cálculo de SLA e a opção de só aceitar ligações no horário dependem dele.
- Defina quem atende antes de divulgar o número, para as conversas já caírem na equipe certa.