Integração CRM
Integrar WhatsApp com HubSpot
O HubSpot é uma plataforma de CRM e automação de marketing que centraliza contatos, negócios e todo o histórico de relacionamento em um só lugar. Seu módulo de Workflows permite criar automações visuais que reagem a eventos do funil: quando um contato entra em determinado estágio de ciclo de vida, quando um negócio avança de etapa ou quando uma propriedade muda de valor. É onde equipes de marketing e vendas orquestram nutrição de leads, follow-ups e handoffs sem escrever código.
Por que conectar
O HubSpot é ótimo para organizar o funil, mas e-mail tem taxa de abertura baixa e resposta lenta. Conectar a ZapZap API traz o WhatsApp para dentro dos Workflows: assim que um lead entra no estágio "Lead qualificado" ou um negócio passa para "Reunião agendada", o HubSpot dispara automaticamente uma mensagem no WhatsApp do contato. Você deixa de depender do vendedor lembrar de mandar o "oi" e passa a acionar a conversa no canal onde a resposta chega em minutos. Como a ZapZap usa instâncias gerenciadas com aquecimento em comunidade e anti-bloqueio, o volume de disparos automatizados sai com risco reduzido de restrição do número.
Passo a passo
- 1
Ative um número na ZapZap API
Crie a instância no painel da ZapZap, conecte o WhatsApp lendo o QR Code e copie o x-api-key e o x-api-secret dessa instância. É por eles que o HubSpot vai autenticar cada envio. O número custa R$15 por mês, pré-pago, com crédito grátis para testar.
- 2
Crie o Workflow no HubSpot
No menu superior vá em Automations > Workflows e clique em Create workflow > From scratch. Escolha o tipo Contact-based (para gatilhos de contato) ou Deal-based (para gatilhos de negócio), conforme o evento que deve disparar o WhatsApp.
- 3
Defina o gatilho de inscrição
Em Set enrollment triggers, escolha a condição do evento. Exemplos reais: 'Lifecycle stage is any of Lead', 'Deal stage is Reunião agendada' ou 'Contact property [Telefone] is known'. Garanta que o contato tenha um número de celular preenchido em uma propriedade, pois ele vai no corpo da requisição.
- 4
Adicione a ação Send a webhook
Clique no + para adicionar uma ação e selecione Send a webhook. Defina o Method como POST e a URL de destino. Como a ZapZap exige os headers x-api-key e x-api-secret, aponte para um endpoint intermediário seu (um webhook relay, um Worker ou um cenário no Make) que recebe o payload do HubSpot, anexa os dois headers e repassa para https://api.zapzapapi.com. Use tokens de propriedade do HubSpot (ex: contact.phone) para injetar o número no corpo.
- 5
Teste e publique
Use Review and publish, depois inscreva um contato de teste que atenda ao gatilho e confira se a mensagem chegou no WhatsApp. Acompanhe cada execução na aba Enrollment history do próprio Workflow para validar status e reprocessar falhas. Os nomes exatos de rotas e campos da ZapZap estão na doc em https://api.zapzapapi.com/llms.txt.
Exemplo
// Exemplo ILUSTRATIVO do envio que seu relay faz para a ZapZap API.
// Os nomes exatos de rota e campos estão 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": "Oi {{contact.firstname}}, vi que voce avancou por aqui. Posso te ajudar?"
}Ilustrativo. Os campos e endpoints exatos estão na documentação.
Perguntas frequentes
Preciso da API oficial do WhatsApp (Cloud API) para integrar com o HubSpot?
Não. A ZapZap API funciona com instâncias gerenciadas do WhatsApp não oficial, então você não precisa aprovar templates na Meta nem passar por verificação de negócio. Basta conectar um número lendo o QR Code e usar os headers x-api-key e x-api-secret nas requisições que o HubSpot dispara.
A ação Send a webhook do HubSpot deixa eu colocar os headers de autenticação?
A ação nativa Send a webhook envia o payload do registro, mas nem todos os planos permitem headers customizados direto. O caminho recomendado é apontar o webhook para um endpoint intermediário seu (um relay simples, um Cloudflare Worker ou um cenário no Make), que recebe os dados do HubSpot, adiciona x-api-key e x-api-secret e repassa para a ZapZap API.
Consigo usar dados do contato ou do negócio dentro da mensagem?
Sim. Dentro do Workflow você usa personalization tokens do HubSpot, como o nome, a empresa ou o estágio do negócio, e injeta esses valores no corpo da requisição. A mensagem chega personalizada para cada contato inscrito no Workflow.
Disparar em massa pelo HubSpot bloqueia meu número?
Volume alto de automação sempre tem risco. A ZapZap trabalha com aquecimento do número em comunidade e recursos de anti-bloqueio para reduzir o risco de restrição. Ainda assim, use intervalos entre mensagens, mande conteúdo relevante e evite disparar para listas frias grandes de uma vez.
Como recebo a resposta do contato de volta no HubSpot?
A ZapZap API envia webhooks por evento quando chega uma mensagem. Você configura essa URL de callback para um endpoint seu que atualiza o contato ou cria uma nota via API do HubSpot. Assim a conversa do WhatsApp fica registrada no CRM. Os eventos disponíveis estão documentados em https://api.zapzapapi.com/llms.txt.
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.