Sign inGet started

WhatsApp-Videonachrichten

Eine Videonachricht enthält eine öffentliche URL, die WhatsApp beim Senden abruft, mit einer optionalen Beschriftung darunter.

Video senden

Setzen Sie 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);
Die vollständige Struktur ergänzt ein optionales caption:
Codebeispiel
{
  "to": "+16505551234",
  "from": "+13124495648",
  "video": {
    "url": "https://cdn.example.com/unboxing.mp4",
    "caption": "How to set it up"
  }
}
video hat kein filename-Feld. from ist bei jeder Service-Nachricht erforderlich: eine Nummer, die Ihr Workspace besitzt, keine von Bird verwaltete.

Limits

FeldGrenzwertGeprüft von
Dateigröße16 MBnur WhatsApp, beim Abruf (async)
FormatMP4-Container, H.264-Video, AAC-Audionur WhatsApp, beim Abruf (async)
captionbis zu 1024 ZeichenBird, bei Annahme (422)
urlabsolut, https, hat einen Host, kein rohes LeerzeichenBird, bei Annahme (422)
Bird prüft die URL-Struktur und die Länge der Beschriftung, bevor etwas eingereiht wird. Dateigröße, Container und Codec werden nicht geprüft; das kann nur der eigene Abruf von WhatsApp beim Senden. Siehe im Hub Medien per URL senden und Wenn Medien fehlschlagen.

Ein eingehendes Video lesen

Ein eingehendes Video enthält dasselbe video-Objekt, zusätzlich ein id und mime_type, die Bird beim Abruf der Datei ermittelt hat. Beide fehlen bei einem ausgehenden Rücklesen, da Bird die gesendete Datei nie selbst abgerufen hat. Siehe WhatsApp-Video empfangen für den vollständigen eingehenden Lesevorgang, die whatsapp.received-Payload und worauf Sie achten sollten.

Limits und Fehlerfälle

  • Das Kundenservice-Fenster muss offen sein. Video ist eine Service-Nachricht und kann nur innerhalb eines offenen Fensters zugestellt werden; siehe im Hub Kundenservice-Fenster.
  • Bird lehnt http ab; WhatsApp selbst würde es abrufen. Siehe im Hub Medien per URL senden für die vollständige Strukturprüfung.
  • Ein abgelehnter Abruf wird trotzdem berechnet. Siehe im Hub Wenn Medien fehlschlagen für media_rejected und die Tatsache, dass bei Fehlschlag trotzdem Kosten anfallen. Der Ablehnungstext von WhatsApp für Video wurde nicht unabhängig gemessen wie der für Bilder; betrachten Sie die Zuordnung daher als per Analogie abgeleitet, nicht als pro Ursache bestätigt.
  • WhatsApp speichert eine abgerufene URL etwa 10 Minuten im Cache. Wird dieselbe URL innerhalb dieses Zeitfensters erneut gesendet, wird der erste Abruf wiederverwendet; ändern Sie die URL, um einen neuen Abruf zu erzwingen.
  • Ein animiertes GIF ist kein eigener Typ. WhatsApp hat keinen gif-Nachrichtentyp; ein animiertes GIF, das Sie senden, kommt beim Empfänger an und würde auch bei Ihnen eingehend als gewöhnliches video mit einem MP4-MIME-Typ ankommen.

Nächste Schritte