Integração CRM
Integrar WhatsApp com Zoho CRM
A ZapZap API é uma API de WhatsApp não oficial baseada em instâncias, cada uma conectada a um número de WhatsApp real. Você provisiona o número, autentica as chamadas com os cabeçalhos x-api-key e x-api-secret sobre a base https://api.zapzapapi.com e passa a enviar mensagens de forma programática. O Zoho CRM não tem envio nativo de WhatsApp por instância, então a ponte é feita pelos Webhooks disparados pelas Regras de Fluxo de Trabalho: quando um registro muda, o Zoho chama a ZapZap API e a mensagem sai pelo seu número. O modelo é pré-pago, R$15 por número ativo por mês, com crédito grátis para você testar antes de colocar em produção.
Por que conectar
O caso mais comum é notificar o lead a cada avanço no funil de vendas. Imagine um pipeline de Negócios com os estágios Qualificação, Proposta Enviada e Fechamento. Quando um vendedor arrasta o card para Proposta Enviada, uma Regra de Fluxo de Trabalho dispara um Webhook para a ZapZap API e o cliente recebe no WhatsApp a confirmação de que a proposta foi enviada, com o link para conferir. O mesmo vale para lembrete de reunião ao marcar uma tarefa, aviso de boas-vindas quando um Lead é criado ou recuperação quando um Negócio fica parado num estágio. Tudo dispara sozinho, direto do movimento natural que o time já faz dentro do Zoho, sem ninguém copiar número e digitar mensagem à mão.
Passo a passo
- 1
Provisione o número na ZapZap API
No painel da ZapZap API, crie uma instância, conecte seu WhatsApp lendo o QR Code e copie as credenciais x-api-key e x-api-secret junto com o ID da instância. Esses dados vão no cabeçalho e na URL do Webhook.
- 2
Abra as Regras de Fluxo de Trabalho no Zoho CRM
Clique no ícone de engrenagem (Configuração) no topo, vá em Automação e depois em Regras de Fluxo de Trabalho. Clique em Criar Regra e escolha o módulo, por exemplo Negócios ou Leads.
- 3
Defina o gatilho de mudança de estágio
Em Quando você quer executar a regra, escolha Editar e marque a condição de campo, por exemplo Fase igual a Proposta Enviada. Assim a regra roda toda vez que o estágio do Negócio for atualizado para esse valor.
- 4
Crie o Webhook como ação instantânea
Em Ações Instantâneas, escolha Webhooks e clique em Novo Webhook. Método POST, URL https://api.zapzapapi.com/api/v1/{instanceId}/send/text, adicione os cabeçalhos x-api-key e x-api-secret e monte o corpo em JSON usando os campos de mesclagem do Zoho para o número e o texto.
- 5
Associe, salve e teste
Vincule o Webhook à regra, salve e mova um Negócio de teste para o estágio configurado. Confirme a entrega no WhatsApp e acompanhe a resposta em Configuração, Webhooks para validar o status 200.
Exemplo
// Exemplo ILUSTRATIVO do corpo enviado pelo Webhook do Zoho para a ZapZap API
// Confirme rota, campos e formato atuais em https://api.zapzapapi.com/llms.txt
POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text
Headers:
x-api-key: SUA_API_KEY
x-api-secret: SEU_API_SECRET
Content-Type: application/json
Body:
{
"number": "5511999999999",
"text": "Ola ${Deals.Contact Name}, sua proposta foi enviada. Qualquer duvida e so responder por aqui."
}Ilustrativo. Os campos e endpoints exatos estão na documentação.
Perguntas frequentes
Preciso da API oficial do WhatsApp para usar com o Zoho CRM?
Não. A ZapZap API é uma API não oficial baseada em instâncias, então você conecta um número de WhatsApp comum lendo o QR Code, sem processo de aprovação de templates. A ponte com o Zoho é feita pelos Webhooks das Regras de Fluxo de Trabalho.
Como faço a mensagem disparar quando o estágio do Negócio muda?
Crie uma Regra de Fluxo de Trabalho no módulo Negócios com gatilho em Editar, condicionando ao campo Fase. Ao registro entrar no estágio escolhido, a regra executa a Ação Instantânea de Webhook que chama a ZapZap API.
Consigo usar os dados do lead na mensagem?
Sim. No corpo do Webhook você usa os campos de mesclagem do Zoho, como nome do contato, número de telefone e valor do Negócio, montando o texto dinamicamente para cada registro que dispara a regra.
Quanto custa e como funciona a cobrança?
O modelo é pré-pago, R$15 por número ativo por mês. Você recebe crédito grátis para testar a integração com o Zoho antes de colocar em produção e só mantém ativos os números que realmente usa.
Onde confirmo o endpoint e os campos exatos da API?
O snippet desta página é ilustrativo. Sempre confira a rota atual, os cabeçalhos de autenticação e o formato do corpo em https://api.zapzapapi.com/llms.txt antes de configurar o Webhook em produção.
Comece com crédito grátis
Crie sua conta, conecte um número em minutos e teste a API com aquecimento e anti-bloqueio. R$15 por número ativo/mês, pré-pago, sem fidelidade.