Webhook
Quando succede qualcosa in azienda, Cyzyra invia un POST in JSON all'indirizzo che hai registrato. Configura in Piattaforma API → Webhook, scegliendo gli eventi.
Cosa arriva
X-Cyzyra-Event cabeçalho
Il tipo di evento, ad es. pagamento.pagato
X-Cyzyra-Delivery cabeçalho
L'ID di questa consegna. Utilizzare per ignorare le ripetizioni.
Firma X-Cyzyra cabeçalho
t=<ora UNIX>,v1=<HMAC-SHA256>
Corpo
{
"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"
}
}
}Anschauliches Beispiel.
Conferma l'iscrizione
Calcola HMAC-SHA256 da <t>.<corpo grezzo> con il segreto dell'endpoint e confrontare con 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));
}Nuovi tentativi
Rispondi con uno stato 2xx entro 10 secondi. Se fallisce, Cyzyra riprova fino a 5 volte, con intervalli crescenti, e visualizza ogni tentativo sulla dashboard.
Eventi
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.lostProposta inviata
proposal.sentProposta accettata
proposal.acceptedProposta recusada
proposal.rejectedContratto inviato
contract.sentContrato assinado
contract.signedAddebito creato
payment.createdPagamento recebido
payment.paidPagamento falhou
payment.failedPagamento estornado
payment.refundedOrdem de serviço criada
work_order.createdMensagem recebida
message.received