Integraciones
Los veinte avisos que puede mandar a tu sistema
El catálogo completo de qué puede disparar algo en vuestro lado.
Vuestro sistema puede enterarse en el momento de lo que pasa aquí, sin preguntar cada rato. Esto es todo lo que puede avisar, agrupado por lo que le pasa a cada cosa.
Lo que le pasa a un expediente
| Evento | Cuándo se dispara |
|---|---|
| Se completa | Todo lo obligatorio está entregado y aprobado |
| Se cancela | Alguien lo cierra sin completar |
| Se duplica | Se crea uno nuevo a partir de este |
| Se añade una fase | El expediente crece con el proceso en marcha |
| Se importa un bloque | Entra documentación en lote |
| Se elimina | Deja de existir |
Lo que le pasa a una solicitud
| Evento | Para qué suele usarse |
|---|---|
| Se envía | Registrar en vuestro sistema que se pidió |
| Se abre | Saber que llegó de verdad |
| Se responde | Disparar el siguiente paso vuestro |
| Se recibe | Marcar el documento como entrado |
| Se rechaza | Abrir una tarea a quien la pidió |
| Se recuerda | Contabilizar la insistencia |
| Se reenvía | Detectar contactos problemáticos |
Lo que le pasa a un documento
| Evento | Para qué suele usarse |
|---|---|
| Se sube | Reflejarlo en vuestro gestor documental |
| Se le extraen datos | Volcar esos datos a vuestro sistema |
| Se certifica | Guardar la referencia de la prueba |
| Se genera desde plantilla | Trazar documentos creados automáticamente |
| Se rellena a mano | Distinguir lo manual de lo automático |
Aprobaciones
Se aprueba o se rechaza. Son los dos que más disparan trabajo en el otro lado: aprobar suele desbloquear algo vuestro, y rechazar suele abrir una tarea.
Importante
Suscribíos solo a lo que vais a usar. Escuchar los veinte llena vuestro registro de eventos que nadie procesa, y cuando falle uno importante estará enterrado entre ellos.
Ojo con esto
Cada entrega de webhook consume. Veinte eventos por expediente en un volumen alto suma deprisa; escuchar tres bien elegidos consume una fracción y resuelve lo mismo.
Ten en cuenta
Los tres que cubren la mayoría de las integraciones reales: expediente completado, solicitud respondida y aprobación decidida. Con esos tres se automatiza casi todo lo que la gente quiere automatizar.
›¿Puedo elegir cuáles recibir?
Sí, y conviene.
›¿Qué pasa si mi sistema está caído?
Se reintenta; revisad la cola de fallidos.
›¿Se puede probar sin producción?
Sí, contra el entorno de pruebas.
Un caso real
La situación
Un equipo se suscribe a los veinte eventos y a las dos semanas nadie mira el registro.
Qué haces
- Deja tres: expediente completado, solicitud respondida y aprobación decidida
Qué consigues
El registro vuelve a ser legible y el consumo baja, sin perder nada de lo que automatizaban.
La situación
Se suscriben los veinte avisos y el sistema receptor recibe ruido continuo.
Qué haces
- Suscribe solo los eventos que se van a procesar
- Añade los demás cuando haya algo que hacer con ellos
Qué consigues
El sistema recibe lo que sabe usar y el registro sigue siendo legible.
La situación
Se quiere reaccionar a que un documento caduque y no se sabe qué avisa eso.
Qué haces
- Consulta la lista de eventos disponibles
Qué consigues
La integración se monta sobre lo que existe.
La situación
Un aviso llega dos veces por un reintento.
Qué haces
- Trata el aviso como idempotente por su identificador
Qué consigues
El mismo evento no genera dos acciones.
La situación
El aviso llega y el sistema receptor no sabe de qué expediente habla.
Qué haces
- Incluye el identificador del expediente en el tratamiento
Qué consigues
La acción se aplica donde corresponde.
La situación
Se cambia un flujo y los avisos dejan de encajar.
Qué haces
- Revisa las suscripciones al cambiar el proceso
Qué consigues
La integración acompaña al cambio.
Este artículo responde a
- qué eventos emite la plataforma
- lista de webhooks disponibles
- avisar a mi erp cuando pasa algo
- eventos de expediente y solicitud