Backend i SDK

Webhooks

Envia esdeveniments de l'app a Zapier, Make, n8n o al teu servidor.

Obre Configuració → Webhooks a l'editor, enganxa l'URL d'un endpoint i desa (pla Starter o superior). A partir d'aquí, builder77 envia un POST amb un cos JSON a cada esdeveniment:

EsdevenimentQuan
record.createdLa teva app ha creat un registre
record.updatedS'ha actualitzat un registre
record.deletedS'ha esborrat un registre
user.signed_upAlgú s'ha registrat a la teva app
test.pingHas fet clic a «Envia un esdeveniment de prova»
{
  "event": "record.created",
  "projectId": "abc123",
  "timestamp": "2026-10-01T10:00:00.000Z",
  "collection": "orders",
  "record": { "id": "…", "total": 42, "createdAt": "…" }
}

Verificar les peticions

Cada petició porta una capçalera X-M77-Signature: l'HMAC-SHA256 en hexadecimal del cos en brut, calculat amb el teu secret de signatura (visible a Configuració).

import crypto from 'node:crypto';
const expected = crypto.createHmac('sha256', process.env.M77_WEBHOOK_SECRET).update(rawBody).digest('hex');
if (expected !== req.headers['x-m77-signature']) return res.status(401).end();

Els webhooks s'entreguen una sola vegada, amb un temps d'espera de 8 segons. Els URL han de ser públics (les adreces de xarxes privades estan bloquejades).