Ir al contenido

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.

Ventana de terminal
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"
}
}'

La respuesta es 201 con id (msg_…), status: "queued" y conversation_id. El estado final llega por webhook.

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 de POST /v1/media, un multipart/form-data con file (y connection_id, salvo con clave de conexión mjc_…). Requiere el permiso send. El tipo se lee de los bytes del archivo, no de la extensión.
Ventana de terminal
curl -X POST https://api.messajo.com/v1/media \
-H "Authorization: Bearer $MESSAJO_API_KEY" \
-F connection_id=con_123 \

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.

El cuerpo es el mismo, con dos diferencias:

  • link debe ser https.
  • No existe caption. Enviarla devuelve 422 type_not_supported_by_channel señalando image.caption. Envía la leyenda como un mensaje de texto aparte.
Canal Tamaño máximo Formatos
Instagram 8 MiB image/jpeg, image/png, image/gif
Messenger 25 MiB image/jpeg, image/png, image/gif

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" }
]
}
}
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.