Sign inGet started

WhatsApp-afbeeldingsberichten

Een afbeeldingsbericht bevat een publieke URL die WhatsApp op het moment van verzenden ophaalt, met een optioneel bijschrift eronder.

Een afbeelding versturen

Stel image.url in:
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  image: { url: "https://cdn.example.com/receipt.png" },
});
console.log(msg.id, msg.status);
De volledige structuur voegt een optionele caption toe:
Codevoorbeeld
{
  "to": "+16505551234",
  "from": "+13124495648",
  "image": {
    "url": "https://cdn.example.com/receipts/a1b2c3.png",
    "caption": "Your receipt for order A1B2C3"
  }
}
image heeft geen filename-veld. from is verplicht bij elk servicebericht: een nummer dat je werkruimte bezit, niet een door Bird beheerd nummer.

Limieten

VeldGrensGecontroleerd door
Bestandsgrootte5 MBalleen WhatsApp, bij ophalen (async)
BestandstypeJPEG of PNGalleen 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 of het type; dat kan alleen de eigen fetch van WhatsApp op het moment van verzenden. Zie de hub-pagina media versturen via URL voor wat die vormcontrole omvat, en wanneer media mislukt voor wat er gebeurt als de fetch van WhatsApp het bestand afwijst.

Een inkomende afbeelding lezen

Een inkomende afbeelding bevat hetzelfde image-object, plus een id en mime_type die Bird heeft bepaald 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-afbeeldingen ontvangen voor het volledige inkomende bericht, de whatsapp.received-payload en waar je op moet letten.

Limieten en foutscenario's

  • Het klantenservicevenster moet open zijn. Afbeeldingen zijn serviceberichten en kunnen alleen binnen een open venster worden bezorgd; zie de hub-pagina klantenservicevenster.
  • Bird wijst http af; WhatsApp zelf zou het wel ophalen. Dat onderscheid en de rest van de URL-vormcontrole staan op de hub-pagina media versturen via URL.
  • Een te groot bestand, een verkeerd MIME-type of een onbereikbare URL mislukken allemaal op dezelfde manier, en pas nadat er kosten in rekening zijn gebracht. Zie de hub-pagina wanneer media mislukt voor media_rejected en het feit dat er ook bij een mislukte verzending kosten in rekening worden gebracht.
  • WhatsApp cachet een opgehaalde URL ongeveer 10 minuten. Als je dezelfde URL binnen dat venster opnieuw verstuurt, wordt het eerste ophaalresultaat hergebruikt in plaats van opnieuw opgehaald; varieer de URL (bijvoorbeeld met een queryparameter) om een nieuw ophaalverzoek te forceren.

Vervolgstappen