Enviar campaña

Send campaign

POST /BASE_URL/{username}/campaign/send

• Body
• Response
• Request example
• Successful response example

📄 Especificación del archivo de campaña (file_url)

El parámetro file_url debe contener una URL pública que apunte a un archivo en formato .xlsx (Excel). Este archivo debe estar accesible sin requerir autenticación (por ejemplo, alojado en servicios como Google Drive con permisos públicos, Amazon S3 con acceso público, Dropbox con enlace directo, etc.).

Este archivo define los usuarios destinatarios de la campaña, junto con los datos necesarios para personalizar y enviar el contenido. Es fundamental que el archivo tenga la siguiente estructura:

Estructura del archivo

El archivo debe contener una sola hoja (hoja 1) con un encabezado en la fila 1. Cada fila siguiente representa un usuario individual. A continuación se describen las columnas requeridas y opcionales:

phone (requerido)

• Número de teléfono del usuario que recibirá el mensaje. El nombre phone debe estar en inglés y en minúsculas tal cual aparece aquí. Sin esta columna el envío no se podrá realizar
• Los números de teléfono, deben incluir el código de país correspondiente.

Datos adicionales (variables opcionales)

• Es posible agregar columnas adicionales (sin espacios en el nombre) para utilizarlas dentro del chatbot, ya sea según los requerimientos de la plantilla o para personalizar los mensajes que recibirán los usuarios.
• El campo body_example sirve para definir las variables dinámicas que serán reemplazadas con los valores del archivo .xlsx.
• Los nombres dentro de {{...}} deben coincidir exactamente con los nombres de las columnas del archivo.
• No se permiten espacios ni caracteres especiales. Usa guiones bajos (_) si necesitas separar palabras.