WhatsApp (Cloud API)

Conecte números do WhatsApp (via Meta Cloud API) para que as mensagens do WhatsApp virem conversas e sejam atendidas junto com os demais canais, em um só lugar.

Conectar um número

Há duas formas de conectar: o fluxo oficial da Meta (botão Conectar número, quando disponível — sem copiar tokens manualmente) ou a configuração manual abaixo, pela Cloud API.

No botão Conectar número você escolhe entre três caminhos: Já uso esse número no app WhatsApp Business, Número novo ou dedicado à plataforma e Trazer de outro provedor, para o número que já funciona com outra empresa pela API do WhatsApp. Esse último tem um artigo próprio: WhatsApp: trazer o seu número de outro provedor.

  1. Acesse Administração › Configurações › Canais › WhatsApp.
  2. Clique em Novo número (ou em ou configure manualmente, se o botão Conectar número estiver visível) e preencha os dados da Cloud API, passo a passo.
  3. Configure o webhook na Meta com o token e a URL indicados.
  4. No último passo, defina quem atende o número (equipe ou um agente de IA) e deixe-o Ativo.
  5. Clique em Salvar.

Formulário de conexão de número do WhatsApp
Formulário de conexão do número.

Se a conta autorizada tem mais de um número, o painel pergunta quais conectar, com nada marcado — conectar um número não é gesto neutro: ele passa a receber mensagens e entra no roteamento. Com um número só, a conexão termina direto. Números de teste da Meta, que costumam morar na mesma conta, ficam de fora a menos que você os marque.

Assim que o número conecta, dois modelos de mensagem vão sozinhos para a aprovação da Meta: um de utilidade, que permite retomar um atendimento depois das 24 horas, e um de marketing, exigido pelo passo de WhatsApp das automações. Sem eles, essas duas coisas ficam travadas — e descobrir isso sozinho custava dias de espera pela aprovação.

Os campos

  • Nome — um rótulo interno (ex.: Suporte WhatsApp).
  • Identificação na Meta — Phone Number ID, Número exibido e WABA ID (opcional), obtidos no painel da Meta (Cloud API).
  • Webhook — o Token de verificação (gere e cole também na Meta) e a URL de callback (a mesma para todos os números), que recebe as mensagens.
  • Access token (Graph API) — o token permanente usado para enviar as respostas.
  • Marca — opcional, quando a conta tem mais de uma marca cadastrada; vincula as conversas do número a essa marca.
  • Audiência — Externo (clientes) ou Interno (uso da própria equipe).
  • Quem atende — a equipe de atendentes ou um agente de IA, que responde na hora (24h) e transfere quando precisar.
  • Ativo — controla se o número já recebe e envia mensagens assim que você salva.

Como funciona

Depois de conectado, cada mensagem recebida no número abre ou continua uma conversa. As respostas seguem as regras do WhatsApp: dentro da janela de 24h você responde livremente; fora dela, é preciso usar templates aprovados (disponíveis na aba Templates, ao lado dos números conectados).

Mais de um número na conta

Cada número é uma conversa própria. Se a mesma pessoa fala com dois números seus (por exemplo, um de cada marca), ela aparece em duas conversas, uma para cada número, e a resposta, da equipe ou do agente de IA, sai sempre pelo número com que ela falou. Assim ninguém recebe a resposta de um número para o qual não escreveu.

Desativar ou remover um número

Em Administração › Configurações › Canais › WhatsApp, cada número conectado tem duas saídas:

  • Desativar — desmarque Ativo e salve. O número para de receber e de enviar mensagens, mas continua cadastrado, com toda a configuração preservada. É o caminho para uma pausa, ou quando você ainda não tem certeza.
  • Remover — apaga o número da lista. As conversas já registradas continuam no histórico; o que acaba é a entrada de novas mensagens por ele.

Atenção: desativar ou remover aqui não desfaz nada na Meta. O número continua vinculado à sua conta comercial do WhatsApp, com os mesmos templates e permissões — você apenas deixou de atendê-lo por aqui.

Se a intenção é liberar o número de vez — para usá-lo em outro sistema, devolvê-lo ao celular ou encerrar o cadastro — esse passo é feito no painel da Meta (WhatsApp Manager), na conta comercial em que ele foi cadastrado. A ordem recomendada é: primeiro desative ou remova aqui, depois resolva na Meta.

Na conexão não oficial por QR Code é diferente: como não existe cadastro na Meta, ao remover o número a conexão é encerrada de fato e o WhatsApp volta a ficar livre no aparelho.

Dúvidas frequentes

Onde consigo os IDs?
No painel da Meta (WhatsApp / Cloud API), na configuração do número.

A URL de callback muda por número?
Não — é a mesma para todos os números; o que identifica cada um são os IDs e o token.

Existe alguma forma de conectar sem usar a Cloud API oficial da Meta?
Sim, há uma opção de conexão não oficial por QR Code (pareando o WhatsApp do celular), indicada apenas para volumes bem baixos de atendimento — ela não é homologada pela Meta e o número pode ficar indisponível ou ser bloqueado. Prefira sempre a Cloud API oficial.

Como sei se o cliente recebeu e leu a resposta?
Pelos tiques ao lado da hora de cada resposta, na conversa: ✓ enviada, ✓✓ cinza entregue no aparelho e ✓✓ azul lida. Se o cliente desligou a confirmação de leitura no WhatsApp dele, a mensagem fica em entregue. Na conexão não oficial por QR Code aparece só o ✓ de enviada.

Se eu remover o número aqui, ele é excluído na Meta também?
Não. A remoção vale apenas para o atendimento por aqui; na Meta o número segue cadastrado normalmente. Para tirá-lo de lá, use o painel da Meta (WhatsApp Manager). Veja Desativar ou remover um número, acima.