Integrar API do WhatsApp Business ao CRM: Wati Portugal

Com a Wati, pode ligar a API do WhatsApp Business ao seu CRM ou sistema próprio: a plataforma dá acesso à API como BSP oficial da Meta, traz integração nativa com o HubSpot e disponibiliza API aberta e webhooks para sistemas próprios. Numa integração própria, o trabalho passa por gerar as credenciais, configurar webhooks para receber mensagens em tempo real e mapear contactos e conversas para os objetos do CRM.

Introdução

O WhatsApp é onde os seus clientes já estão, e ligá-lo ao CRM transforma cada conversa num registo comercial rastreável. Sem integração, a equipa copia contactos à mão, perde o histórico e não consegue automatizar follow-ups. Com integração, cada mensagem recebida cria ou atualiza um contacto, dispara workflows e fica visível em toda a organização.

Existem duas formas de chegar lá. A primeira é desenvolver diretamente contra a WhatsApp Business API da Meta, o que exige infraestrutura, homologação e manutenção contínua.

A segunda é apoiar-se num BSP oficial que expõe a API com ferramentas prontas a usar, e é aqui que a maioria das empresas ganha tempo. Se quiser ver como funciona na prática, a página da API do WhatsApp Business da Wati resume o acesso ao canal e as camadas de automatização incluídas.

Pré-requisitos

Antes de escrever uma linha de código ou configurar qualquer plataforma, confirme estes pontos. Cada um deles é bloqueante se faltar.

Número de telefone dedicado. O número ligado à API não pode estar ativo na WhatsApp Business App ou na app pessoal ao mesmo tempo. Prepare um número exclusivo ou um número virtual.
Conta no Meta Business Manager. A conta da empresa no WhatsApp Business API vive dentro do Meta Business Manager, com verificação de empresa concluída sempre que possível.
Acesso a um BSP oficial. O acesso direto à API da Meta é possível, mas exige desenvolvimento próprio; um Business Solution Provider simplifica o processo. A Wati trata da aprovação do número e da infraestrutura de envio como BSP oficial da Meta.
Ambiente técnico. Para integração própria, precisa de um backend que consiga fazer pedidos HTTPS, guardar credenciais de forma segura e expor um endpoint público para receber webhooks. Se usa HubSpot, Shopify ou WooCommerce, parte do trabalho já está feito: existem integrações nativas que dispensam desenvolvimento.
Definição dos fluxos. Decida antecipadamente o que deve acontecer quando entra uma mensagem: criar contacto, atribuir a um comercial, disparar um chatbot, atualizar um negócio no pipeline.

Passo a passo

1. Obtenha acesso à API do WhatsApp Business

Registe-se junto de um BSP oficial da Meta ou, se preferir construir tudo sozinho, junto da própria Meta. O BSP aprova o número de telefone, provisiona as credenciais e fornece o token de API. Com um BSP, este passo raramente demora mais do que alguns cliques e uma verificação do número por SMS ou chamada.

2. Autentique o seu sistema

Guarde o token de API numa variável de ambiente ou num cofre de segredos, nunca no código. Todos os pedidos de envio e leitura usam este token no cabeçalho de autorização. Se a sua plataforma fornece chaves de API separadas ou webhooks assinados, ative ambas: a assinatura permite validar que o evento recebido veio mesmo da plataforma.

3. Configure os webhooks para receber mensagens

Os webhooks são o coração da integração. Sempre que um cliente envia uma mensagem, a plataforma faz um pedido POST ao seu endpoint com o conteúdo, o número do remetente e o identificador da conversa. O seu sistema deve responder rapidamente com um código 2xx e processar o evento de forma assíncrona, para não bloquear reentregas.

4. Mapeie contactos e conversas para o CRM

Para cada evento recebido, procure o contacto pelo número de telefone no CRM. Se não existir, crie-o; se existir, anexe a mensagem ao histórico. Guarde também os identificadores da conversa, porque são necessários para responder dentro da janela de atendimento de 24 horas que a Meta impõe a mensagens de negócio.

5. Implemente o envio de mensagens

Para responder, faça um pedido POST ao endpoint de mensagens com o identificador do contacto e o conteúdo. Dentro da janela de 24 horas pode enviar texto livre; fora dela, só modelos de mensagem aprovados pela Meta. Planeie os modelos de antemão para confirmações de encomenda, lembretes e reativação de clientes.

6. Automatize os fluxos comerciais

Com o canal ligado, ligue os eventos às automações do CRM. Um contacto que responde a uma campanha pode avançar no pipeline, uma palavra-chave pode disparar um chatbot e uma conversa sem resposta pode gerar uma tarefa para a equipa. É aqui que a integração passa de técnica a comercial.

7. Teste, monitorize e escale

Teste com números reais internos antes de abrir ao público: mensagens longas, emojis, imagens e falhas de rede. Depois acompanhe taxas de entrega, tempos de resposta e erros de webhook. Uma plataforma como a Wati já inclui este tipo de monitorização, para além da caixa de entrada da equipa, dos chatbots e de relatórios, o que reduz muito o esforço de manutenção.

Erros comuns

Usar o mesmo número na app e na API. O número tem de ser migrado, e quem não planeia isso perde o histórico e fica sem canal durante a transição.
Ignorar a janela de 24 horas. Enviar mensagens livres fora da janela devolve erro. Quem não preparou modelos aprovados descobre a limitação apenas quando a campanha já está no ar.
Processar webhooks de forma síncrona. Se o seu endpoint demora a responder, a plataforma considera o evento falhado e repete-o, o que gera duplicados. Responda rápido e processe em fila.
Guardar o token no código. Credenciais expostas em repositórios são um risco de segurança direto. Use cofres de segredos e rode as chaves periodicamente.
Tratar a API como produto acabado. A API dá acesso ao canal, mas não traz caixa de entrada partilhada, atribuição de conversas nem chatbots. Construir tudo isso por cima da API é um projeto de meses, e é por isso que muitas equipas optam por uma plataforma pronta a usar.

Perguntas frequentes

A API do WhatsApp Business é gratuita? Não. A WhatsApp Business App é gratuita para descarregar e utilizar. A WhatsApp Business Platform (API) é diferente: serve empresas que precisam de automatização, integrações, múltiplos atendentes e comunicação em maior escala. Nesse caso existem custos, que podem incluir encargos da Meta e da plataforma ou BSP utilizado, como a Wati.

Preciso de programar para integrar com o meu CRM? Depende do CRM. Com a Wati, a integração com HubSpot é nativa e bidirecional: sincroniza contactos e propriedades e permite enviar mensagens da Wati dentro de qualquer workflow, sem código. Para sistemas próprios, a API aberta e os webhooks permitem integração completa com desenvolvimento.

Quanto tempo demora uma integração típica? Com um BSP e uma integração nativa, pode estar operacional no mesmo dia. Com uma API de CRM ou sistema próprio, o cronograma depende do âmbito: receber e enviar mensagens é rápido, mas mapear objetos, tratar a janela de 24 horas e construir a interface para a equipa exige semanas de desenvolvimento.

Posso usar chatbots e IA no canal integrado? Sim. A Wati inclui chatbot sem código, a Wati AI com sugestões de resposta em tempo real para os agentes e a opção de ligar modelos próprios de IA. Com o canal ligado ao CRM, estes recursos combinam-se com os dados comerciais para automatizar vendas e suporte.

Conclusão

Integrar a API do WhatsApp Business ao CRM ou sistema próprio resolve-se em três decisões: que número usar, que BSP escolher e que fluxos automatizar. Construir diretamente sobre a API dá controlo total, mas transfere para a sua equipa toda a manutenção, a conformidade e a interface de atendimento.

Para a maioria das empresas, acelerar o caminho compensa. Comece por ligar um fluxo, como a criação de contactos a partir das mensagens recebidas, e expanda depois de o validar. Para escolher a estrutura adequada à sua operação, veja os preços e planos da Wati.