Send WhatsApp File

Send WhatsApp File

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

Envía un archivo que está en el disco del robot (una factura en PDF, una foto, un comprobante, un audio) por WhatsApp, con un texto opcional que lo acompaña. El robot sube el archivo a Mosend y luego lo envía al destinatario.

Cómo funciona

1. Revisa que el archivo de filePath exista y deduce su tipo por la extensión:

   Tipo	Extensiones	Límite de WhatsApp
   Imagen	.jpg, .jpeg, .png, .webp, .gif	5 MB
   Video	.mp4, .3gp	16 MB
   Audio	.mp3, .ogg, .aac	16 MB
   Documento	.pdf, .doc(x), .xls(x), .ppt(x), .txt, .csv y cualquier otra extensión	100 MB

2. Si el archivo supera el límite de su tipo, falla antes de subirlo.

3. Obtiene la sesión de Mosend, identifica el número from y sube el archivo a Mosend.

4. Envía el mensaje a to con el archivo, el pie de foto (caption) y, si es un documento, el nombre que verá el destinatario (fileName).

La ventana de 24 horas

Como el texto libre, un archivo solo se entrega si el contacto te escribió en las últimas 24 horas. Si no, envía primero una plantilla con Send WhatsApp Template.

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.
filePath	string	—	Ruta completa del archivo en esta máquina. El tipo (imagen, documento, video, audio) se deduce de la extensión. Ej: C:\facturas\F-0001.pdf.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
caption	string	—	Texto que se muestra junto al archivo.
fileName	string	nombre del archivo	Nombre que ve el destinatario en los documentos. Por defecto, el nombre del archivo.

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.
mediaId	Id del archivo subido a 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.
No se encontró el archivo local.	filePath no existe en la máquina del robot.
'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.
El archivo supera el límite de WhatsApp para el tipo … (… MB).	El archivo pesa más que el límite de su tipo. Compártelo con un enlace (por ejemplo con Get Storage File URL).
Mosend no devolvió un id de medio tras la subida.	La subida a Mosend no devolvió el archivo. Reintenta.
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 File   integration = "mosend"   from = "+57 300 000 0000"
                     to = "+57 300 000 0001"
                     filePath = "C:/facturas/F-0001.pdf"
                     fileName = "Factura F-0001.pdf"
                     caption = "Hola, Cliente de prueba. Adjuntamos tu factura."
                     → output: envio

Archivos generados por el robot

Si el robot genera el archivo en la misma ejecución (un PDF con PDF, un Excel con Excel), pasa la ruta de salida directamente a filePath. Si el archivo está en el Almacenamiento de Zoan Cloud, descárgalo antes con Download Storage File.

Actividades relacionadas

• Send WhatsApp Text — solo texto.
• Send WhatsApp Template — para iniciar la conversación fuera de la ventana de 24 horas.