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 "video".
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 video. 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 video; 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 del video es inválida o inaccesible
  • MEDIA_TOO_LARGE - El archivo de video excede el límite de tamaño del canal
  • UNSUPPORTED_MEDIA_TYPE - El formato de video no es soportado

Casos de Uso

  • Compartir tutoriales en video
  • Enviar demostraciones de productos
  • Compartir videos promocionales
  • Enviar contenido educativo