Sign inGet started

WhatsApp-stickerberichten

Een stickerbericht bevat een publieke WebP-URL die WhatsApp ophaalt op het moment van verzending. Het is de eenvoudigste media-arm: geen bijschrift, geen ander optioneel veld bij verzending.

Een sticker versturen

Stel sticker.url in; er is verder niets toe te voegen:
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  sticker: { url: "https://cdn.example.com/stickers/thumbs-up.webp" },
});
console.log(msg.id, msg.status);
sticker heeft geen caption-veld, en animated is niet iets dat je instelt bij verzending; Bird rapporteert het alleen terug bij een inkomende sticker. from is verplicht bij elk servicebericht: een nummer dat je werkruimte bezit, niet een door Bird beheerd nummer.

Limieten

VeldGrensAfgedwongen door
Bestandsgrootte, statisch100 KBAlleen WhatsApp, bij ophalen (async)
Bestandsgrootte, geanimeerd500 KBAlleen WhatsApp, bij ophalen (async)
BestandstypeAlleen WebPAlleen WhatsApp, bij ophalen (async)
captiongeen geldig veldBird, bij acceptatie (422, schemaweigering)
urlabsoluut, https, heeft een host, geen kale spatieBird, bij acceptatie (422)
Bird controleert de vorm van de URL voordat er iets in de wachtrij wordt geplaatst; het controleert niet de werkelijke grootte, het formaat of of het bestand statisch of geanimeerd is. Alleen het ophalen door WhatsApp zelf op het moment van verzending kan dat. Het meesturen van een caption is geen lengtefout; het veld bestaat niet in het schema van deze arm, dus het mislukt als een niet-herkende eigenschap. Zie de hub's media versturen via URL en wanneer media mislukt.

Een inkomende sticker lezen

Een inkomende sticker bevat een id, mime_type en animated die Bird heeft geleerd door het bestand op te halen. Alle drie ontbreken bij het teruglezen van een uitgaand bericht, omdat Bird het verstuurde bestand nooit heeft opgehaald of geïnspecteerd. Zie WhatsApp-stickers 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. Stickers zijn serviceberichten die alleen binnen een open venster bezorgbaar zijn; zie de hub's klantenservicevenster.
  • Bird weigert http; WhatsApp zelf zou het ophalen. Zie de hub's media versturen via URL voor de volledige vormcontrole.
  • Een geweigerde ophaalactie wordt toch in rekening gebracht. Zie de hub's wanneer media mislukt. De eigen weigeringstekst van stickers van WhatsApp is niet onafhankelijk gemeten, dus beschouw de mapping als afgeleid door symmetrie in plaats van bevestigd per oorzaak.
  • animated is alleen-lezen en alleen aanwezig bij een inkomende of opgehaalde sticker. Het is het eigen oordeel van WhatsApp over het bestand, niet iets dat je kunt declareren. Of een sticker statisch of geanimeerd is, verandert alleen het maximale bestandsformaat; WebP is hoe dan ook vereist.
  • WhatsApp cachet een opgehaalde URL voor ongeveer 10 minuten. Als je dezelfde URL binnen dat venster opnieuw verstuurt, wordt het eerste opgehaalde bestand opnieuw gebruikt; varieer de URL om een nieuwe ophaalactie te forceren.

Volgende stappen