- Seguir las cifras de entrega en la pantalla Overview.
- Encontrar una notificación, leer sus intentos de entrega y reintentarla o cancelarla.
- Configurar los perfiles de entrega que envían cada canal.
- Cambiar los ajustes de runtime del servicio de entrega.
Abrir la Notification Layer
Haz clic en el ícono de engranaje () en la barra de navegación superior y selecciona Notification Layer. La misma entrada también está en la barra lateral de Settings. El área tiene su propia barra lateral con cuatro pantallas: Overview, Notifications, Delivery Profiles y Settings. Con Access Manager, la entrada necesita el permiso de lectura sobre notifications. Sin ese permiso, Notification Layer no aparece en el menú de engranaje ni en la barra lateral de Settings. Cada pantalla y cada acción necesita su propio permiso:
Overview
La pantalla Overview resume la entrega de notificaciones en todos los canales. Seis tarjetas están en la parte superior:
Debajo de las tarjetas:
- Total Attempts y Avg Attempts per Notification cuentan los intentos de entrega.
- Top Failure Reasons muestra las fallas por motivo, por ejemplo Invalid recipient o Rejected by Twilio. Un motivo sin etiqueta muestra su código de falla.
- Volume by Channel muestra el número de notificaciones en cada canal.
- Recent Notifications lista las notificaciones más recientes con su Status, Channel, Recipient, Subject, Priority y fecha Created.
Notifications
La pantalla Notifications lista las notificaciones de la plataforma. La tabla tiene las columnas Status, Channel, Subject, Recipient, Priority y Created. Para abrir una notificación, abre el menú de la columna Actions y selecciona View.
Estados de las notificaciones
Filtrar la lista
Abre el panel Filters para acotar la lista:- Status: haz clic en uno o más chips de estado.
- Channel: Email, SMS o Webhook.
- Recipient: el destinatario exacto.
- Correlation ID: el identificador de correlación de la notificación.
- Failure code: los códigos de falla del resumen, los más frecuentes primero.
- Created from y Created to: el rango de fechas de creación.
Detalle de la notificación
La pantalla Notification Detail muestra una notificación en tarjetas:- La primera tarjeta muestra el estado, el canal, ID, Subject, Recipient, Destination, Priority y Correlation ID.
- Delivery muestra Attempts (usados y máximo), Scheduled at, Next attempt at, Delivered at, Failed at, Canceled at, Canceled by, Provider message ID, Failure code, Created at y Updated at.
- Metadata y Failure detail aparecen como JSON cuando la notificación los tiene.
Intentos de entrega
La tarjeta Delivery attempts lista los intentos, el más antiguo primero, como Attempt 1, Attempt 2 y así sucesivamente. Cada intento muestra:- Su resultado y la hora del intento.
- Provider: el perfil de entrega que hizo el intento.
- Response: el código de respuesta, cuando hay uno.
- Latency: la duración del intento, en milisegundos.
- El mensaje de error, cuando el intento falló.
- Response body: haz clic en él para expandir el cuerpo que devolvió el proveedor.
Reintentar o cancelar una notificación
Retry delivery está disponible cuando el estado es Failed o Exhausted. Confirma en el cuadro de diálogo Retry delivery?. La notificación vuelve a Pending y el servicio intenta la entrega de nuevo. Cancel notification está disponible cuando el estado es Pending, Processing o Failed. Confirma en el cuadro de diálogo Cancel notification?. No puedes deshacer una cancelación. El servicio no hace ningún nuevo intento de entrega.Delivery Profiles
Un perfil de entrega conecta un canal con un proveedor y guarda las credenciales de ese proveedor. La pantalla Delivery Profiles lista los perfiles con las columnas Name, Channel, Provider, Status, Priority, Default y Updated. El menú de la fila en Actions tiene View y Delete. Cuando un canal tiene más de un perfil activo, el servicio usa primero el perfil con la prioridad más alta. Un empate va al perfil predeterminado y luego al perfil más antiguo. El servicio omite los perfiles inactivos.
Crear un perfil de entrega
1
Abre el formulario
Haz clic en New delivery profile.
2
Ponle nombre al perfil
Escribe un Name.
3
Elige el canal y el proveedor
Selecciona el Channel y luego el Provider. No puedes cambiar ninguno de los dos después de crear el perfil.
4
Define los campos de selección
Define el Status, la Priority y el interruptor Default for this channel.
5
Define los límites
Si quieres, escribe un Rate limit (per second) y un Daily limit. Un límite vacío significa sin límite.
6
Completa la configuración del proveedor
Completa los campos de la sección Provider configuration. Los campos cambian según el proveedor, como muestran las siguientes secciones.
7
Guarda
Haz clic en Save. La Console vuelve a la lista.
Proveedores de email y SMS
Cada canal tiene sus propios proveedores. Un asterisco (*) marca un campo obligatorio.
From es el remitente que ven los destinatarios, como una dirección de email o un ID de remitente de SMS aprobado. El Port de SMTP acepta un valor de 1 a 65535.
Proveedor de webhook
El canal Webhook tiene un proveedor, HTTP_WEBHOOK. El perfil no guarda la dirección del endpoint: cada notificación de webhook lleva su propia dirección en Destination. El perfil de webhook tiene estos campos:- Signing secret (HMAC): opcional. El servicio firma el cuerpo de la solicitud con este secreto, para que el destino pueda verificar el remitente.
- Destination auth: cómo se autentica el servicio ante el destino. Selecciona none para ninguna autenticación.
- Custom headers: pares opcionales de nombre y valor que el servicio envía en cada solicitud.
Para oauth2_client_credentials y jwt_exchange, Auth URL es el endpoint de token que el servicio llama antes de entregar el webhook. Para jwt_exchange, Token path y Expires-in path son las rutas JSON del token de acceso y de su tiempo de vida en la respuesta.
Detalle del perfil de entrega
La pantalla Delivery Profile muestra el estado, el canal y el proveedor del perfil en la parte superior. Puedes cambiar estos campos:- Name
- Status
- Priority
- Rate limit
- Daily limit
- Default profile for this channel
Reemplazar las credenciales
La sección Provider configuration & credentials no muestra las credenciales guardadas. Para reemplazarlas:1
Abre el editor
Haz clic en Edit credentials.
2
Completa cada campo
Completa todos los campos que quieres conservar. Los campos secretos, como contraseñas, claves de API y tokens, se abren vacíos.
3
Guarda
Haz clic en Save credentials. Los nuevos valores reemplazan la configuración completa del proveedor. Para detenerte, haz clic en Cancel.
Eliminar un perfil de entrega
Haz clic en Delete en la pantalla del perfil, o selecciona Delete en el menú de la fila de la lista. Luego haz clic en Confirm en el cuadro de diálogo.Settings
La pantalla Settings muestra los ajustes de runtime del servicio de entrega, por grupo. Los cambios se aplican sin reinicio. Cada fila muestra el ajuste, su clave, una descripción y los valores permitidos.
Para cambiar ajustes:
1
Encuentra el ajuste
Escribe en el cuadro de búsqueda, o selecciona un grupo en la lista que está al lado. All groups muestra todos los grupos.
2
Cambia el valor
Cambia el valor. La pantalla marca cada fila cambiada.
3
Guarda
Haz clic en Save con el número de cambios, por ejemplo Save 2 changes.