POST firmados con cuerpo JSON.
Para gestionar suscripciones programáticamente (crear, listar, eliminar), ver la Referencia API de webhooks. Esta página cubre lo que tu receptor necesita hacer una vez creada la suscripción.
Headers
Cada entrega incluye:Body
data depende del evento:
- Eventos
lead.*llevandata.lead. - Eventos
project.*llevandata.project. - Eventos
unit.*llevandata.unitydata.project. lead.note_addedllevadata.leadIdydata.note.lead.communication_loggedllevadata.leadIdydata.communication.
Verificar la firma
Verifica siempre la firma antes de confiar en un payload. Cualquiera que conozca tu URL puede pegarle; solo FlowEstate tiene el secret.POST /webhooks/subscriptions y se muestra solo una vez. Si lo pierdes, elimina la suscripción y crea una nueva.
Acuse de recibo
Devuelve cualquier status2xx para acusar recibo. FlowEstate no lee el cuerpo de la respuesta — un 200 vacío está bien.
Si tu handler hace trabajo pesado (llama otros APIs, escribe a una BD lenta), acusa primero, procesa después:
Política de reintentos
Las entregas fallidas (error de red, timeout, o HTTP≥ 400) se reintentan con este backoff:
Después de cinco intentos fallidos la entrega se marca como
failed y no se reintenta más. El header X-FlowEstate-Delivery se mantiene constante a través de los reintentos — úsalo como tu clave de idempotencia al procesar.
De dónde vienen los eventos de leads
Un lead puede entrar a FlowEstate por varias puertas, yX-FlowEstate-Source te dice por cuál entró:
lead.assigned también se dispara cuando se rutea un contacto repetido. Publicar un contacto que ya existe fusiona sobre el lead existente (Deduplicación y fusión), y si ese lead todavía no tenía dueño, el round robin se lo asigna — así que una fusión puede producir un lead.assigned sin un lead.created que lo preceda. Tratá los dos eventos como independientes.
Una fusión no emite lead.updated. El enriquecimiento es silencioso hoy en todos los canales.
Cupo mensual de eventos
Las entregas salientes se miden por mes calendario y por organización:
Un evento distribuido a tres endpoints cuenta como tres entregas.
Prevención de bucles
Cuando escribes a FlowEstate vía este API REST, el webhook resultante se distribuye conX-FlowEstate-Source: api. Si tu receptor también escribe de vuelta a FlowEstate, descarta los eventos con source api para evitar un bucle infinito.
ui— cambio hecho por un usuario en el panel de FlowEstate, incluida la importación masiva.system— cambio hecho sin una persona de por medio: un lead que llega por un webhook entrante, Meta lead ads o WhatsApp, más los workers internos como asignaciones y automatizaciones.api— cambio hecho a través de este API REST (tus propias escrituras, plataformas partner).
Filtrá solo por
api. Descartar también system te haría tirar justamente los leads entrantes a los que más te conviene reaccionar.