Enviar mensajes
Enviar documento
Envía un PDF u otro documento con nombre de archivo y leyenda por WhatsApp, Instagram o Messenger.
Envía un documento con POST /v1/messages y type: "document". 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": "document", "document": { "link": "https://cdn.ejemplo.com/factura-noviembre.pdf", "filename": "factura-noviembre.pdf", "caption": "Tu factura de noviembre" }}'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: "document", document: { link: "https://cdn.ejemplo.com/factura-noviembre.pdf", filename: "factura-noviembre.pdf", caption: "Tu factura de noviembre" },});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": "document", "document": { "link": "https://cdn.ejemplo.com/factura-noviembre.pdf", "filename": "factura-noviembre.pdf", "caption": "Tu factura de noviembre" }}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 documento.media_id(med_…): viene dePOST /v1/media, unmultipart/form-dataconfile(yconnection_id, salvo con una clave de conexiónmjc_…). Exige 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("factura-noviembre.pdf")]), connection_id: "con_123",});
await messajo.messages.send({ connection_id: "con_123", to: "5511999990000", type: "document", document: { media_id: media.id, filename: "factura-noviembre.pdf" },});La carga devuelve el id del medio (med_…), que usas en document.media_id.
document.caption: leyenda de hasta 1024 caracteres.document.filename: nombre que ve el contacto, hasta 240 caracteres. Envíalo siempre, con la extensión (factura-noviembre.pdf), para que el contacto vea un nombre legible.- Carga: hasta 100 MiB.
La carga reconoce estos formatos:
| Formato | Extensiones |
|---|---|
.pdf |
|
| Office antiguo | .doc, .xls, .ppt |
| Office | .docx, .xlsx, .pptx |
| Texto plano | .txt |
Los archivos de Office se identifican por los bytes y por la extensión del nombre del archivo. Otros formatos devuelven 415 media_type_not_supported.
Instagram y Messenger
Sección titulada «Instagram y Messenger»El cuerpo es solo link o media_id, con dos diferencias:
linkdebe serhttps.- No existen
captionnifilename. Envía la leyenda como un mensaje de texto aparte.
| Canal | Tamaño máximo | Formatos |
|---|---|---|
| 25 MB | application/pdf |
|
| Messenger | 25 MB | application/pdf |
Errores
Sección titulada «Errores»| Código | Estado | Cuándo |
|---|---|---|
validation_failed |
400 | link y media_id juntos, o ninguno de los dos |
media_too_large |
413 | Archivo por encima del límite del canal |
media_type_not_supported |
415 | Formato que el canal no acepta |
media_error |
422 | Meta no pudo procesar el archivo |
outside_service_window |
422 | Mensaje libre fuera de la ventana de 24 h |