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.
- 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.
- In VeyCall, open Integrations › Webhooks, click Add a webhook, paste the address and choose the events.
- 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));
}