Enviar mensajes
Enviar video
Envía un video con leyenda opcional por WhatsApp, Instagram o Messenger.
Envía un video con POST /v1/messages y type: "video". Los campos comunes a todos los tipos (to, reply_to, typing, delay_ms, ventana de 24 h) están en Campos comunes.
curl -X POST https://api.messajo.com/v1/messages \ -H "Authorization: Bearer $MESSAJO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "connection_id": "con_123", "to": "5511999990000", "type": "video", "video": { "link": "https://cdn.exemplo.com/video.mp4", "caption": "Cómo armarlo" }}'import { Messajo } from "@messajo/sdk";
const messajo = new Messajo({ apiKey: process.env.MESSAJO_API_KEY! });
const message = await messajo.messages.send({ connection_id: "con_123", to: "5511999990000", type: "video", video: { link: "https://cdn.exemplo.com/video.mp4", caption: "Cómo armarlo" },});console.log(message.id, message.status);Ajustes del nodo HTTP Request de n8n
- Método:
POST - URL:
https://api.messajo.com/v1/messages - Autenticación: Generic Credential Type, luego Header Auth. Nombre:
Authorization; Valor:Bearer mj_... - Encabezados: activa Send Headers y añade
Idempotency-Key(un valor único por ítem) - Cuerpo: activa Send Body; Body Content Type: JSON; Specify Body: Using JSON
{ "connection_id": "con_123", "to": "5511999990000", "type": "video", "video": { "link": "https://cdn.exemplo.com/video.mp4", "caption": "Cómo armarlo" }}Sustituye mj_... por tu clave de API.
La respuesta es 201 con id (msg_…), status: "queued" y conversation_id. El estado final llega por webhook.
Enlace o carga
Sección titulada «Enlace o carga»Indica exactamente uno entre link y media_id. Enviar los dos, o ninguno, devuelve 400 validation_failed con exactly one of media_id or link is required.
link: URL del video.media_id(med_…): viene dePOST /v1/media, unmultipart/form-dataconfile(yconnection_id, salvo con clave de conexiónmjc_…). Requiere el permisosend. El tipo se lee de los bytes del archivo, no de la extensión.
curl -X POST https://api.messajo.com/v1/media \ -H "Authorization: Bearer $MESSAJO_API_KEY" \ -F connection_id=con_123 \import { readFile } from "node:fs/promises";
const media = await messajo.media.upload({ file: new Blob([await readFile("video.mp4")]), connection_id: "con_123",});
await messajo.messages.send({ connection_id: "con_123", to: "5511999990000", type: "video", video: { media_id: media.id },});La carga devuelve el id del medio (med_…), que usas en video.media_id.
video.caption: leyenda de hasta 1024 caracteres.- Carga: hasta 16 MiB. La carga reconoce los contenedores
video/mp4yvideo/3gpp.
Instagram y Messenger
Sección titulada «Instagram y Messenger»El cuerpo es el mismo, con dos diferencias:
linkdebe serhttps.- No existe
caption. Enviarla devuelve422 type_not_supported_by_channelseñalandovideo.caption. Envía la leyenda como un mensaje de texto aparte.
| Canal | Tamaño máximo | Formatos |
|---|---|---|
| 25 MiB | video/mp4, video/ogg, video/x-msvideo, video/quicktime, video/webm |
|
| Messenger | 25 MiB | video/mp4 |
Errores
Sección titulada «Errores»| Código | Estado | Cuándo |
|---|---|---|
validation_failed |
400 | link y media_id juntos, o ninguno |
media_too_large |
413 | Archivo por encima del límite |
media_type_not_supported |
415 | Formato que el canal no acepta |
media_error |
422 | Meta no pudo procesar el medio |
type_not_supported_by_channel |
422 | caption en Instagram o Messenger |
outside_service_window |
422 | Mensaje libre fuera de la ventana de 24 h |
El detalle de cada código está en el catálogo de errores.