Conectar CRM ou ferramenta externa via Webhook
a evob não tem integração nativa com CRMs (RD Station, HubSpot, Salesforce, Pipedrive) nem com ferramentas como Mailchimp, ActiveCampaign, Zapier — todos conectam via Webhook ou API REST, que é o padrão da plataforma.
O que é Webhook
Um webhook é uma "chamada automática" que a evob faz quando algo acontece. Você cadastra uma URL — quando o evento dispara, a evob envia um POST com os dados.
``` Aluno compra na evob ↓ evob envia POST → https://sua-url-de-webhook.com ↓ sistema externo processa (CRM, automação, planilha…) ```
💡 Webhook é universal. Funciona com qualquer sistema que aceite receber dados HTTP — RD Station, Salesforce, Zapier, n8n, Make, ou um endpoint próprio.
📖 Saiba mais: Webhooks (em produção)
Como configurar (na evob)
Plataforma > Configurações > Webhooks > + Novo webhookCampos:
| Campo | O que é | |---|---| | URL de destino | Endereço que receberá o POST | | Eventos | Quais eventos disparam (lista abaixo) | | Headers | Cabeçalhos custom (ex: token de autenticação) | | Secret HMAC | Chave para assinatura (verificação no destino) | | Status | Ativo / Pausado |
Eventos disponíveis
A evob dispara webhook nos eventos:
- `student.created` — cadastro
- `student.updated` — atualização de perfil
- `enrollment.created` — matrícula
- `enrollment.cancelled` — cancelamento
- `purchase.completed` — compra aprovada
- `purchase.refunded` — reembolso
- `course.completed` — aluno concluiu curso
- `nps.answered` — NPS respondido
- `comment.posted` — comentário em aula
📖 Saiba mais: Eventos disponíveis (em produção)
Estrutura do payload
Exemplo (`purchase.completed`):
```json { "event": "purchase.completed", "timestamp": "2026-05-02T14:30:00-03:00", "data": { "transaction_id": "tx-12345", "student": { "id": 123, "name": "Maria Silva", "email": "maria@email.com", "phone": "+5511999999999" }, "course": { "id": 45, "name": "Curso de Marketing" }, "value": 297.00, "currency": "BRL", "payment_method": "pix" } } ```
Onde isso ajuda
CRMs
- RD Station, HubSpot, Salesforce, Pipedrive
- Cada um tem sua API de entrada (endpoint para receber lead/contato)
- Aponte o webhook da evob para esse endpoint OU use uma ponte (Zapier, Make, n8n) que recebe o webhook e formata para o CRM
Email marketing
- Mailchimp, ActiveCampaign, Brevo, ConvertKit
- Mesma lógica: cada um tem API de entrada de contato
- Webhook da evob → API do email mkt (direto ou via ponte)
Automação no-code
- Zapier, Make (ex-Integromat), n8n, Pluga
- Funcionam como "tradutor": recebem o webhook da evob e disparam ação em qualquer outro sistema
Planilhas e bancos
- Google Sheets, Airtable, Notion
- Webhook → Apps Script ou API → linha nova/registro
Não vamos ensinar passo a passo de cada CRM
Cada CRM tem dezenas de campos custom, autenticação própria, particularidades de pipeline. Documentação específica vira imprecisa rápido quando o CRM muda interface.
Em vez disso, este artigo entrega:- ✅ O que a evob envia (eventos + payload)
- ✅ Como configurar webhook na evob
- ✅ Padrões de segurança (HMAC, headers)
- RD Station: API de Eventos
- HubSpot: Webhooks API
- Salesforce: Inbound message via Apex / Flow / Connected App
- Pipedrive: Webhooks API
- Zapier: Trigger "Webhook by Zapier" (mais simples)
- Make: Trigger "Custom Webhook"
Caminho mais simples — Zapier ou Make
Se você não tem time técnico, use Zapier ou Make como ponte:
``` evob → webhook → Zapier/Make → seu CRM ```
Zapier tem trigger "Webhook by Zapier" que recebe o POST da evob, e centenas de actions para CRMs/email mkt.
```
- Crie zap "Webhook by Zapier" → copie a URL gerada
- Cole na evob como destino do webhook
- Configure action no Zapier: "Add contact to RD Station" (ou outro)
- Mapeie os campos
Sem programar. Custa o plano do Zapier ($20/mês) + nenhum dev.
Segurança — HMAC
Para verificar que o webhook é legítimo (veio da evob, não de atacante):
```
- evob assina o payload com HMAC-SHA256 + secret
- Header `X-Evob-Signature: sha256=abc123...`
- Seu sistema recalcula com mesmo secret
- Se bate → autêntico
📖 Saiba mais: Assinatura HMAC (em produção)
Retry automático
Se o destino retornar erro (5xx, timeout):
- evob tenta de novo após 30s
- depois 5min, 30min, 2h, 6h, 24h
- após 6 tentativas, marca como falha e notifica admin
📖 Saiba mais: Retry e fallback (em produção)
Logs e debug
Em Plataforma > Webhooks > [webhook] > Logs:
``` Data | Evento | Status | Tempo 02/05 14:30 | purchase.completed | 200 | 240ms 02/05 14:31 | enrollment.created | 500 | timeout (retry agendado) ```
Veja:
- ✅ Eventos enviados
- ✅ Status HTTP recebido
- ✅ Payload enviado (debug)
- ✅ Resposta do destino
Boas práticas
✅ Faça
- HMAC sempre (segurança)
- Use Zapier/Make se sem time técnico
- 1 webhook por destino (não mistura)
- Monitore logs semanalmente
- Documente quais webhooks existem
❌ Não faça
- ❌ Webhook sem assinatura (vulnerável)
- ❌ Endpoint sem retry no destino
- ❌ Payload em URL (use POST body)
- ❌ Esquecer de desativar webhook de teste depois
Erros comuns
"Webhook não chega ao destino"
- URL errada ou destino fora do ar
- Firewall bloqueando IP da evob
- Veja Logs na evob para detalhes
"Recebo o webhook mas não consigo processar"
- Estrutura do payload diferente do esperado? Veja payload exemplo acima
- Campo faltando? Pode ser nulo (ex: telefone)
- Use Zapier/Make como tradutor
"Quer integração com X (Mailchimp, AC, RD, HubSpot…)"
A evob não tem nativa. Caminhos:
- Zapier/Make como ponte (mais rápido)
- Webhook direto para a API de entrada do destino (precisa dev)
- API REST da evob (puxar dados sob demanda) — para casos onde push não basta
📖 Saiba mais: API REST (em produção)
"Posso testar webhook antes de produção?"
Sim. Use:
- webhook.site — URL de teste que mostra payloads recebidos
- requestbin.com — similar
- Modo Sandbox da evob (separa eventos de teste de produção)
"Webhook envia 100 eventos por dia, vou estourar quota Zapier"
Cada evento = 1 task no Zapier. Se volume é alto:
- Filtre eventos na evob (só `purchase.completed`, não todos)
- Filtre no Zapier antes da action
- Suba plano Zapier ou troque por Make (cota maior por preço similar)
Próximos passos
- 📖 Google Tag Manager
- 📖 Meta Pixel
- 📖 Google Analytics 4
- 📖 Webhooks (em produção)
- 📖 API REST (em produção)
Foi útil este artigo? 👍 👎 Falar com CS (em produção) · Pergunte ao Vob 🤖 (em produção) Última atualização: 2026-05-02