Módulo de webhook do Make.com

Conecte eventos do Zenovay a cenários do Make.com (antigo Integromat) — integre com Google Sheets, Airtable, HubSpot, Microsoft 365, Salesforce e mais de 1500 outros apps.

O módulo Webhooks → Custom webhook do Make.com é o que captura os eventos do Zenovay.

---

1. Criar o webhook do Make.com

1. No Make.com, crie um novo cenário.
2. Clique no botão + → pesquise "Webhooks" → selecione Webhooks → Custom webhook.
3. Clique em Add para criar um novo hook:
   • Webhook name: Eventos Zenovay (ou qualquer nome memorável)
   • IP restrictions: deixe vazio a menos que queira bloquear por IPs do Zenovay (não publicamos uma lista de IPs estáveis — verifique via assinatura)
   • JSON pass-through: deixe desligado (o Make.com fará o parse do body automaticamente)
4. Clique em Save e em Copy address to clipboard — ficará com o formato https://hook.eu2.make.com/abcdef123456.

---

2. Adicionar o webhook no Zenovay

1. Em app.zenovay.com, acesse Settings → Webhooks.
2. Escolha o site que deve disparar os eventos.
3. Clique em Add webhook.
4. Preencha:
   • Name: Make.com — <nome do cenário> (ex: Make.com — Sincronizar com Google Sheets)
   • URL: cole o endereço do webhook do Make.com do Passo 1
   • Events: escolha os eventos que o cenário deve processar
5. Clique em Create webhook.
6. Clique em Send test event (ícone de avião de papel).

---

3. Capturar os dados de exemplo no Make.com

1. De volta no módulo de webhook do Make.com, clique em Run once na parte inferior.
2. O Make.com aguarda o próximo evento recebido. Clique em Send test event no Zenovay novamente.
3. O Make.com captura o payload e exibe os campos disponíveis. Clique em Save.
4. Adicione os próximos módulos — ex: Google Sheets → Add a Row — e mapeie os campos do payload do Zenovay.

---

4. Verificar a assinatura do Zenovay (recomendado)

O Make.com NÃO verifica assinaturas HMAC nativamente. Para cenários onde a integridade da assinatura importa, adicione um módulo Tools → Set Variables com este filtro:

// Em um "Filter" entre o webhook e seus módulos de ação
{{contains(headers["x-zenovay-signature"]; "sha256=")}}

Para verificação HMAC completa, você precisaria:

1. Fazer upgrade para um módulo com código personalizado (plano Premium/Pro do Make.com), ou
2. Colocar um Cloudflare Worker na frente do Make.com que verifique e encaminhe:

import { createHmac } from 'crypto';

export default {
  async fetch(req) {
    const rawBody = await req.text();
    const signature = req.headers.get('x-zenovay-signature') || '';
    const provided = signature.replace(/^sha256=/, '');
    const expected = createHmac('sha256', YOUR_WEBHOOK_SECRET)
      .update(rawBody)
      .digest('hex');

    if (provided !== expected) return new Response('invalid signature', { status: 401 });

    await fetch(MAKE_WEBHOOK_URL, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: rawBody,
    });
    return new Response('ok');
  },
};

Seu segredo do webhook é exibido em Settings → Webhooks → clique no ícone de olho no cartão do webhook.

---

5. Receitas comuns de cenários

---

Solução de problemas

• Webhook recebeu os dados, mas o cenário não executou: o cenário precisa estar ativo (toggle no canto inferior esquerdo do editor de cenários).
• Tipos de campos incorretos (ex: um número chega como texto): desative JSON pass-through no módulo de webhook para que o Make.com faça o parse dos tipos automaticamente.
• Limite de operações atingido: o Make.com conta cada etapa do cenário como uma operação. Plano gratuito = 1.000/mês. Filtre eventos frequentes (como traffic_spike) na configuração do webhook do Zenovay para ficar dentro do limite.

---

Relacionados

• Receita de catch-hook do Zapier
• Receita de trigger de webhook n8n
• Referência de webhooks e esquema de payload