網路鉤子
當公司發生事情時,Cyzyra 會將 JSON 格式的 POST 發送到您註冊的地址。配置於 API 平台 → Webhooks, ,選擇事件。
什麼到達
X-Cyzyra-Event cabeçalho
事件類型,例如已付款
X-Cyzyra-Delivery cabeçalho
本次配送的 id。用於忽略重複。
X-Cyzyra-簽名 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"
}
}
}مثالی مثال۔
確認訂閱
計算 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));
}新的嘗試
在 10 秒內回覆 2xx 狀態。如果失敗,Cyzyra 會再次嘗試最多 5 次,並增加間隔,並在儀表板上顯示每次嘗試。
活動
Lead criado
lead.createdStatus do lead mudou
lead.status_changedCadastros unificados
lead.mergedNegociação criada
deal.createdNegociação mudou de etapa
deal.stage_changedVenda ganha
deal.wonVenda perdida
deal.lost已發送提案
proposal.sent提案被接受
proposal.acceptedProposta recusada
proposal.rejected合約已發送
contract.sentContrato assinado
contract.signed電荷已創建
payment.createdPagamento recebido
payment.paidPagamento falhou
payment.failedPagamento estornado
payment.refundedOrdem de serviço criada
work_order.createdMensagem recebida
message.received