WhatsApp Cloud API (oficial)
QR Code (não oficial)
Cloud API (oficial) ✅
Como funciona
Escaneia um QR Code com o celular
Conecta direto pela API oficial da Meta
Estabilidade
Pode cair ou ser bloqueada sem aviso
Estável, com suporte contínuo da Meta
Custo de mensagem
Nenhum
Cobrado pela Meta por mensagem enviada
Templates
Não precisa
Obrigatório para iniciar conversas
Recomendação
Testes ou uso temporário
Uso profissional e contínuo
Conexão via QR Code (não oficial)
Essa é a forma mais simples: basta escanear um QR Code com o celular e o número já aparece no CRM.
⚠️ Atenção: essa modalidade não é oficial e não tem suporte da Meta. A conexão pode ser bloqueada ou descontinuada a qualquer momento, sem aviso prévio e sem recurso. Use com cautela.
→ Passo a passo para conectar via QR Code
Conexão via WhatsApp Cloud API (oficial) ✅
Essa é a forma recomendada. A conexão é feita diretamente com a API oficial do WhatsApp, garantindo estabilidade e suporte contínuo.
O que você precisa antes de começar
-
Um número cadastrado no Meta Business Manager O número de WhatsApp precisa estar vinculado a um portfólio no Meta Business Manager. Não basta ser um número comum — ele precisa estar registrado como número de WhatsApp Business API dentro desse portfólio.
-
Verificação de negócio na Meta (recomendado) Não é obrigatório para começar, mas amplia os limites de envio de mensagem e dá mais credibilidade à conta.
-
Um PIN de 6 dígitos Durante o registro do número na API, a Meta pede a criação de um PIN de verificação em duas etapas. Esse PIN será solicitado no momento da conexão e também caso você precise migrar ou reativar a conta. Guarde-o em um lugar seguro.
🔄 Conexão tradicional vs. Coexistência
Ao conectar um número via WhatsApp Cloud API, você pode escolher entre dois modos:
-
Conexão tradicional (Cloud API oficial): o número passa a operar exclusivamente pela API. Indicado para números novos ou dedicados ao atendimento.
-
Coexistência: conecta um número que já está em uso no app do WhatsApp Business, permitindo continuar usando o app e a API ao mesmo tempo, sem perder o histórico de conversas.
Este guia mostra como fazer a conexão no modo tradicional. Para ver o guia de coexistência, veja este artigo.
Passo a passo
1) Acesse o componente de WhatsApp do seu projeto
2) Selecione a opção "É usuário do WhatsApp Business API? Clique aqui para conectar"
3) Digite o seu PIN de 6 dígitos e clique em Conectar via Meta
Você será redirecionado para o login da Meta. Entre com a conta que tem acesso ao portfólio onde o número está cadastrado.
Pelo fato de a Meta exigir um domínio pré-cadastrado para liberar a conexão com Whatsapp Business, durante essa etapa a URL apresentada no navegador será da própria Skeelo CRM, mesmo para projetos com domínio próprio. Após a autenticação, o usuário será redirecionado de volta para o domínio do seu projeto.
4) Siga o fluxo da Meta e selecione o número que deseja conectar
5) Confirme as informações e clique em Confirmar
6) Pronto! 🎉 Seu número está conectado via API oficial.
Para testar, envie uma mensagem para o número conectado e veja se ela aparece na tela de conversas do CRM.
💡 Já usava a conexão via QR Code? Desconecte o número antigo antes de conectar pela Cloud API. O número só pode estar ativo em um método por vez.
Depois de conectar: Templates de mensagem
Com a API oficial, você não pode iniciar uma conversa enviando qualquer mensagem. Para dar o primeiro contato pelo seu número, é obrigatório usar um Template — uma mensagem pré-cadastrada e aprovada pela Meta.
Se o cliente mandar a primeira mensagem, você pode responder livremente por até 24 horas sem precisar de template.
Como funciona na prática:
1) Crie o template dentro da Skeelo CRM, definindo um atalho (ex: /boas-vindas)
2) A Meta analisa e aprova (ou reprova) o conteúdo — costuma levar algumas horas
3) Após aprovado, use o template digitando /atalho na tela de WhatsApp do CRM
Cobrança por mensagens 💰
Ao contrário da conexão via QR Code, a Cloud API tem custos definidos pela Meta. A cobrança é feita por mensagem enviada, e os valores variam conforme o país do destinatário e a categoria da mensagem.
Ao conectar sua conta da Meta no CRM, você terá a opção de adicionar uma forma de pagamento na Business Suite:
Categorias e preços aproximados
Categoria
Tipo de mensagem
Exemplo
Preço aprox. (USD)
📢 Marketing
Promoções, campanhas, reengajamento
Cupom, oferta, carrinho abandonado
~$0.0625
📦 Utilidade
Transacional (ação do usuário)
Confirmação de pedido, entrega, fatura
~$0.0080
Valores em dólar americano (USD), definidos e cobrados diretamente pela Meta. Consulte a tabela oficial de preços para valores atualizados.
Regras importantes
Regra
O que significa
Cobrança por mensagem
Você paga por template enviado, não por conversa
Baseado no país do destinatário
O preço depende de onde está quem recebe
Janela de 24h
Se o cliente iniciar a conversa, suas respostas são grátis nesse período
Só paga se entregar
Cobrança acontece apenas quando a mensagem é efetivamente entregue
Descontos por volume
Existem faixas de desconto conforme o volume mensal