O que precisa estar pronto
Antes de conectar um número de WhatsApp a um CRM pela API Oficial, a empresa precisa de quatro coisas prontas na Meta: uma conta comercial no business.facebook.com, uma conta do WhatsApp Business (WABA) dentro dela, um número elegível e uma forma de pagamento cadastrada. O requisito que mais trava a conexão é o do número: na conexão comum pela Cloud API, ele não pode estar ativo em nenhum aplicativo do WhatsApp; na coexistência, ele precisa estar — é o caminho para quem não quer perder o aplicativo.
Primeiro decida o caminho: o número muda tudo
Quase todo guia sobre o assunto repete que o número não pode estar ativo em nenhum aplicativo do WhatsApp. Isso vale para a conexão comum pela Cloud API — e deixa de valer na coexistência, que existe exatamente para números que já estão em uso no aplicativo. Escolher o caminho antes de qualquer outra coisa evita o erro mais caro do processo: apagar do WhatsApp o número que a empresa usa há anos.
| Critério | Cloud API (comum) | Coexistência |
|---|---|---|
| O número já está no app WhatsApp Business | Impede a conexão: é preciso apagar o número do WhatsApp antes de registrar | É requisito: a conexão parte do número que já está no aplicativo |
| O app continua funcionando depois | Não: o número migra para a API e sai do aplicativo | Sim: o número funciona nos dois ao mesmo tempo |
| Como o número é ativado | Código recebido por SMS ou chamada, mais um PIN de duas etapas de 6 dígitos | QR Code exibido pela Meta, lido com o aplicativo do celular; sem PIN |
| Histórico das conversas anteriores | Não se aplica: o número entra sem conversas | Últimos 6 meses, se a empresa autorizar no aplicativo |
| Conta comercial, verificação e cartão | Exigidos | Exigidos igualmente: coexistência é um modo de conexão da Cloud API |
Os detalhes de cada caminho estão nas páginas da integração com a API Oficial (Cloud API) e da coexistência (app + Cloud API).
1. A conta comercial no business.facebook.com
É o portfólio empresarial: o lugar onde a empresa reúne os ativos que tem na Meta. Ele é criado em business.facebook.com a partir de um perfil pessoal do Facebook, que passa a ser administrador. Vale cuidar de dois detalhes aqui, porque os dois voltam a aparecer depois:
- Use a razão social exatamente como está no documento da empresa. A verificação do negócio compara o que você digitou com o que está no documento, e divergência de nome é motivo comum de recusa.
- Coloque mais de um administrador. Portfólio com um único acesso vira problema quando essa pessoa sai da empresa ou perde o celular — e recuperar acesso na Meta é lento.
2. A conta do WhatsApp Business (WABA)
Dentro do portfólio, a conta do WhatsApp Business é o contêiner do que importa: os números, os templates que serão aprovados e a cobrança. Uma empresa pode ter mais de uma, mas a maioria opera com uma só. É nela que o cartão é cadastrado e é dela que partem os limites de envio.
3. O número
Este é o passo onde os dois caminhos deixam de ser parecidos. As quatro exigências abaixo estão na mesma ordem nas duas listas, para você comparar linha a linha — e a segunda delas é o oposto exato de um caminho para o outro.
Cloud API comum — o número precisa estar livre
- Titularidade e formato: ser da empresa e ter código de país e de área — códigos curtos não são aceitos.
- Situação no WhatsApp: não pode estar ativo em nenhum aplicativo. Um número já em uso só pode ser registrado depois de ser apagado do WhatsApp — e apagar significa perder as conversas daquele aparelho.
- Como é ativado: por código de confirmação, então o número precisa conseguir receber SMS ou chamada de voz.
- PIN: exige um PIN de duas etapas de 6 dígitos, definido no registro e pedido depois para alterar ou remover o número.
Coexistência — o número precisa estar em uso
- Titularidade e formato: mesma exigência da Cloud API comum, sem diferença.
- Situação no WhatsApp: precisa estar ativo no aplicativo WhatsApp Business, na versão 2.24.17 ou superior. Não se apaga nada, e o aplicativo continua funcionando depois da conexão.
- Como é ativado: lendo com o celular um QR Code exibido pela Meta. Não há código por SMS nem chamada, então um número que não recebe SMS não é impedimento aqui.
- PIN: não se aplica — a coexistência não pede PIN de duas etapas.
Repare no que a segunda linha significa na prática: o mesmo número que impede a conexão pela Cloud API comum é exatamente o que a coexistência exige. Se a empresa atende há anos por um número no aplicativo, ele não é um obstáculo a contornar — é o ponto de partida do caminho certo.
4. A verificação do negócio
A Meta verifica se a empresa existe e se você a representa, analisando os documentos enviados. Dá para começar a testar antes de concluir, mas a conta não verificada opera limitada — em quantos números pode associar e em quantas conversas pode manter por dia. É a verificação que libera a operação de verdade, e ela também conta para recursos como o selo de conta comercial oficial.
O prazo depende da análise da Meta, não do CRM. Por isso vale enviar a verificação cedo, em paralelo ao resto do checklist, em vez de deixá-la para o dia em que a operação precisa entrar no ar.
5. A forma de pagamento
O cartão é cadastrado no Meta Business, nas configurações de pagamento da conta do WhatsApp Business — não dentro do aplicativo do WhatsApp, que é onde muita gente procura. Dois pontos que costumam travar:
- o cartão precisa estar habilitado para compras internacionais, porque a cobrança da plataforma é feita em dólar e convertida na fatura;
- sem forma de pagamento válida, o envio de templates é bloqueado assim que o limite gratuito termina. O sintoma é uma campanha que simplesmente não sai, com erro de pagamento — e não um aviso antes.
Sobre o custo em si: a Meta cobra por mensagem de template entregue, com valor que varia por país e por categoria da mensagem (marketing, utilidade, autenticação e atendimento). As mensagens de atendimento em resposta ao cliente não são cobradas. Os valores mudam periodicamente, então consulte a tabela oficial em vez de qualquer número publicado em blog — este incluído.
6. O nome de exibição
É o nome que o cliente vê na conversa. Passa por aprovação da Meta e precisa ter relação clara com o negócio — nome genérico ou promocional costuma ser recusado. Decida isso antes, com quem cuida da marca: trocar depois é possível, mas passa por nova aprovação.
Os erros que mais atrasam
- Apagar do WhatsApp o número principal da empresa para liberar a conexão, sem saber que a coexistência existia. É o erro irreversível da lista: as conversas daquele aparelho vão junto.
- Divergência entre a razão social digitada e o documento, que reprova a verificação e faz recomeçar a análise.
- Cartão sem função internacional, que passa no cadastro e falha na cobrança, derrubando as campanhas depois.
- Perder o PIN de duas etapas, que só faz falta meses depois, na hora de mexer no número.
- Deixar a verificação para o último dia, tratando como tarefa de minutos um prazo que não está sob seu controle.
Perguntas frequentes
Posso usar o número que minha empresa já usa no WhatsApp Business?
Depende do caminho. Na conexão comum pela Cloud API, não: o número precisa estar livre, e um número já ativo no aplicativo só pode ser registrado depois de ser apagado do WhatsApp. Na coexistência, sim: o número continua funcionando no aplicativo do celular e passa a funcionar também pela Cloud API, sem migração.
Preciso de CNPJ para conectar o WhatsApp pela API Oficial?
A conexão passa por uma conta comercial na Meta, e a verificação do negócio é feita com os documentos da empresa. É possível começar a testar antes de concluir a verificação, mas com limites bem menores de números e de conversas por dia — e é a verificação que libera a operação em escala.
Qual cartão a Meta aceita e onde ele é cadastrado?
O cartão é cadastrado no Meta Business, nas configurações da conta do WhatsApp Business — não dentro do aplicativo do WhatsApp. Ele precisa estar habilitado para compras internacionais, porque a cobrança da plataforma é feita em dólar e convertida na fatura. Sem forma de pagamento válida, o envio de templates é bloqueado assim que o limite gratuito acaba.
Quanto tempo leva para ficar tudo pronto?
A parte que depende só de você — criar a conta comercial, a conta do WhatsApp Business e cadastrar o cartão — leva menos de uma hora. O prazo real é o da verificação do negócio pela Meta, que depende da análise dos documentos enviados e não é controlado por quem contrata o CRM.
O que é o PIN de duas etapas e quando ele é pedido?
É um código de seis dígitos definido no registro do número na Cloud API, exigido depois para alterar o PIN ou remover o número da plataforma. Guarde-o: sem ele, mexer no número exige suporte. Na conexão por coexistência o PIN não é pedido — a ativação é feita lendo um QR Code com o aplicativo do celular.
Na coexistência eu pago pelas mensagens enviadas pelo celular?
Não. As mensagens enviadas pelo aplicativo do WhatsApp Business continuam gratuitas; a cobrança da plataforma incide sobre as mensagens enviadas pela Cloud API, conforme a tabela da Meta. Ou seja, atender pelo celular não gera custo de plataforma.
Com a conta pronta, conectar leva minutos
O Vimel CRM conecta pela API Oficial e também por coexistência, mantendo o aplicativo do celular funcionando. 15 dias grátis, sem fidelidade.
Conhecer o Vimel CRMFontes
- Números de telefone comerciais (Meta): developers.facebook.com — business phone numbers
- Contas do WhatsApp Business e forma de pagamento (Meta): developers.facebook.com — WhatsApp Business Accounts
- Conexão de usuários do app WhatsApp Business, a coexistência (Meta): developers.facebook.com — onboarding business app users
- Preços da Plataforma WhatsApp Business (Meta): developers.facebook.com — pricing
- Diferenças entre os caminhos de conexão: API Oficial (Cloud API) vs QR Code
Transparência: este artigo é mantido pela Vimel Tech, criadora do Vimel CRM. Regras, limites e preços da Meta mudam sem aviso — confirme sempre na documentação oficial antes de decidir.
