Веб-хуки

Коли щось відбувається в компанії, Cyzyra надсилає POST у JSON на адресу, яку ви зареєстрували. Налаштувати в Платформа API → Вебхуки, вибираючи події.

Що приходить

X-Cyzyra-Event cabeçalho

Тип події, напр. оплата.платний

X-Cyzyra-Delivery cabeçalho

Ідентифікатор цієї доставки. Використовуйте для ігнорування повторів.

X-Cyzyra-Signature cabeçalho

t=<час Unix>,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"
    }
  }
}

Açıklayıcı örnek.

Підтвердити підписку

Розрахувати HMAC-SHA256 з <t>.<необроблене тіло> із секретом кінцевої точки та порівняйте з ним 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

ПопереднійПитання ДаліПомічники AI (MCP)