Backend e SDK

Webhooks

Envie eventos da app para Zapier, Make, n8n ou para o seu servidor.

Abra Definições → Webhooks no editor, cole o URL de um endpoint e guarde (plano Starter ou superior). A partir daí, o builder77 envia um POST com corpo JSON em cada evento:

EventoQuando
record.createdA sua app criou um registo
record.updatedUm registo foi atualizado
record.deletedUm registo foi apagado
user.signed_upAlguém se registou na sua app
test.pingClicou em «Enviar evento de teste»
{
  "event": "record.created",
  "projectId": "abc123",
  "timestamp": "2026-10-01T10:00:00.000Z",
  "collection": "orders",
  "record": { "id": "…", "total": 42, "createdAt": "…" }
}

Verificar pedidos

Cada pedido tem um cabeçalho X-M77-Signature: o HMAC-SHA256 em hexadecimal do corpo bruto, calculado com o seu segredo de assinatura (visível nas Definições).

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();

Os webhooks são entregues uma vez, com um tempo limite de 8 segundos. Os URLs têm de ser públicos (os endereços de redes privadas são bloqueados).