Sign inGet started

Wiadomości wideo WhatsApp

Wiadomość wideo zawiera publiczny URL, który WhatsApp pobiera w momencie wysyłki, z opcjonalnym podpisem pod spodem.

Wyślij wideo

Ustaw 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);
Pełna struktura dodaje opcjonalne caption:
Przykład kodu
{
  "to": "+16505551234",
  "from": "+13124495648",
  "video": {
    "url": "https://cdn.example.com/unboxing.mp4",
    "caption": "How to set it up"
  }
}
video nie ma pola filename. from jest wymagane w każdej wiadomości serwisowej: numer należący do Twojego obszaru roboczego, a nie zarządzany przez Bird.

Limity

PoleOgraniczenieEgzekwowane przez
Rozmiar pliku16 MBtylko WhatsApp, przy pobraniu (async)
FormatKontener MP4, wideo H.264, audio AACtylko WhatsApp, przy pobraniu (async)
captiondo 1024 znakówBird, przy przyjęciu (422)
urlbezwzględny, https, ma host, bez surowych spacjiBird, przy przyjęciu (422)
Bird sprawdza kształt URL-a i długość podpisu, zanim cokolwiek trafi do kolejki. Nie sprawdza rzeczywistego rozmiaru pliku, kontenera ani kodeka; to może zrobić dopiero własne pobranie WhatsApp w momencie wysyłki. Zobacz w hubie wysyłanie mediów przez URL i gdy media się nie powiodą.

Odczyt przychodzącego wideo

Przychodzące wideo zawiera ten sam obiekt video, a dodatkowo id i mime_type, które Bird poznał podczas pobierania pliku. Oba są nieobecne przy odczycie wiadomości wychodzącej, ponieważ Bird nigdy nie pobierał pliku, który wysłał. Zobacz Odbieranie wideo WhatsApp, aby poznać pełny odczyt przychodzący, payload whatsapp.received i na co zwrócić uwagę.

Limity i tryby błędów

  • Okno obsługi klienta musi być otwarte. Wideo jest wiadomością serwisową, dostarczalną tylko w otwartym oknie; zobacz w hubie okno obsługi klienta.
  • Bird odrzuca http; WhatsApp sam by go pobrał. Zobacz w hubie wysyłanie mediów przez URL, aby poznać pełną walidację kształtu.
  • Odrzucone pobranie i tak jest naliczane. Zobacz w hubie gdy media się nie powiodą, aby poznać media_rejected i fakt naliczania opłaty przy błędzie. Treść odrzucenia wideo od WhatsApp nie została niezależnie zmierzona tak jak w przypadku obrazów, więc traktuj mapowanie jako wywnioskowane przez analogię, a nie potwierdzone dla każdej przyczyny.
  • WhatsApp buforuje pobrany URL przez około 10 minut. Ponowne wysłanie identycznego URL-a w tym oknie serwuje pierwszy fetch; zmień URL, aby wymusić nowe pobranie.
  • Animowany GIF nie jest osobnym typem. WhatsApp nie ma typu wiadomości gif; animowany GIF, który wyślesz, dociera do odbiorcy i wróciłby do Ciebie jako wiadomość przychodząca, jako zwykły video z typem MIME MP4.

Następne kroki