Send WhatsApp Text

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

Envía un mensaje de texto de WhatsApp desde uno de los números de tu cuenta de Mosend. Es la forma de responder a un cliente que acaba de escribir: confirmar una solicitud, dar un estado, pedir un dato. Devuelve el id y el estado del mensaje enviado.

Cómo funciona

Obtiene la sesión de Mosend de la integración indicada en integration (ver cómo se conecta el robot).
Identifica el número de origen from: acepta el número tal como aparece en Mosend o su id.
Limpia el número de destino to (se quedan solo los dígitos) y envía el texto.

El texto admite el formato de WhatsApp (*negrita*, _cursiva_). Si supera los 4096 caracteres (el límite de WhatsApp), se recorta a ese largo antes de enviarlo y queda una advertencia en el log indicando cuántos caracteres tenía y cuántos se enviaron. Para enviar un texto largo completo, divídelo en varios mensajes.

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`.
`text`	`string`	—	Texto del mensaje. Admite `negrita` y `_cursiva_`. Máximo 4096 caracteres; un texto más largo se recorta, con una advertencia en el log.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`replyToMessageId`	`string`	—	Id de un mensaje anterior para citarlo en la respuesta.

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 (ej. `573000000001`).
`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.
`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

Send WhatsApp Text   integration = "mosend"   from = "+57 300 000 0000"
                     to = "+57 300 000 0001"
                     text = "Hola, Cliente de prueba. Recibimos tu solicitud *#0001* y ya la estamos revisando."
                     → output: mensaje
Log   level = info   message = "Mensaje enviado: " + str(mensaje["id"])

Actividades relacionadas

Send WhatsApp Template — para escribir fuera de la ventana de 24 horas.
Send WhatsApp File — enviar una imagen o un documento.
Find WhatsApp Contact — consultar un contacto antes de escribirle.