Saltar al contenido principal

Nodo whatsapp

El nodo whatsapp proporciona integración con la API de WhatsApp Business Cloud (Meta). Con él, el flujo puede enviar mensajes de texto simples y mensajes de plantilla aprobados con sustitución de variables a los usuarios.

Configuraciones del nodo whatsapp​

Edit

1. wa_phone_number_id​

Identificador del número de remitente en Meta. Se puede encontrar en la sección de WhatsApp → Getting Started en Meta Business Manager.

Soporta Mustache.

Ejemplo:

{{flow.phoneNumberId}}

2. wa_access_token​

Token de acceso permanente de Meta Business Manager.

Soporta Mustache: el token se puede almacenar en una variable de flujo y sustituir a través de {{variable}}.

Ejemplo:

{{flow.whatsappToken}}

3. wa_api_version​

Versión de la API de Graph que se utilizará para las solicitudes. Campo estático.

Ejemplo:

v19.0

4. wa_action​

Tipo de mensaje enviado. Opciones disponibles:

  • text — mensaje de texto simple. Activa el campo text.
  • template — mensaje de plantilla, previamente aprobado en Meta. Activa los campos templateName, locale y components.

5. wa_to​

Número de teléfono del destinatario en formato internacional: con el código del país, sin el signo + y sin espacios.

Soporta Mustache.

Ejemplo:

{{payload.user.phone}}

o de forma estática: 79001234567

6. wa_text​

Texto del mensaje. Se utiliza solo cuando action: text.

Soporta Mustache.

Ejemplo:

Su pedido nº{{payload.orderId}} ha sido realizado con éxito. Espere la entrega.

7. wa_template_name​

Nombre de la plantilla aprobada en Meta Business Manager. Se utiliza solo cuando action: template.

Soporta Mustache.

Ejemplo:

order_confirmation

8. wa_locale​

Idioma de la plantilla en formato language_REGION. Debe coincidir exactamente con el idioma de la plantilla en la configuración de Meta.

Ejemplos:

  • en_US — inglés (EE. UU.)
  • fr_FR — francés

9. wa_components​

Parámetros de la plantilla: valores de las variables que se sustituirán en la plantilla al enviar. Se utiliza solo cuando action: template.

Cada elemento contiene tres campos:

  • type — sección de la plantilla: header (encabezado) o body (cuerpo principal).
  • name — nombre de la variable, tal como se define en la plantilla en el panel de WhatsApp Business.
  • text — valor que se sustituirá en lugar de la variable. Soporta Mustache.

Ejemplo:

type: body  |  name: order_id   |  text: {{payload.orderId}}
type: body  |  name: amount     |  text: {{payload.totalPrice}}

Ejemplos de uso​

Ejemplo 1: Notificación de texto sobre el pedido​

Flujo:

[events: order_created] ---> [whatsapp]

Configuraciones del nodo:

  • accessToken: {{flow.whatsappToken}}
  • phoneNumberId: {{flow.phoneNumberId}}
  • apiVersion: v19.0
  • action: text
  • to: {{payload.order.phone}}
  • text: Su pedido nº{{payload.order.id}} ha sido aceptado. Total: {{payload.order.totalPrice}} rub.

Resultado:
Al crear un pedido, el usuario recibirá un mensaje de WhatsApp con los detalles del pedido.

Ejemplo 2: Mensaje de plantilla con variables​

Flujo:

[cms-events: order_status_changed] ---> [whatsapp]

Configuraciones del nodo:

  • action: template
  • to: {{payload.order.phone}}
  • templateName: order_status_update
  • locale: en_US
  • components: 
    type: body  |  name: order_id    |  text: {{payload.order.id}}
    type: body  |  name: status      |  text: {{payload.order.status}}

Resultado:
El usuario recibirá un mensaje de plantilla aprobado con los valores del número de pedido y el estado.

info

Los mensajes de plantilla deben ser creados previamente y aprobados en Meta Business Manager. Los valores de los campos templateName y locale deben coincidir exactamente con los parámetros de la plantilla aprobada.