Sign inGet started

Mensajes de video de WhatsApp

Un mensaje de video lleva una URL pública que WhatsApp obtiene en el momento del envío, con un pie de texto opcional debajo.

Enviar un video

Establece video.url:
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  video: { url: "https://cdn.example.com/unboxing.mp4" },
});
console.log(msg.id, msg.status);
La forma completa agrega un caption opcional:
Ejemplo de código
{
  "to": "+16505551234",
  "from": "+13124495648",
  "video": {
    "url": "https://cdn.example.com/unboxing.mp4",
    "caption": "How to set it up"
  }
}
video no tiene el campo filename. from es obligatorio en cada mensaje de servicio: un número que tu espacio de trabajo posee, no uno administrado por Bird.

Límites

CampoLímiteVerificado por
Tamaño de archivo16 MBSolo WhatsApp, al obtener (async)
FormatoContenedor MP4, video H.264, audio AACSolo WhatsApp, al obtener (async)
captionhasta 1024 caracteresBird, al aceptar (422)
urlabsoluta, https, tiene host, sin espacios crudosBird, al aceptar (422)
Bird verifica la forma de la URL y la longitud del pie de texto antes de encolar cualquier cosa. No verifica el tamaño real del archivo, el contenedor ni el códec; solo la obtención propia de WhatsApp en el momento del envío puede hacerlo. Consulta en el hub enviar medios por URL y cuando un medio falla.

Leer un video entrante

Un video entrante lleva el mismo objeto video, más un id y mime_type que Bird obtuvo al descargar el archivo. Ambos están ausentes en una lectura de un mensaje saliente, ya que Bird nunca descargó el archivo que envió. Consulta Recibir video de WhatsApp para la lectura entrante completa, el payload de whatsapp.received y qué tener en cuenta.

Límites y modos de fallo

  • La ventana de servicio al cliente debe estar abierta. Un video es un mensaje de servicio, entregable solo dentro de una ventana abierta; consulta en el hub la ventana de servicio al cliente.
  • Bird rechaza http; WhatsApp sí lo obtendría. Consulta en el hub enviar medios por URL para la verificación completa de forma.
  • Una obtención rechazada se cobra de todos modos. Consulta en el hub cuando un medio falla para media_rejected y el hecho del cobro en caso de fallo. El texto de rechazo propio de video de WhatsApp no se ha medido de forma independiente como el de imagen, así que trata el mapeo como inferido por simetría en lugar de confirmado por causa.
  • WhatsApp almacena en caché una URL obtenida durante unos 10 minutos. Reenviar la misma URL dentro de esa ventana sirve la primera obtención de nuevo; varía la URL para forzar una nueva.
  • Un GIF animado no es un tipo distinto. WhatsApp no tiene un tipo de mensaje gif; un GIF animado que envías llega al destinatario, y te llegaría de vuelta como entrante, como un video ordinario con tipo MIME MP4.

Próximos pasos