Webhooks
Feedjolt envía eventos firmados por POST a tu endpoint cuando cambian publicaciones, estados, comentarios o votos. Crea endpoints, elige eventos y reenvíalos.
Cuando algo ocurre en Feedjolt - se crea un post, cambia un estado, un voto cruza un umbral - Feedjolt puede hacer POST a una URL que tú controlas.
Esta página cubre la configuración de admin. Para la referencia orientada a ingeniería (forma del payload, verificación de firma, comportamiento de reintento), ver Desarrolladores -> Webhooks.
Configurar un endpoint
- Panel -> Ajustes -> Webhooks -> Nuevo endpoint.
- Introduce tu URL.
- Elige qué eventos enviar.
- Generamos un secreto de firma. Guárdalo; lo usarás para verificar las peticiones entrantes.
Eventos
Elige cualquier subconjunto por endpoint. Puedes tener varios endpoints con filtros de eventos distintos.
| Evento | Cuándo |
|---|---|
post.created | Se crea un nuevo post en un tablero al que estás suscrito. |
post.merged | Un post se fusiona con otro. |
post.moderated | Un borrador se aprueba o rechaza. |
status.changed | Un post cambia de estado. |
comment.created | Se publica un nuevo comentario. |
vote.threshold | Un post supera un umbral de votos configurado. |
Contrato de entrega
POST application/jsoncon el payload del evento como cuerpo.- Cabeceras:
X-Feedjolt-Signature(HMAC-SHA256 sobre el cuerpo canónico),X-Feedjolt-Event,X-Feedjolt-Timestamp. - Timeout de 10 segundos.
- Un intento de entrega por evento hoy. Los fallos se registran; los admins pueden replayar manualmente desde el panel.
Las formas completas de payload y los ejemplos de firma viven en Desarrolladores -> Webhooks.
Registro de entregas
Cada intento se registra en Ajustes -> Webhooks -> [endpoint] -> Entregas:
- Evento, marca de tiempo, código de respuesta, cuerpo de respuesta (limitado a 4 KB).
- Botón de Replay para reenviar el mismo evento bajo demanda.
Los registros se conservan mientras decidimos un TTL razonable - asume "hasta que la tabla crezca lo bastante para que añadamos uno".
Buenas prácticas
- Responde 2xx en menos de 10 segundos. Encola el trabajo pesado; confirma rápido.
- Sé idempotente. Los replays manuales reenvían el mismo evento.
- Verifica firmas. Sin verificación, cualquiera en internet puede falsificar eventos.
Ver la referencia para desarrolladores para ejemplos de código en Node, Python, Ruby y Go.
Integración con Linear
Sincroniza posts de Feedjolt con issues de Linear, con estado y comentarios bidireccionales. Conecta por OAuth, mapea estados, envía posts y desconecta.
API pública
La API REST de Feedjolt usa JSON y autenticación con token Bearer. Lee y escribe publicaciones, comentarios, votos y estados. Referencia en api.feedjolt.com/docs.