网络钩子
当公司发生事情时,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