Configuração

Conectar WhatsApp pela Meta Cloud API

Envie e receba WhatsApp direto pela Meta (Cloud API), com o seu próprio número e app, como alternativa ao Twilio. Modelo BYO: o número, a WhatsApp Business Account e o app são seus.

Modelos de mensagem

Depois de 24 horas sem resposta do cliente, o WhatsApp não deixa mais enviar texto livre: para iniciar a conversa de novo é preciso um modelo aprovado. Você cria e gerencia os modelos dentro do CRM, no cartão do WhatsApp em Configurações → Integrações — não precisa ir ao Business Manager da Meta.

Clique em Novo modelo e diga para que serve. O nome técnico já vem preenchido (a Meta só aceita minúsculas, dígitos e sublinhado).
Escolha o idioma e a categoria. Utilidade é para mensagem que o cliente espera, como pedido ou agendamento; Marketing é para oferta. A Meta também revisa a categoria, e a errada é motivo comum de recusa.
Escreva a mensagem. Use {{1}}, {{2}} para o que muda a cada pessoa, numerando em ordem e sem pular.
Preencha um exemplo para cada variável. A Meta exige e recusa o modelo sem eles — ninguém recebe esses valores, servem só para a revisão.
Envie para revisão. O modelo entra como pendente e a Meta costuma aprovar em alguns minutos; a situação aparece na lista.

💡 O CRM confere o nome, a numeração das variáveis e os exemplos que faltam antes de mandar qualquer coisa para a Meta. São as três recusas mais comuns, e a mensagem da Meta para elas não diz o que corrigir.

Conectar em um clique

Se o botão "Conectar WhatsApp" aparecer no alto do cartão, use ele: é o caminho curto. Abre uma janela da Meta, você escolhe (ou cria) a conta do WhatsApp Business e o número, e acabou. Não há app para criar, token para gerar nem nada para colar. Isso funciona porque o SellioCRM é um Tech Provider aprovado pela Meta, então a conexão acontece sob o nosso app em vez de um que você teria de construir.

O número e a conta continuam sendo seus. Você pode desconectar pela Meta a qualquer momento e perdemos o acesso na hora.
Nunca vemos a sua senha do Facebook, e nenhum segredo nosso chega ao seu navegador.
As mensagens seguem cobradas pela Meta na sua própria conta.

💡 Se o botão não aparecer, o caminho de um clique não está habilitado para o seu espaço e a configuração manual abaixo é o caminho. Os dois terminam no mesmo lugar: mesmo envio, mesma caixa de entrada, mesmos modelos.

Configuração manual (app próprio na Meta)

Além do Twilio, você pode enviar e receber WhatsApp direto pela Meta, usando a Cloud API oficial. É uma alternativa: quando esta integração está ativa, o WhatsApp passa a sair pela Meta; o SMS continua pelo Twilio. Modelo BYO ("traga a sua própria conta"): o número, a WhatsApp Business Account (WABA) e o app da Meta são seus, e as mensagens são cobradas na sua conta da Meta, sem custo, margem ou intermediação nossa.

A integração nasce inerte: nada é enviado até você preencher os campos e ativar. O access token e o app secret ficam cifrados no CRM e nunca são exibidos de volta.

Pré-requisitos

Um app na Meta (developers.facebook.com) com o produto WhatsApp adicionado e uma WhatsApp Business Account (WABA).
Um número de WhatsApp registrado na sua WABA e o respectivo Phone Number ID (em WhatsApp > API Setup).
Um access token permanente (recomendado: um System User no Business Manager) e o App secret do app (em Configurações > Básico).
No Sellio, ser administrador para salvar as credenciais e ativar a integração em Configurações → Integrações.

O que você precisa preencher

Phone Number ID: o identificador do seu número de WhatsApp na Meta (é um ID, não o número em si).
WABA ID (opcional): o ID da sua WhatsApp Business Account, útil para gestão e templates.
Graph version: a versão da Graph API a chamar (ex.: v21.0). Em branco usa a padrão.
Verify token: uma string que você escolhe. Ela precisa ser a mesma no CRM e no painel da Meta ao assinar o webhook.
Access token: o token permanente que autoriza o envio (fica cifrado no CRM).
App secret: o segredo do app, usado para verificar a assinatura dos webhooks recebidos (fica cifrado no CRM).

Como configurar

Abra Configurações → Integrações e localize o cartão "WhatsApp (Meta Cloud API)".
Preencha o Phone Number ID, o Verify token (escolha uma string), o Access token e o App secret; o WABA ID e a Graph version são opcionais. Clique em "Salvar credenciais".
Copie a "URL do webhook (Meta)" que aparece. No painel da Meta, em WhatsApp → Configuration → Webhooks, cole essa URL em Callback URL e o mesmo Verify token no campo Verify token.
Ainda na Meta, assine (Subscribe) o campo "messages" para receber mensagens e status.
Volte ao CRM e clique em "Ativar". A partir daí, os envios de WhatsApp usam a Meta.

Como enviar uma mensagem

Abra um Contato ou Lead que tenha telefone (campo Telefone ou Celular).
No quadro "Mensagens (SMS/WhatsApp)", clique em "Enviar SMS/WhatsApp" e escolha o canal WhatsApp.
Confira o número, escreva a mensagem e clique em "Enviar".
A mensagem é registrada no histórico do registro. As respostas do cliente chegam pelo webhook e aparecem no mesmo histórico.

💡 Janela de 24h e templates: fora da janela de 24 horas desde a última mensagem do cliente, a Meta só aceita mensagens de TEMPLATE aprovado. Dentro da janela, texto livre funciona. Crie e aprove seus templates no painel da Meta.

Segurança: o CRM verifica a assinatura X-Hub-Signature-256 de cada webhook recebido usando o seu App secret (chamada não assinada ou com assinatura inválida é rejeitada). Trate o access token e o app secret como secretos: ficam cifrados e nunca são exibidos de volta.

Vários números no mesmo app

Você pode ter mais de um número de WhatsApp na mesma integração (ex.: um número dos EUA como padrão e um número do Brasil para conversas locais). No cartão da integração, adicione-os em "Números adicionais" (Phone Number ID, WABA ID opcional e um rótulo) e salve. Ao iniciar uma conversa, escolha o remetente em "Enviar de"; as respostas pelo Inbox saem automaticamente pelo número em que a conversa chegou. O número principal continua sendo o padrão.

Como testar

Abra um Contato ou Lead com telefone e envie uma mensagem curta de WhatsApp para um número seu.
Confirme que a mensagem chegou ao celular e que ficou registrada no histórico do registro.
Responda do celular e verifique que a resposta aparece no mesmo histórico (isso valida o webhook de entrada).

Solução de problemas

A verificação do webhook falha na Meta: o Verify token do CRM e o do painel da Meta precisam ser idênticos. Confira que a Callback URL é a "URL do webhook (Meta)" mostrada no cartão.
Erro ao enviar: confira o Phone Number ID e o Access token. Um token expirado ou sem permissão de WhatsApp faz a Meta recusar o envio.
WhatsApp não envia fora da janela: use um template aprovado. Texto livre só dentro da janela de 24h.
Não recebo as respostas: no painel da Meta, assine (Subscribe) o campo "messages" e confirme a Callback URL + Verify token.
Webhook rejeitado (403): a assinatura X-Hub-Signature-256 não confere. Reinforme o mesmo App secret no CRM (ele não volta do servidor).
Continua saindo pelo Twilio: a integração da Meta precisa estar "Ativada". Sem ativar, o WhatsApp continua pelo Twilio.

Usar o MESMO número que já está no app WhatsApp Business

Dá para manter o número ativo no aplicativo do celular e conectado ao CRM ao mesmo tempo — a Meta chama isso de coexistência. O vendedor continua respondendo pelo celular como sempre, e cada mensagem que ele envia aparece na conversa do CRM automaticamente. Até seis meses de conversas anteriores são importados na ativação.

A ativação não é feita por você no Gerenciador de Negócios: ela acontece pelo assistente de conexão do CRM, e é confirmada por um código que chega no seu WhatsApp.
O aplicativo continua funcionando normalmente: o que muda é que a conversa também fica registrada aqui, no contato certo.
A importação do histórico tem prazo: a Meta dá 24 horas depois da ativação. Deixe o aplicativo aberto enquanto ela acontece — a tela mostra o progresso.
Se você trocar de celular ou registrar o número de novo, a conexão cai e precisa ser refeita. O CRM avisa quando isso acontece.

💡 O que deixa de funcionar no aplicativo com a coexistência ligada: grupos, chamadas de voz e vídeo, catálogo e pedidos, mensagens de marketing e respostas rápidas do app. As listas de transmissão existentes viram somente leitura. Se algum desses é essencial para você, prefira usar um número dedicado no CRM e deixar o app intocado.

Abrir este artigo dentro do sistema →