Documentation menu

DocumentationLeads and integrations

Webhooks: Make, Zapier, n8n

Send leads and conversations from VeyCall to Make, Zapier, n8n or your own server with signed webhooks: events, payload, retries and checks.

Webhooks send your leads and conversations to your other tools the moment they come in. With the API and webhooks activation.

  1. In Make, create a scenario that starts with Webhooks › Custom webhook. In Zapier, a Zap that starts with Webhooks by Zapier › Catch Hook. In n8n, a Webhook node (POST). Copy its address.
  2. In VeyCall, open Integrations › Webhooks, click Add a webhook, paste the address and choose the events.
  3. Click Send test: your tool receives a sample lead so you can set up the next steps (Google Sheets, CRM, Slack, email…).

Events:

  • lead.created: a new lead (a conversation on your website, an Onoff missed call, or added by hand).
  • lead.updated: status, priority or notes changed.
  • conversation.ended: a finished conversation, with its transcript. Voice studio tests aren't sent.

Each delivery is a JSON POST: { id, type, created_at, organization_id, data }. If it fails, VeyCall retries 5 times over about 2 hours and 40 minutes, and turns the webhook off after 20 failures in a row. The delivery history is in your dashboard.

To check a delivery really comes from VeyCall, compute the signature with the secret shown when you created the webhook. The x-veycall-signature header is v1= followed by the hex HMAC-SHA256 of timestamp.body, with the timestamp in x-veycall-timestamp:

import { createHmac, timingSafeEqual } from "node:crypto";

// raw = the request body exactly as received (a string)
function isFromVeyCall(headers, raw, secret) {
  const timestamp = headers["x-veycall-timestamp"];
  const expected = "v1=" + createHmac("sha256", secret)
    .update(`${timestamp}.${raw}`).digest("hex");
  const given = headers["x-veycall-signature"] ?? "";
  const fresh = Math.abs(Date.now() / 1000 - Number(timestamp)) < 300;
  return fresh && given.length === expected.length &&
    timingSafeEqual(Buffer.from(given), Buffer.from(expected));
}