Enviar mensajes
Enviar imagen
Envía una imagen con leyenda opcional por WhatsApp, Instagram o Messenger.
Envía una imagen con POST /v1/messages y type: "image". 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": "image", "image": { "link": "https://cdn.exemplo.com/foto.jpg", "caption": "Tu pedido salió a entrega" }}'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: "image", image: { link: "https://cdn.exemplo.com/foto.jpg", caption: "Tu pedido salió a entrega" },});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": "image", "image": { "link": "https://cdn.exemplo.com/foto.jpg", "caption": "Tu pedido salió a entrega" }}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 de la imagen.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("foto.jpg")]), connection_id: "con_123",});
await messajo.messages.send({ connection_id: "con_123", to: "5511999990000", type: "image", image: { media_id: media.id },});La carga devuelve el id del medio (med_…), que usas en image.media_id.
image.caption: leyenda de hasta 1024 caracteres.- Carga: hasta 5 MiB, en JPEG o PNG.
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ñalandoimage.caption. Envía la leyenda como un mensaje de texto aparte.
| Canal | Tamaño máximo | Formatos |
|---|---|---|
| 8 MiB | image/jpeg, image/png, image/gif |
|
| Messenger | 25 MiB | image/jpeg, image/png, image/gif |
Varias imágenes (solo Instagram)
Sección titulada «Varias imágenes (solo Instagram)»type: "images" envía de 2 a 10 imágenes en un solo mensaje. Cada elemento acepta link o media_id.
{ "connection_id": "con_123", "to": "17841400000000000", "type": "images", "images": { "items": [ { "link": "https://cdn.exemplo.com/a.jpg" }, { "link": "https://cdn.exemplo.com/b.jpg" } ] }}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.