Tipos de mensaje
Archivo
Envía un documento o archivo
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
"file".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 documento. 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 al archivo; si necesitas enviarlo, hazlo en un mensaje de texto aparte.
string
Nombre con el que el usuario ve el archivo.
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
Errores Comunes
INVALID_MEDIA_URL- La URL del archivo es inválida o inaccesibleMEDIA_TOO_LARGE- El archivo excede el límite de tamaño del canalUNSUPPORTED_MEDIA_TYPE- El formato de archivo no es soportado
Casos de Uso
- Enviar facturas o recibos
- Compartir documentos legales
- Enviar reportes o análisis
- Compartir presentaciones