Saltar al contenido principal

Nodo notification

El nodo notification envía una notificación utilizando la plantilla de evento seleccionada del módulo Events. Los canales, idiomas y destinatarios se toman de la configuración de la plantilla, y el nodo pasa los valores de las variables a la plantilla.

El nodo se encuentra en el panel izquierdo junto a los nodos telegram y whatsapp. Tiene una entrada y una salida.

Configuraciones del nodo notification​

1. Nombre​

Campo para especificar el nombre del nodo.
El nombre se muestra en el área de trabajo y ayuda a identificar fácilmente el nodo.
Si se deja vacío, el nodo se llamará notification.

Ejemplo:

  • Nombre del nodo: enviar código de pedido

2. Plantilla de evento​

Sección en la que se selecciona la plantilla de evento y se establecen los datos para ella.

Plantilla​

Lista desplegable de plantillas. Muestra los eventos del módulo Events que están marcados como plantillas para el flujo (casilla Usar como plantilla para el flujo en la configuración del evento), hasta un máximo de 100. El nombre se toma en el idioma actual de la interfaz.

Mientras no se seleccione una plantilla, en el campo aparece — seleccionar plantilla —. La selección se puede restablecer con una cruz en el campo.

info

Al cambiar la plantilla, los valores de las variables y la ruta a los destinatarios se borran; deben completarse nuevamente.

Información sobre la plantilla​

Después de seleccionar, aparece una tarjeta de plantilla debajo de la lista:

  • Nombre de la plantilla — nombre de la plantilla.
  • Canales — canales de envío incluidos en la plantilla: Email, Push, WebSocket.
  • Destinatarios — a quién envía la plantilla la notificación.
  • Locales — idiomas en los que está completada la plantilla.

Posibles valores de Destinatarios:

ValorQuién recibirá la notificación
Todos los usuariostodos los usuarios
Suscriptoressuscriptores
Grupo de usuariosgrupo de usuarios
Usuario objetivousuario objetivo
Registradosregistrados
Todostodos
IDs de usuario del flujousuarios cuyos identificadores son pasados por el flujo
Direcciones de correo electrónico del flujodirecciones de correo electrónico que son pasadas por el flujo

Si hay algún problema con la plantilla seleccionada, el formulario advierte sobre ello:

  • No se pudo cargar la lista de plantillas. — la lista de plantillas no se cargó.
  • Plantilla no encontrada. Puede que haya sido eliminada. — plantilla no encontrada, puede que haya sido eliminada.
  • El evento seleccionado ya no es una plantilla. — se ha desmarcado la plantilla del evento seleccionado.

3. Destinatarios​

El bloque aparece solo si en la plantilla los destinatarios son IDs de usuario del flujo o Direcciones de correo electrónico del flujo. Contiene un campo con la ruta al array de destinatarios en el mensaje del flujo, en formato Mustache:

  • Ruta a los IDs de usuario en el mensaje — para IDs de usuario del flujo, sugerencia en el campo: {{msg.payload.userIds}};
  • Ruta a las direcciones de correo electrónico en el mensaje — para Direcciones de correo electrónico del flujo, sugerencia en el campo: {{msg.payload.emails}}.

Ejemplo:

{{msg.payload.userIds}}

4. Variables de plantilla​

El bloque aparece si en la plantilla hay variables personalizadas. Para cada variable, hay un campo separado, etiquetado con el nombre de la variable (o su marcador, si no hay nombre).

El valor puede ser una expresión Mustache o una cadena normal.

Ejemplo:

{{msg.payload.code}}

Si se elimina la variable de la plantilla, pero se ha guardado un valor para ella en el nodo, el formulario muestra una advertencia Estas variables ya no se utilizan en la plantilla: con una lista de tales variables y sus valores.

Parámetros en el esquema JSON​

En el esquema JSON del flujo, la configuración del nodo se almacena de la siguiente manera:

  • name (string) - nombre del nodo
  • eventId (number | null) - identificador de la plantilla de evento seleccionada
  • variables (object) - valores de las variables de la plantilla: clave — marcador de la variable, valor — expresión Mustache o cadena
  • recipientsPath (string) - ruta al array de destinatarios en el mensaje

Ejemplo de uso​

Ejemplo 1: Notificación a usuarios pasados por el flujo​

Tarea:
Enviar el código de pedido a varios usuarios, cuyos identificadores son calculados por el flujo.

Flujo:

[inject] ---> [function] ---> [notification]

Código del nodo function:

msg.payload = {
  userIds: [12, 15],
  code: "A-1024"
};
return msg;

Configuraciones del nodo notification:

  • Plantilla: plantilla de evento, cuyo destinatario son IDs de usuario del flujo, y en el texto hay una variable con el marcador code
  • Ruta a los IDs de usuario en el mensaje: {{msg.payload.userIds}}
  • Campo de la variable code en Variables de plantilla: {{msg.payload.code}}

Resultado:
La notificación se enviará a los usuarios con identificadores 12 y 15 a través de los canales incluidos en la plantilla, y en lugar de la variable code, se insertará A-1024.