Sign inGet started

WhatsApp-videoberichten

Een videobericht bevat een openbare URL die WhatsApp ophaalt op het moment van verzending, met een optioneel bijschrift eronder.

Een video versturen

Stel video.url in:
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  video: { url: "https://cdn.example.com/unboxing.mp4" },
});
console.log(msg.id, msg.status);
De volledige structuur voegt een optionele caption toe:
Codevoorbeeld
{
  "to": "+16505551234",
  "from": "+13124495648",
  "video": {
    "url": "https://cdn.example.com/unboxing.mp4",
    "caption": "How to set it up"
  }
}
video heeft geen filename-veld. from is vereist bij elk servicebericht: een nummer dat je werkruimte bezit, niet een door Bird beheerd nummer.

Limieten

VeldLimietAfgedwongen door
Bestandsgrootte16 MBalleen WhatsApp, bij ophalen (async)
FormaatMP4-container, H.264-video, AAC-audioalleen WhatsApp, bij ophalen (async)
captionmaximaal 1024 tekensBird, bij acceptatie (422)
urlabsoluut, https, heeft een host, geen ongecodeerde spatieBird, bij acceptatie (422)
Bird controleert de vorm van de URL en de lengte van het bijschrift voordat er iets in de wachtrij wordt geplaatst. Het controleert niet de werkelijke bestandsgrootte, container of codec; dat kan alleen de eigen ophaalactie van WhatsApp op het moment van verzending. Zie in de hub media versturen via URL en wanneer media mislukt.

Een inkomende video lezen

Een inkomende video bevat hetzelfde video-object, plus een id en mime_type die Bird heeft vastgesteld door het bestand op te halen. Beide ontbreken bij het teruglezen van een uitgaand bericht, omdat Bird het verzonden bestand nooit zelf heeft opgehaald. Zie WhatsApp-video ontvangen voor de volledige inkomende leesactie, de whatsapp.received-payload en waar je op moet letten.

Limieten en faalscenario's

  • Het klantenservicevenster moet open zijn. Video is een servicebericht, alleen afleverbaar binnen een open venster; zie in de hub klantenservicevenster.
  • Bird weigert http; WhatsApp zelf zou het wel ophalen. Zie in de hub media versturen via URL voor de volledige vormcontrole.
  • Een geweigerde ophaalactie wordt toch in rekening gebracht. Zie in de hub wanneer media mislukt voor media_rejected en het feit dat er bij falen kosten in rekening worden gebracht. De eigen weigeringstekst van video van WhatsApp is niet onafhankelijk gemeten zoals die van afbeeldingen, dus beschouw de mapping als afgeleid door symmetrie in plaats van bevestigd per oorzaak.
  • WhatsApp cachet een opgehaalde URL ongeveer 10 minuten. Als je dezelfde URL binnen dat venster opnieuw verstuurt, wordt het eerste ophaalresultaat hergebruikt; varieer de URL om een nieuw ophaalverzoek af te dwingen.
  • Een geanimeerde GIF is geen apart type. WhatsApp heeft geen gif-berichttype; een geanimeerde GIF die je verstuurt komt bij de ontvanger aan, en zou bij een inkomend bericht ook bij jou aankomen, als een gewone video met een MP4-MIME-type.

Vervolgstappen