Mosend WhatsApp Activities

Versión: 1.0.4  ·  ID: zoan-packages-mosend  ·  Autor: Zoan Software

El paquete Mosend permite que un robot envíe mensajes de WhatsApp a través de la cuenta de Mosend de tu organización (un servicio de mensajería para WhatsApp Business): avisos de pedido, recordatorios de pago, facturas en PDF, confirmaciones. También sirve para consultar las plantillas aprobadas de la cuenta y buscar contactos antes de escribirles.

Cómo se conecta el robot con Mosend

La cuenta de Mosend se conecta una sola vez en Zoan Cloud y las actividades la usan por nombre:

1. En Zoan Cloud, abre Centro › Recursos › Integraciones del ambiente y, en la sección Mensajería, conecta la cuenta de Mosend (con una API key o autorizando con OAuth). El nombre que le pongas (por ejemplo mosend) es el que irá en el parámetro integration de cada actividad.
2. Cuando el robot ejecuta una actividad, le pide a Zoan Cloud la sesión de esa integración usando la identidad de la ejecución. Zoan Cloud entrega una sesión vigente (si es OAuth, un token que renueva por ti) y deja en la auditoría qué ejecución usó la integración.
3. El robot habla con Mosend directamente: el contenido de los mensajes no pasa por Zoan Cloud. La sesión se reutiliza durante toda la ejecución y los secretos se ocultan en los logs.

Requisitos

• Una integración de Mosend creada en Centro › Recursos › Integraciones del mismo ambiente donde corre el proceso. Si el nombre no existe, la actividad falla con “The Mosend integration ’…’ does not exist in this environment”.
• El proceso debe ejecutarse desde Zoan Cloud o desde el Designer conectado a tu tenant: sin ese contexto de ejecución las actividades no pueden obtener la sesión.
• Al menos un número de WhatsApp activo en la organización de Mosend. Es el que se indica en el parámetro from de las actividades de envío.

Conceptos clave de WhatsApp

• La ventana de 24 horas. WhatsApp solo entrega texto libre (Send WhatsApp Text y Send WhatsApp File) si el contacto te escribió en las últimas 24 horas. Para escribirle a alguien por primera vez, o fuera de esa ventana, usa una plantilla aprobada por Meta con Send WhatsApp Template.
• Número de origen (from). Es el número de WhatsApp de tu cuenta que envía el mensaje, tal como aparece en Mosend (+57 300 000 0000) o su id de Mosend.
• Número de destino (to). En formato internacional, con o sin +. Los espacios y guiones se ignoran; se necesitan al menos 8 dígitos.

Actividades

Actividad	Tipo	Salida	Qué hace
Send WhatsApp Text	mosend-send-text	object	Envía un mensaje de texto (dentro de la ventana de 24 h)
Send WhatsApp Template	mosend-send-template	object	Envía una plantilla aprobada, también fuera de la ventana de 24 h
Send WhatsApp File	mosend-send-file	object	Envía una imagen, PDF, documento, video o audio desde el disco del robot
List WhatsApp Templates	mosend-list-templates	List<object>	Lista las plantillas de la cuenta con su idioma y estado
Find WhatsApp Contact	mosend-find-contact	List<object>	Busca contactos por teléfono o nombre

Un flujo típico

Avisar a un cliente que su pedido salió y enviarle la factura:

Send WhatsApp Template   integration = "mosend"   from = "+57 300 000 0000"
                         to = "+57 300 000 0001"   template = "pedido_enviado"
                         variables = ["Cliente de prueba", "#0001"]   → output: aviso
Send WhatsApp File       integration = "mosend"   from = "+57 300 000 0000"
                         to = "+57 300 000 0001"   filePath = "C:/facturas/F-0001.pdf"
                         caption = "Tu factura del pedido #0001"

Errores habituales

• 401: Mosend rechazó la sesión. Reconecta la integración en Centro › Recursos › Integraciones.
• 403: la cuenta de Mosend no tiene permiso para esa operación.
• 429: se alcanzó el límite de peticiones de Mosend. Reintenta más tarde (por ejemplo con Retry).

Siguientes pasos

• Send WhatsApp Template — la forma de iniciar una conversación.
• List WhatsApp Templates — para saber qué plantillas puedes usar.