Como integrar a API oficial do WhatsApp com CRM na prática

Se você já tentou plugar o WhatsApp no seu CRM e travou na primeira tela, o problema quase nunca é o CRM. É entender que a API oficial do WhatsApp não tem app de conversa próprio: ela é um canal que você conecta ao seu sistema por integração. Aprender como integrar a API oficial do WhatsApp com CRM é, na prática, decidir como as mensagens vão entrar e sair do seu funil, quem responde o quê e em que momento cada template aprovado dispara.

Vou te mostrar como isso funciona no dia a dia, com os casos de CRM que mais aparecem por aqui: vendas, suporte e cobrança. E também os pontos que costumam derrubar a integração antes mesmo do primeiro contato com o cliente.

O que muda quando o WhatsApp vira um canal do CRM

No app comum, uma pessoa lê e responde manualmente. Na API oficial, o número passa a ser operado por integração. Isso significa que as mensagens trafegam entre a Meta e o seu CRM por chamadas de API (webhooks para receber, endpoints REST para enviar), ou por uma ferramenta intermediária que já faz esse trabalho, como o Chatwoot.

Na covercut, o cliente não cria app na Meta nem mexe em painel de desenvolvedor. A conexão do número acontece direto pelo fluxo oficial da Meta (Embedded Signup), com suporte a coexistência. O resultado é um número autorizado a enviar e receber mensagens de forma programática, que você aponta para o CRM.

Um detalhe que muda todo o desenho da integração: a janela de 24 horas. Depois que o cliente te manda uma mensagem, você pode responder livremente por 24 horas com qualquer conteúdo. Passou disso, só volta a falar com um template aprovado. Todo fluxo de CRM que você desenhar precisa respeitar essa regra, senão a mensagem simplesmente não sai.

As duas formas de fazer a integração

Existem basicamente dois caminhos, e a escolha depende de quem vai colocar a mão no código.

1. Integração nativa do CRM

Muitos CRMs já têm um conector de WhatsApp Cloud API pronto. Nesse caso, você informa as credenciais do número conectado e o próprio CRM assume o envio de templates, o recebimento de respostas e a associação com contatos e negociações. É o caminho mais rápido quando o CRM que você usa suporta a API oficial de forma nativa.

2. Integração via API e webhooks

Quando você quer controle fino, ou o CRM não tem conector nativo, a rota é conectar por API. Você configura um webhook para receber cada mensagem que chega, e usa os endpoints de envio para responder ou disparar templates. Cada mensagem carrega o número do remetente, que vira a chave para casar o contato dentro do CRM. Ferramentas como o Chatwoot funcionam como ponte: recebem tudo da API oficial e expõem uma interface e uma API mais simples para o seu sistema conversar.

Segundo a covercut, Tech Provider e Business Partner Meta oficial do WhatsApp, a maior parte dos projetos de integração que atendemos combina as duas coisas: uma camada de atendimento para o time humano e chamadas de API para automações disparadas pelo CRM (confirmação de pedido, lembrete de agendamento, atualização de status).

Casos de CRM na prática

Vendas: capturar o lead no momento certo

O cenário mais comum é o lead que preenche um formulário ou clica num anúncio e cai no CRM. Como ele ainda não te mandou mensagem, você está fora da janela de 24 horas. Então o primeiro contato ativo precisa ser um template aprovado, normalmente na categoria utilidade ou marketing, dependendo do conteúdo.

Na prática, o fluxo fica assim: o lead entra no CRM, uma automação dispara um template de boas-vindas com o nome dele preenchido por variável, e no momento em que ele responde, abre a janela de 24 horas. A partir daí o vendedor conversa livremente e o CRM registra cada etapa na negociação. O que mais falha aqui é tentar mandar a primeira mensagem com texto livre em vez de template. A Meta bloqueia, e o time acha que a integração quebrou.

Suporte: histórico unificado e roteamento

No suporte, o valor da integração está em não perder contexto. Cada mensagem recebida via webhook é anexada ao ticket ou ao contato correspondente no CRM. Se o cliente já teve três atendimentos, o atendente vê tudo na mesma tela.

Aqui a janela de 24 horas costuma trabalhar a seu favor: como o cliente iniciou o contato, você responde sem template pelas próximas 24 horas. O cuidado é com respostas fora desse prazo. Se o cliente sumiu por dois dias e você precisa retomar, volta a valer o template. Um bom desenho de CRM marca o horário da última mensagem do cliente e mostra ao atendente se a janela ainda está aberta.

Cobrança e pós-venda: automação com opt-in

Lembretes de fatura, confirmação de pagamento e avisos de renovação são casos clássicos de template na categoria utilidade. O CRM detecta a condição (fatura a vencer, por exemplo) e dispara o template correspondente. Só que existe um pré-requisito inegociável: opt-in. Você precisa do consentimento do cliente para enviar mensagens ativas fora da janela. Registrar esse consentimento dentro do CRM, com data e origem, evita reclamação e protege a qualidade do número.

Coexistência: usar o celular e o CRM no mesmo número

Muita gente adia a integração com medo de perder o histórico ou o número que já usa no celular. Não precisa. Um número que já está no app WhatsApp Business pode ser conectado à API oficial em modo de coexistência. Você não apaga a conta, não desinstala o app e não perde as conversas.

Na prática isso significa que o vendedor continua respondendo pelo celular quando quiser, enquanto o CRM opera o mesmo número por API. E na coexistência as conversas iniciadas pelo próprio celular não têm custo. É a transição mais tranquila para quem tem um time acostumado com o app e quer trazer a automação do CRM sem ruptura.

Quem paga o quê nessa história

Essa parte confunde bastante, então vale deixar claro. A cobrança das mensagens é feita pela Meta, por conversa (não por mensagem individual), direto no cartão que o cliente cadastra na conta da Meta. A covercut não cobra por mensagem, conversa ou template, e não tem linha de crédito com a Meta.

O que a covercut cobra é uma mensalidade fixa pelo serviço: a plataforma, a conexão do número pelo fluxo oficial com coexistência, a infraestrutura e o suporte. A integração com o seu CRM entra nesse pacote de serviço. A conta das conversas continua sendo entre você e a Meta.

O que checar antes de ligar o CRM

Antes de sair disparando, três verificações economizam dor de cabeça:

• Templates aprovados: todo envio ativo depende de um modelo já aprovado pela Meta. Cadastre e aguarde a aprovação com antecedência. Quando um cliente nos procura com template rejeitado, quase sempre é por categoria errada (marketing disfarçado de utilidade) ou variável mal formatada.
• Qualidade do número: a Meta classifica o número como alta, média ou baixa. Disparo em massa sem opt-in, texto de spam ou muitos bloqueios derrubam essa nota e podem restringir o número. A qualidade influencia diretamente os limites diários de conversas iniciadas pela empresa, que sobem conforme volume, qualidade e verificação.
• Verificação da empresa: concluir a Business Verification no Gerenciador de Negócios ajuda a elevar os limites e libera mais folga para o CRM operar.

O próximo passo concreto: mapeie no seu CRM quais eventos deveriam gerar uma mensagem (novo lead, ticket aberto, fatura a vencer) e separe o que é resposta dentro da janela de 24 horas do que precisa de template. Com esse mapa em mãos, a conexão técnica é a parte mais simples do processo.

Perguntas frequentes

Preciso saber programar para integrar o WhatsApp ao meu CRM?

Depende do caminho. Se o seu CRM tem conector nativo para a API oficial, basta configurar as credenciais do número conectado. Se não tem, a integração por API e webhooks exige alguém técnico, ou o uso de uma ferramenta intermediária como o Chatwoot para simplificar. Na covercut, a conexão do número pelo fluxo oficial já vem pronta, sem você criar app na Meta.

Consigo continuar usando o WhatsApp no celular depois de integrar com o CRM?

Sim, com a coexistência. O mesmo número funciona no app do celular e na API oficial ao mesmo tempo, sem apagar conta nem perder histórico. As conversas iniciadas pelo celular na coexistência não têm custo.

Por que minha primeira mensagem para um lead novo não é enviada?

Porque o lead ainda não te mandou mensagem, então você está fora da janela de 24 horas. Nesse caso, só um template aprovado pela Meta é entregue. Texto livre para um contato que não iniciou a conversa é bloqueado. Configure o CRM para disparar um template nesse primeiro contato.

Quem paga pelas mensagens enviadas pelo CRM?

A Meta cobra por conversa, diretamente no cartão que o cliente cadastra na conta dele. A covercut não cobra por mensagem, conversa ou template. O serviço da covercut é uma mensalidade fixa pela plataforma, conexão e suporte.

A integração afeta o limite de mensagens que posso enviar?

O limite diário de conversas iniciadas pela empresa não depende da integração em si, mas da qualidade do número, do volume e da verificação da empresa. Manter opt-in em dia, evitar spam e concluir a Business Verification ajuda a elevar esses patamares com o tempo.