Integracao CRM
Integrar WhatsApp com Pipedrive
O Pipedrive e um CRM de vendas organizado por pipeline, onde cada negocio avanca por etapas ate o fechamento. A integracao com a ZapZap API conecta esse fluxo ao WhatsApp: usando os modulos de Automacoes (Automations) e Webhooks do Pipedrive, cada mudanca de etapa dispara uma requisicao para a ZapZap API, que envia a mensagem pelo seu numero. A ZapZap API e uma API de WhatsApp nao oficial baseada em instancias, com base em https://api.zapzapapi.com e autenticacao por x-api-key e x-api-secret. O modelo e pre-pago, R$15 por numero ativo por mes, com credito gratis para comecar os testes.
Por que conectar
Uma equipe comercial quer que o lead receba um WhatsApp automatico assim que o negocio entra na etapa "Proposta enviada", e outra mensagem quando chega em "Negociacao". Em vez de o vendedor lembrar de escrever manualmente, a Automacao do Pipedrive detecta a mudanca de etapa e chama a ZapZap API, que envia a mensagem certa no momento certo. Isso acelera o follow-up, padroniza a comunicacao e mantem o negocio quente sem trabalho manual repetido.
Passo a passo
- 1
Ative um numero na ZapZap API
No painel da ZapZap API, crie uma instancia, leia o QR Code no WhatsApp do celular para conectar e copie o api_key e o api_secret. Guarde tambem o instanceId, que voce vai usar na URL da requisicao.
- 2
Abra Automacoes no Pipedrive
No Pipedrive, va ate o menu lateral e clique em Automacoes (Automations). Clique em Criar automacao e comece a partir do zero para montar o gatilho e a acao.
- 3
Configure o gatilho de mudanca de etapa
Escolha o gatilho Negocio atualizado (Deal updated) e adicione a condicao Etapa foi alterada para, selecionando a etapa do pipeline que deve disparar o WhatsApp, por exemplo Proposta enviada.
- 4
Adicione a acao de webhook HTTP
Como acao, escolha Enviar requisicao HTTP (webhook). Defina o metodo POST, informe a URL da ZapZap API com o seu instanceId, adicione os headers x-api-key e x-api-secret e monte o corpo JSON com o numero do contato e o texto da mensagem, usando campos do negocio como variaveis.
- 5
Ative e teste com um negocio real
Salve e ative a automacao. Mova um negocio de teste para a etapa configurada e confirme que a mensagem chegou no WhatsApp. Ajuste o texto e as condicoes conforme o funil de vendas.
Exemplo
// Exemplo ILUSTRATIVO da chamada que o Pipedrive faz na acao de webhook.
// Confira rotas e campos reais 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 {{deal.person_name}}, sua proposta foi enviada. Podemos falar?"
}Ilustrativo. Os campos e endpoints exatos estão na documentação.
Perguntas frequentes
Preciso da API oficial do WhatsApp para integrar com o Pipedrive?
Nao. A ZapZap API funciona por instancias de WhatsApp nao oficiais, conectadas via QR Code. Voce nao precisa passar pela aprovacao da API oficial nem cadastrar templates para comecar a disparar mensagens a partir das Automacoes do Pipedrive.
Como o Pipedrive dispara a mensagem quando o negocio muda de etapa?
Voce cria uma Automacao com o gatilho Negocio atualizado e a condicao de etapa alterada. Na acao Enviar requisicao HTTP, o Pipedrive chama a ZapZap API com POST, os headers de autenticacao e o corpo JSON contendo o numero e o texto. A ZapZap API entrega a mensagem pelo seu numero conectado.
Quanto custa manter essa integracao?
A ZapZap API cobra R$15 por numero ativo por mes, no modelo pre-pago, e oferece credito gratis para testar. O custo do Pipedrive depende do plano contratado, ja que a acao de requisicao HTTP nas Automacoes esta disponivel a partir de determinados planos.
Consigo usar dados do negocio no texto da mensagem?
Sim. No corpo da requisicao dentro da Automacao do Pipedrive, voce pode inserir campos do negocio e do contato como variaveis, por exemplo nome do cliente, valor e titulo do negocio, personalizando cada mensagem enviada pela ZapZap API.
Onde vejo a referencia exata dos endpoints da ZapZap API?
A referencia atualizada de endpoints, campos e formatos fica em https://api.zapzapapi.com/llms.txt. Consulte esse arquivo antes de montar o corpo da requisicao para garantir que a rota e os parametros estao corretos.
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.
