Skip to main content
POST

Parámetros de ruta

string
requerido
Identificador único del bot que envía el mensaje.

Parámetros del cuerpo

string
requerido
Tipo de mensaje. Debe ser "image".
string
requerido
Destinatario del mensaje. Acepta un número de teléfono en formato E.164 sin el signo + (ej: 593999999999) o un BSUID (ej: US.13491208655302741918) para usuarios con protección de número activada en WhatsApp. Consulta Identificación del destinatario.
string
requerido
URL pública (HTTPS) del archivo de imagen. Los formatos y el peso máximo dependen del canal (ver la tabla de formatos y límites por canal).
string
Texto opcional que acompaña al archivo multimedia. Solo WhatsApp: Instagram y Messenger no admiten texto junto a la imagen; si necesitas enviarlo, hazlo en un mensaje de texto aparte.

Respuesta

boolean
true si el mensaje se envió correctamente.
string
Identificador del mensaje enviado.

Formatos y límites de tamaño por canal

Requisitos de URL

La URL debe ser públicamente accesible vía HTTPS, no debe requerir autenticación, y debe apuntar directamente al archivo (no a una página HTML).

Errores Comunes

  • INVALID_MEDIA_URL - La URL de la imagen es inválida o inaccesible
  • MEDIA_TOO_LARGE - La imagen excede el límite de tamaño del canal
  • UNSUPPORTED_MEDIA_TYPE - El formato de imagen no es soportado

Casos de Uso

  • Compartir fotos de productos
  • Enviar menús visuales
  • Mostrar instrucciones visuales
  • Compartir capturas de pantalla