דלג לתוכן
Cyzyra

Webhooks

כשמשהו קורה בחברה, Cyzyra שולחת POST ב-JSON לכתובת שאתה רושם. הגדר ב פלטפורמת API → Webhooks, בחירת האירועים.

מה מגיע

X-Cyzyra-Event cabeçalho

סוג האירוע, למשל. תשלום.שולם

X-Cyzyra-Delivery cabeçalho

המזהה של משלוח זה. השתמש כדי להתעלם מחזרות.

X-Cyzyra-Signature cabeçalho

t=<unix time>,v1=<HMAC-SHA256>

גוּף
{
  "id": "evt_3f9c…",
  "type": "payment.paid",
  "created_at": "2026-11-08T14:02:11Z",
  "data": {
    "entity_type": "payment",
    "entity_id": "a93e…",
    "title": "Pagamento confirmado",
    "object": {
      "id": "a93e…",
      "amount": 1500,
      "currency": "BRL",
      "status": "paid"
    }
  }
}

مثال گویا

אשר מנוי

חשב את HMAC-SHA256 מ <t>.<raw body> עם סוד נקודת הקצה ולהשוות עם v1. Recuse horários muito antigos para evitar reenvio por terceiros.

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

function verify(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const expected = createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  return fresh && timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}

ניסיונות חדשים

השב עם סטטוס 2xx תוך 10 שניות. אם זה נכשל, Cyzyra מנסה שוב עד 5 פעמים, במרווחים הולכים וגדלים, ומציגה כל ניסיון בלוח המחוונים.

אירועים

Lead criadolead.created
Status do lead mudoulead.status_changed
Cadastros unificadoslead.merged
Negociação criadadeal.created
Negociação mudou de etapadeal.stage_changed
Venda ganhadeal.won
Venda perdidadeal.lost
ההצעה נשלחהproposal.sent
ההצעה התקבלהproposal.accepted
Proposta recusadaproposal.rejected
החוזה נשלחcontract.sent
Contrato assinadocontract.signed
נוצר מטעןpayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received