Esdeveniments · Esdeveniments de servei dels webhooks
webhook.endpoint_disabled
Webhook desactivat
Un webhook s’ha posat en pausa després d’errors repetits o s’ha desactivat (data.state: paused | disabled; data.reason: failures | gone | manual | feature_disabled).
- Tipus d’objecte
- webhook
- Es lliura a
- Webhooks amb el rol admin
Càrrega útil
Objecte: EventWebhookEndpointDisabled
idstringobligatoriID de l’esdeveniment (
evt_…), que també s’envia com a capçalerawebhook-id. Feu-lo servir per descartar els lliuraments duplicats.typestringobligatoriValors permesos:
webhook.endpoint_disabledcreated_atstring (date-time)obligatoriMoment en què es va produir el canvi (UTC).
org_idintegerobligatoriapi_versionstringobligatoriVersió del contracte de l’esquema de
data.sequenceintegerNúmero de seqüència del lliurament dins del webhook (no hi és en un esdeveniment de prova).
payloadstringobligatorithinvol dir sensedata: llegiu l’objecte a través de l’API.Valors permesos:
fullthindataobjectCamps
endpoint_idintegerobligatoristatestringobligatoripausedodisabled.reasonstringobligatorifailures,gone,manualofeature_disabled.
testbooleanobligatoriEsdeveniment de prova enviat per
POST /v1/webhooks/{webhook_id}/test.
Exemple de lliurament
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "webhook.endpoint_disabled",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "webhook",
"id": "4"
},
"payload": "full",
"data": {
"endpoint_id": 4,
"state": "paused",
"reason": "failures"
},
"test": false
}Recepció d’esdeveniments
Cada lliurament és una sol·licitud POST amb aquest cos JSON a l’URL del vostre webhook. Verifiqueu la capçalera webhook-signature (Standard Webhooks) abans de confiar en el cos, responeu amb un estat 2xx en pocs segons i feu la feina després. Els lliuraments a un mateix webhook mantenen l’ordre dels esdeveniments; un lliurament fallit es reintenta amb pauses cada vegada més llargues.
En qualsevol moment poden aparèixer tipus d’esdeveniment i camps nous: ometeu els tipus i els camps que no conegueu.
Els mateixos esdeveniments són al canal d’esdeveniments durant 30 dies →