surtlyConfigura notificaciones
Suscríbete a eventos por correo o webhook y revisa sus envíos.
Elige evento y canal
Abre Notifications. Crea una suscripción, selecciona un evento y elige correo o un endpoint de webhook existente. Guarda y habilita. Los eventos disponibles incluyen:
- Pedido creado, preparado y cancelado.
- Entrega creada, en camino, completada, fallida y cancelada.
- Pago creado y reembolsado.
Enroute corresponde a una entrega marcada Dispatched. Después de crear una suscripción solo puedes editar su estado Active; crea otra para cambiar evento, canal o destino.
Destinatarios e idioma del correo
Los destinatarios provienen del correo principal del proveedor y del correo del cliente cuando existe. El correo de contacto de la dirección de entrega no es la fuente de destinatarios. No es una lista libre de correos.
Configura inglés o español para las notificaciones en configuración del negocio. Revisa esas direcciones si falta una notificación esperada.
Agrega un endpoint de webhook
Crea un endpoint con nombre, URL HTTPS, estado activo, secreto opcional y versión de esquema. El editor ofrece 2026-05-14 y 2026-08-17. Elige la versión que espera el sistema receptor. Dejar el secreto vacío al editar conserva el existente.
Asigna el endpoint a una suscripción y mantén ambos activos. Usa la referencia del receptor para implementar el esquema elegido y verificar firmas en tu integración.
Revisa el historial de eventos
Abre Events desde Notifications para ver todo el historial, o usa la lista de eventos recientes. Expande un evento con su flecha para ver cada envío por correo o webhook. Revisa canal, destinatario o URL guardados, estado, número de intentos, fecha de entrega y último error. Los eventos sin registros de envío no tienen control para expandir.
Estos estados describen envíos de notificaciones, por separado de las entregas físicas de pedidos:
| Estado del evento | Significado y siguiente paso |
|---|---|
| Pending | El procesamiento del evento no ha terminado. Revisa más tarde. |
| Skipped | El evento se marcó como omitido durante el procesamiento. Revisa si debía generar una notificación. |
| No deliveries | El procesamiento terminó sin crear registros de envío. Revisa suscripciones aplicables, estados activos y destinatarios disponibles; por sí solo no significa que falló un webhook. |
| Pending delivery | Al menos un envío está pendiente, posiblemente esperando un reintento automático. Expande el evento para revisarlo. |
| Delivered | Todos los envíos registrados se completaron. |
| Failed | Todos los envíos registrados fallaron. Revisa el último error y destino de cada uno. |
| Partial failure | Algunos envíos se completaron y otros fallaron. Expande el evento para identificar el canal o destinatario que requiere atención. |
Si falla un webhook, revisa la URL y el servicio receptor. Para correo, revisa el destinatario guardado y el error. La interfaz del proveedor no tiene controles de envío de prueba ni reintento manual. Un estado exitoso confirma el resultado del sistema de envío; no confirma que una persona haya leído el mensaje.
Cambia ajustes con notificaciones ya en cola
Cada envío de webhook creado guarda su URL, secreto, versión de esquema y contenido. Los reintentos usan esa configuración guardada. Editar o desactivar un endpoint o una suscripción afecta la creación de envíos futuros; no modifica ni retira los envíos ya en cola. Los reintentos de correo también usan los destinatarios y contenido guardados.
Al cambiar una URL o rotar un secreto, considera los envíos pendientes que todavía usan la configuración anterior. La interfaz del proveedor no ofrece cancelación de la cola. La referencia para recibir webhooks explica firmas, esquemas, tiempos de espera y reintentos.