Saltar al contenido principal

Nodo notification

El nodo notification envía una notificación con la plantilla de evento seleccionada del módulo Events (se abre en una pestaña nueva). Los canales, los idiomas y los destinatarios se toman de la configuración de la plantilla, y el nodo le pasa los valores de las variables.

El nodo está en el panel izquierdo, junto a los nodos telegram y whatsapp. Tiene una entrada y una salida.

Configuración del nodo notification​

1. Name​

Nombre del nodo.
Se muestra en el área de trabajo y ayuda a identificar el nodo.
Si lo deja vacío, el nodo se llamará notification.

Ejemplo:

  • Nombre del nodo: send order code

2. Event template​

Aquí se selecciona la plantilla de evento y se definen sus datos.

Template​

Lista desplegable de plantillas. Muestra hasta 100 eventos del módulo Events marcados como plantillas para el flujo (casilla Use as a template for workflow en la configuración del evento). Los nombres se muestran en el idioma actual de la interfaz.

Mientras no haya una plantilla seleccionada, el campo muestra — select template —. Para quitar la selección, haga clic en la cruz del campo.

info

Al cambiar de plantilla, se borran los valores de las variables y la ruta a los destinatarios, y hay que volver a rellenarlos.

Información de la plantilla​

Al seleccionar una plantilla, aparece su tarjeta debajo de la lista:

  • Template name: nombre de la plantilla.
  • Channels: canales de envío activados en la plantilla: Email, Push, WebSocket.
  • Recipients: a quién envía la notificación la plantilla.
  • Locales: idiomas en los que está rellenada la plantilla.

Valores posibles de Recipients:

ValorQuién recibe la notificación
All userstodos los usuarios
Subscriberslos suscriptores
User groupun grupo de usuarios
Target userel usuario destinatario
Registeredlos usuarios registrados
Everyonetodos
User IDs from workflowlos usuarios cuyos identificadores pasa el flujo
Email addresses from workflowlas direcciones de correo electrónico que pasa el flujo

Si hay algún problema con la plantilla seleccionada, el formulario muestra un aviso:

  • Failed to load the list of templates.: no se pudo cargar la lista de plantillas.
  • Template not found. It may have been deleted.: no se encontró la plantilla; es posible que se haya eliminado.
  • The selected event is no longer a template.: el evento seleccionado ya no está marcado como plantilla.

3. Recipients​

Este bloque solo aparece si los destinatarios de la plantilla son User IDs from workflow o Email addresses from workflow. Contiene un único campo con la ruta, en formato Mustache, al array de destinatarios dentro del mensaje del flujo:

  • Path to user IDs in the message: para User IDs from workflow; el texto de ayuda del campo es {{msg.payload.userIds}}.
  • Path to email addresses in the message: para Email addresses from workflow; el texto de ayuda del campo es {{msg.payload.emails}}.

Ejemplo:

{{msg.payload.userIds}}

4. Template variables​

Este bloque aparece si la plantilla tiene variables personalizadas. Cada variable tiene su propio campo, con el nombre de la variable como etiqueta (o su marcador, si no tiene nombre).

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

Ejemplo:

{{msg.payload.code}}

Si una variable se ha eliminado de la plantilla pero el nodo conserva un valor para ella, el formulario muestra el aviso These variables are no longer used in the template: con la lista de esas variables y sus valores.

Parámetros en el esquema JSON​

En el esquema JSON del flujo, la configuración del nodo se guarda así:

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

Ejemplo de uso​

Ejemplo 1: notificación a usuarios que pasa el flujo​

Tarea:
Enviar el código de un pedido a varios usuarios cuyos identificadores calcula el flujo.

Flujo:

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

Código del nodo function:

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

Configuración del nodo notification:

  • Template: una plantilla de evento cuyos destinatarios son User IDs from workflow y cuyo texto contiene una variable con el marcador code
  • Path to user IDs in the message: {{msg.payload.userIds}}
  • Campo de la variable code en Template variables: {{msg.payload.code}}

Resultado:
La notificación se envía a los usuarios con los identificadores 12 y 15 por los canales activados en la plantilla, y en el texto la variable code se sustituye por A-1024.

Última actualización en