Recibir webhooks al final de un workflow
Recibir un aviso en sus sistemas cuando una ejecución de workflow termina, falla o se detiene, y verificar la firma de los envíos.
Los webhooks avisan a sus sistemas cuando una ejecución de workflow termina. Upsellr envía entonces una petición a la dirección que usted elija. Están incluidos en la oferta Enterprise.
Los eventos
| Evento | Cuándo se emite |
|---|---|
| workflow.run.completed | Una ejecución termina con éxito |
| workflow.run.failed | Una ejecución falla |
| workflow.run.stopped | Un usuario detiene una ejecución |
Cada envío contiene la representación completa de la ejecución, en el mismo formato que la API pública. La pestaña Catálogo de eventos describe este formato.
Añadir un endpoint
- Abra el menú de la cuenta y después Gestionar y API y webhooks.
- En la pestaña Endpoints, haga clic en Añadir endpoint.
- Rellene un Nombre y la URL del endpoint. Solo se aceptan direcciones HTTPS públicas: las redes privadas y las redirecciones están bloqueadas.
- Marque los Eventos que recibir y después guarde.
- Copie el secreto de firma. Solo se muestra una vez.
Un endpoint se puede poner en pausa y después reactivar. Si pierde el secreto, haga clic en Renovar secreto y actualice su receptor de inmediato.
Verificar la firma
Cada envío lleva dos cabeceras: X-Upsellr-Timestamp, la marca de tiempo del envío, y X-Upsellr-Signature, con la forma v1= seguida de una huella hexadecimal en minúsculas. La huella es un HMAC-SHA256, calculado con el secreto del endpoint, sobre la marca de tiempo, un punto y después el cuerpo sin procesar de la petición.
Verifique la firma sobre el cuerpo sin procesar, antes de decodificar el JSON. Compare las firmas en tiempo constante y rechace las marcas de tiempo demasiado antiguas.
Envíos y reintentos
- Los eventos se envían en JSON, mediante una petición POST. Cualquier respuesta 2xx confirma la recepción.
- En caso de fallo, Upsellr vuelve a intentarlo al cabo de 1 minuto, 5 minutos, 30 minutos, 4 horas y 24 horas.
- Un evento puede llegar más de una vez, y el orden no está garantizado: elimine duplicados por identificador de evento.
El registro de entregas
La pestaña Entregas de eventos muestra los envíos de los últimos 7 días, con su estado, sus intentos y su contenido. Para un envío fallido, haga clic en Reenviar entrega fallida: el mismo evento se vuelve a enviar, con el mismo identificador.
A tener en cuenta
- Solo los propietarios y los administradores gestionan los endpoints y reenvían los envíos.
- Eliminar un endpoint anula sus envíos pendientes. Los registros existentes se conservan.