Send WhatsApp Template

Send WhatsApp Template

Tipo: mosend-send-template  ·  Paquete: Mosend WhatsApp Activities v1.0.4  ·  Salida: object

Envía una plantilla aprobada de WhatsApp (notificación, recordatorio, confirmación) con la cuenta de Mosend. Es la única forma de escribirle a alguien fuera de la ventana de 24 horas: el primer mensaje a un cliente, un aviso de despacho, un recordatorio de pago. Las variables rellenan los espacios {{1}}, {{2}}… de la plantilla.

Cómo funciona

1. Obtiene la sesión de Mosend de la integración integration e identifica el número de origen from.
2. Arma el mensaje con el nombre de la plantilla (template), el idioma (language, si lo indicas) y las variables.
3. Lo envía a to y devuelve el id y el estado del mensaje.

Las variables del cuerpo (variables) van en orden: la primera rellena {{1}}, la segunda {{2}}, y así sucesivamente. Puedes pasarlas como lista o como un texto separado por comas (,), barras (|) o punto y coma (;). Todas se envían como texto.

Si la plantilla tiene un encabezado con imagen o documento o botones dinámicos, usa headerVariables con las claves que espera Mosend; las variables del cuerpo se añaden automáticamente bajo la clave body.

¿Qué nombre de plantilla uso?

Usa List WhatsApp Templates para ver las plantillas aprobadas de la cuenta con su nombre, idioma y texto. El nombre es el que registraste en Meta (ej. pedido_enviado), no el título visible.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
integration	string	—	Nombre de la cuenta de Mosend en Centro › Recursos › Integraciones del ambiente (sección Mensajería). Ej: mosend.
from	string	—	Número de WhatsApp de la cuenta que envía, tal como aparece en Mosend (ej. +57 300 000 0000), o su id de Mosend.
to	string	—	Teléfono del destinatario en formato internacional, con o sin +. Ej: +57 300 000 0001.
template	string	—	Nombre de la plantilla aprobada en Meta. Ej: pedido_enviado.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
language	string	—	Código de idioma de la plantilla (es, es_CO, en_US…). Vacío = el idioma de la primera plantilla aprobada con ese nombre.
variables	List	—	Variables del cuerpo en orden: la primera rellena {{1}}, la segunda {{2}}… Ej: ["Cliente de prueba", "#0001", "mañana"].
headerVariables	Dictionary	—	Variables del encabezado o de los botones cuando la plantilla tiene encabezado multimedia o botones dinámicos (clave → valor, como las espera Mosend). Déjalo vacío para plantillas de solo texto.

Salida

Devuelve un object con:

Campo	Descripción
id	Id del mensaje en Mosend.
status	Estado que reporta Mosend (por defecto sent).
to	Número de destino, solo dígitos.
conversationId	Id de la conversación en Mosend.

Errores comunes

La actividad falla con estos mensajes, sin prefijo; captúralos con Try / Catch:

Mensaje	Causa y solución
'…' es obligatorio.	Falta un parámetro requerido (el mensaje nombra cuál).
La integración de Mosend '…' no existe en este ambiente. Créala en Centro › Recursos › Integraciones.	El nombre de integration no coincide con ninguna integración de Mosend del ambiente donde corre el robot. Revísalo en Centro › Recursos › Integraciones.
Las actividades de Mosend necesitan el contexto de ejecución de Zoan Cloud (…).	El proceso no corre desde Zoan Cloud ni desde el Designer con sesión iniciada.
'to' debe ser un número de teléfono en formato internacional (p. ej. +57 300 123 4567).	to tiene menos de 8 dígitos.
El número de WhatsApp 'from' no se encontró en la organización de Mosend. …	from no coincide con ningún número de la cuenta. Usa el número tal como aparece en Mosend o su id.
Mosend respondió HTTP 400: …	Mosend o Meta rechazaron la plantilla: un nombre o idioma que no existe, una plantilla no aprobada o una cantidad de variables distinta de la que espera.
Zoan Cloud rechazó la sesión de Mosend para '…': HTTP …: …	Zoan Cloud no pudo entregar la sesión de la integración (por ejemplo, la autorización OAuth caducó o se revocó). Reconecta la integración.
Mosend rechazó la sesión (401). Vuelve a conectar la integración en Centro › Recursos › Integraciones.	La API key o el token ya no son válidos. Reconecta la integración.
Mosend denegó la operación (403): la cuenta no tiene el permiso. …	La cuenta de Mosend no tiene permiso para esa operación.
Se alcanzó el límite de solicitudes de Mosend (429). Reintenta más tarde.	Demasiadas peticiones seguidas. Reintenta con Retry y una espera.
Mosend respondió HTTP …: …	Otro error de Mosend; el detalle (hasta 300 caracteres de la respuesta) va después de los dos puntos.

Ejemplo

La plantilla pedido_enviado dice: “Hola {{1}}, tu pedido {{2}} llega {{3}}.”

Send WhatsApp Template   integration = "mosend"   from = "+57 300 000 0000"
                         to = "+57 300 000 0001"
                         template = "pedido_enviado"   language = "es"
                         variables = ["Cliente de prueba", "#0001", "mañana"]
                         → output: aviso

El cliente recibe: “Hola Cliente de prueba, tu pedido #0001 llega mañana.”

La cantidad de variables debe coincidir

Meta rechaza el mensaje si la plantilla espera tres variables y envías dos (o al revés). Revisa el texto de la plantilla con List WhatsApp Templates y envía una variable por cada {{n}}.

Actividades relacionadas

• List WhatsApp Templates — ver las plantillas disponibles.
• Send WhatsApp Text — texto libre dentro de la ventana de 24 horas.
• Send WhatsApp File — enviar un archivo después del aviso.