- Categoría
- API
- Sentido
- Envío de eventos
- Formato
- JSON firmado con HMAC-SHA256
- Direcciones
- Hasta 25 por organización
- Reintentos
- Hasta 6 intentos, durante más de un día
- Puesta en marcha
- Una dirección HTTPS y un secreto
- Planes
- Plan Enterprise
- Editor
- Upsellr
01Lo que hacen los webhooks
La señal que hace avanzar sus herramientas.
- 01
Un evento al final de cada proceso
Terminado, fallido o detenido: al final de cada proceso de enriquecimiento o de generación, Upsellr envía el evento con el detalle del proceso.
- 02
Firmado, para poder verificarlo
Cada envío lleva un identificador, una marca de tiempo y una firma HMAC-SHA256 calculada con su secreto: su herramienta comprueba que procede realmente de Upsellr.
- 03
Reintentado hasta que se recibe
Sin respuesta 2xx en 10 segundos, Upsellr reintenta tras 1 minuto, 5 minutos, 30 minutos, 4 horas y, por último, 24 horas.
- 04
Un registro de cada envío
Estado, código HTTP, número de intentos y contenido: cada entrega se puede consultar durante 7 días, y un envío fallido se reenvía con un clic.
- 05
Encadene sus herramientas
Publique, avise a un equipo o lance una exportación en cuanto las fichas estén listas: el webhook da la señal, su herramienta hace el resto.
- 06
Mantenga el control
Desactive una dirección, cambie su secreto o elimínela: sus reintentos pendientes se cancelan.
02Primeros pasos
Conectado en pocos minutos.
- 01
Abra la configuración de la organización
Sección API y webhooks, reservada a los propietarios y administradores.
- 02
Añada una dirección
Una URL en HTTPS, accesible desde internet.
- 03
Copie el secreto
Solo se muestra una vez y sirve para verificar la firma de cada envío.
- 04
Verifique la firma
Recalcule la firma HMAC-SHA256 de la marca de tiempo y del contenido, y rechace un envío demasiado antiguo.
- 05
Responda rápido
Una respuesta 2xx en menos de 10 segundos y, después, gestione el resto por su lado.
03Eventos
Los eventos enviados.
| Evento | Enviado | Reintentado si es necesario |
|---|---|---|
| Proceso terminado (workflow.run.completed) | Sí | Sí |
| Proceso fallido (workflow.run.failed) | Sí | Sí |
| Proceso detenido (workflow.run.stopped) | Sí | Sí |
Compatibilidad y requisitos
- El plan Enterprise
- Una dirección HTTPS pública, en el puerto 443
- Un rol de propietario o administrador
- Una respuesta 2xx en menos de 10 segundos
- Consejo: deduplique por el identificador del evento
Usted tiene el control
Fiables por diseño.
- Firmados con HMAC-SHA256, con un secreto propio para cada dirección
- Entregados al menos una vez: deduplique por el identificador del evento
- Reintentados hasta 6 veces, durante más de un día
- Enviados por HTTPS, solo a direcciones públicas
04Preguntas
Preguntas sobre los webhooks de Upsellr.
¿Los webhooks están incluidos en mi plan?
Están reservados al plan Enterprise, como la API.
¿Qué eventos se envían?
El final de un proceso de enriquecimiento o de generación: terminado, fallido o detenido. Cada evento contiene el detalle del proceso.
¿Cómo verifico que un envío procede de Upsellr?
Recalcule la firma HMAC-SHA256 de la marca de tiempo y del contenido con su secreto, compárela con la cabecera X-Upsellr-Signature y rechace cualquier envío de más de 5 minutos.
¿Qué ocurre si mi servidor no responde?
Sin respuesta 2xx en 10 segundos, Upsellr reintenta tras 1 minuto, 5 minutos, 30 minutos, 4 horas y, por último, 24 horas. Un envío fallido también se puede reenviar manualmente desde el registro.
¿Puedo recibir dos veces el mismo evento?
Sí, es posible: la entrega está garantizada al menos una vez, sin orden garantizado. Deduplique por el identificador del evento.
¿Cuánto tiempo se conserva el registro?
7 días, con el estado, el código HTTP, el número de intentos y el contenido de cada envío.
¿Cuántas direcciones puedo declarar?
Hasta 25 por organización, cada una con su propio secreto, que usted puede renovar.
¿Una prueba en el editor de workflows envía un evento?
No. Solo los procesos reales envían eventos.
Marcus
Amazon