Sign inGet started

Messaggi video WhatsApp

Un messaggio video contiene un URL pubblico che WhatsApp recupera al momento dell'invio, con una didascalia opzionale sotto.

Inviare un video

Imposta 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 struttura completa aggiunge un caption opzionale:
Esempio di codice
{
  "to": "+16505551234",
  "from": "+13124495648",
  "video": {
    "url": "https://cdn.example.com/unboxing.mp4",
    "caption": "How to set it up"
  }
}
video non ha il campo filename. from è obbligatorio su ogni messaggio di servizio: un numero di proprietà del tuo spazio di lavoro, non uno gestito da Bird.

Limiti

CampoLimiteApplicato da
Dimensione file16 MBsolo WhatsApp, al recupero (asincrono)
FormatoContainer MP4, video H.264, audio AACsolo WhatsApp, al recupero (asincrono)
captionfino a 1024 caratteriBird, all'accettazione (422)
urlassoluto, https, con host, senza spazi grezziBird, all'accettazione (422)
Bird controlla la struttura dell'URL e la lunghezza della didascalia prima di accodare qualsiasi cosa. Non controlla la dimensione effettiva del file, il container o il codec; solo il recupero diretto di WhatsApp al momento dell'invio può farlo. Consulta le pagine dell'hub invio di media tramite URL e quando un media non riesce.

Leggere un video in arrivo

Un video in arrivo contiene lo stesso oggetto video, più un id e un mime_type che Bird ha appreso recuperando il file. Entrambi sono assenti in una rilettura in uscita, perché Bird non ha mai recuperato il file che ha inviato. Consulta Ricezione di video WhatsApp per la lettura in arrivo completa, il payload whatsapp.received e a cosa prestare attenzione.

Limiti e modalità di errore

  • La finestra del servizio clienti deve essere aperta. Il video è un messaggio di servizio, consegnabile solo all'interno di una finestra aperta; consulta la pagina dell'hub sulla finestra del servizio clienti.
  • Bird rifiuta http; WhatsApp stesso lo recupererebbe. Consulta la pagina dell'hub sull'invio di media tramite URL per il controllo completo della struttura.
  • Un recupero rifiutato viene comunque addebitato. Consulta la pagina dell'hub quando un media non riesce per media_rejected e il fatto dell'addebito in caso di errore. Il testo di rifiuto specifico per i video da parte di WhatsApp non è stato misurato in modo indipendente come per le immagini, quindi considera la mappatura come dedotta per simmetria anziché confermata per singola causa.
  • WhatsApp memorizza in cache un URL recuperato per circa 10 minuti. Reinviare lo stesso URL all'interno di quella finestra riutilizza il primo recupero; modifica l'URL per forzarne uno nuovo.
  • Un GIF animato non è un tipo distinto. WhatsApp non ha un tipo di messaggio gif; un GIF animato che invii arriva al destinatario, e tornerebbe a te in arrivo, come un normale video con tipo MIME MP4.

Passaggi successivi