Notification channels: destinos reutilizables de notificación
Objetivo y modelo
Notification channels define destinos reutilizables para eventos de Workflows. Un canal representa dónde enviar una notificación y si está habilitado. Es distinto del contenido de una plantilla, del transporte SMTP y de las preferencias de mensajes dentro de la aplicación.
Mantener esa separación evita diagnosticar en el lugar equivocado: una plantilla puede ser válida y fallar la entrega; un canal puede estar deshabilitado aunque SMTP esté operativo. Asimismo, ver un mensaje de éxito en pantalla no prueba que un destinatario haya recibido un correo.
Requisitos y campos
Necesita autorización para consultar canales y privilegios adicionales para administrarlos o probarlos. Prepare un destino de prueba bajo su control. No utilice listas de clientes reales para una POC ni publique endpoints que contengan credenciales.
| Campo o control | Uso |
|---|---|
| Name | Identifica el destino para quienes configuran Workflows |
| Type | Determina qué campos requiere el canal |
| Description | Explica su propósito y responsable |
| Recipients | Destinatarios del canal de correo |
| Endpoint | Dirección del canal que utiliza un endpoint |
| Enable this channel | Permite recibir eventos cuando corresponde |
El selector Type ofrece Email, HTTPS Webhook, Slack y Microsoft Teams. Para correo, Recipients admite destinatarios separados por comas y la entrega utiliza la configuración SMTP de plataforma. Los otros tipos solicitan su endpoint específico mediante un campo protegido.
Al editar, una credencial ya configurada no se vuelve necesariamente a mostrar. Un campo vacío de secreto no significa que no exista una credencial custodiada. Revise el indicador de configuración y la ayuda del formulario antes de reemplazarla.
Recorrido de trabajo
- Abra Notification channels.
- Utilice Search notification channels para evitar duplicados.
- Cree un canal mediante New notification channel.
- Seleccione el tipo y complete los campos exigidos por ese tipo.
- Añada una descripción clara, por ejemplo “Avisos de la POC Clientes Demo”.
- Guarde y revise el estado que devuelve la aplicación.
- Asocie el canal desde la configuración del Workflow que lo requiera.
- Use una prueba autorizada con un destino controlado y compruebe su recepción.
Reload, Filters, Clear filters, Columns y Export CSV actúan sobre la consulta del gestor. Exportar la lista no debería interpretarse como una exportación de secretos.
POC: entrega y deshabilitación
Cree un canal de correo de laboratorio con un buzón propio. Asócielo al Workflow sintético de Workflows, configure el evento correspondiente y realice una ejecución pequeña. Registre el identificador del intento y la hora esperada del aviso.
Resultado esperado: el sistema registra el resultado de entrega y el buzón recibe el mensaje cuando transporte, permisos y configuración son válidos. Confirme que el contenido permite identificar la ejecución sin exponer datos de entrada.
Después deshabilite el canal mediante Enable this channel y repita únicamente el ensayo necesario en el laboratorio. El contrato visible indica que los canales deshabilitados permanecen disponibles pero no reciben eventos de Workflow. Vuelva a habilitarlo si ése es el estado previsto para la prueba final.
Errores y recuperación
Ante un fallo, revise tipo de canal, destinatarios, credencial configurada y estado habilitado. Si el transporte es correo, la configuración SMTP corresponde a Administrator; no intente resolverla añadiendo secretos al cuerpo de una plantilla.
Evite reintentos sin control: podrían producir avisos duplicados cuando el proveedor haya aceptado la primera entrega pero la confirmación se retrase. Conserve un identificador de ejecución y un destinatario de laboratorio para distinguir intentos.
Relaciones y límites
La plantilla de email establece el contenido; el canal establece el destino; Monitor permite investigar la ejecución. Consulte Monitor y Workflows. Los resultados descritos son criterios de una POC pendiente de ejecución, no confirmación de entrega real durante la redacción.