Menu de la documentation

DocumentationProspects et intégrations

Webhooks : Make, Zapier, n8n

Envoyez prospects et conversations de VeyCall vers Make, Zapier, n8n ou votre serveur avec des webhooks signés : événements, contenu, nouvelles tentatives.

Les webhooks envoient vos prospects et conversations vers vos autres outils, au moment où ils arrivent. Avec l'activation API et webhooks.

  1. Dans Make, créez un scénario qui commence par Webhooks › Custom webhook. Dans Zapier, un Zap qui commence par Webhooks by Zapier › Catch Hook. Dans n8n, un nœud Webhook (POST). Copiez son adresse.
  2. Dans VeyCall, ouvrez Intégrations › Webhooks, cliquez sur Ajouter un webhook, collez l'adresse et choisissez les événements.
  3. Cliquez sur Envoyer un test : votre outil reçoit un exemple de prospect pour configurer la suite (Google Sheets, CRM, Slack, e-mail…).

Événements disponibles :

  • lead.created : un nouveau prospect (conversation sur votre site, appel manqué Onoff, ajout manuel).
  • lead.updated : statut, priorité ou notes modifiés.
  • conversation.ended : une conversation terminée, avec sa transcription. Les tests du studio vocal ne sont pas envoyés.

Chaque envoi est un POST JSON : { id, type, created_at, organization_id, data }. En cas d'échec, VeyCall réessaie 5 fois sur environ 2 heures et 40 minutes, et désactive le webhook après 20 échecs d'affilée. L'historique des envois est visible dans le tableau de bord.

Pour vérifier qu'un envoi vient bien de VeyCall, recalculez la signature avec le secret affiché à la création du webhook. L'en-tête x-veycall-signature vaut v1= suivi du HMAC-SHA256 hexadécimal de horodatage.corps, l'horodatage étant dans 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));
}