Sign inGet started

WhatsApp-Stickernachrichten

Eine Stickernachricht enthält eine öffentliche WebP-URL, die WhatsApp beim Senden abruft. Es ist der einfachste Medientyp: keine Bildunterschrift, kein weiteres optionales Feld beim Senden.

Sticker senden

Setzen Sie sticker.url; mehr ist nicht nötig:
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 hat kein caption-Feld, und animated wird beim Senden nicht gesetzt; Bird gibt es nur bei einem eingehenden Sticker zurück. from ist bei jeder Servicenachricht erforderlich: eine Nummer, die Ihrem Workspace gehört, keine von Bird verwaltete.

Limits

FeldGrenzwertGeprüft von
Dateigröße, statisch100 KBNur WhatsApp, beim Abruf (async)
Dateigröße, animiert500 KBNur WhatsApp, beim Abruf (async)
DateitypNur WebPNur WhatsApp, beim Abruf (async)
captionKein gültiges FeldBird, bei Annahme (422, Schema-Ablehnung)
urlAbsolut, https, mit Host, ohne rohes LeerzeichenBird, bei Annahme (422)
Bird prüft die Form der URL, bevor etwas in die Warteschlange gestellt wird; Dateigröße, Format oder ob der Sticker statisch oder animiert ist, wird dabei nicht geprüft. Nur der eigene Abruf von WhatsApp beim Senden kann das. Das Senden eines caption ist kein Längenfehler; das Feld existiert im Schema dieses Typs nicht und schlägt daher als unbekannte Eigenschaft fehl. Siehe im Hub Medien per URL senden und Wenn Medien fehlschlagen.

Einen eingehenden Sticker lesen

Ein eingehender Sticker enthält id, mime_type und animated, die Bird beim Abruf der Datei ermittelt hat. Alle drei fehlen bei einem ausgehenden Rücklesen, da Bird die gesendete Datei nie abgerufen oder geprüft hat. Siehe WhatsApp-Sticker empfangen für das vollständige eingehende Lesen, die whatsapp.received-Payload und worauf Sie achten sollten.

Limits und Fehlerfälle

  • Das Kundenservice-Fenster muss offen sein. Sticker sind Servicenachrichten und können 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 Formprüfung.
  • Ein abgelehnter Abruf wird trotzdem berechnet. Siehe im Hub Wenn Medien fehlschlagen. Die eigene Ablehnungsmeldung von WhatsApp für Sticker wurde nicht unabhängig gemessen; die Zuordnung ist daher durch Analogie abgeleitet, nicht pro Ursache bestätigt.
  • animated ist schreibgeschützt und nur bei einem eingehenden oder abgerufenen Sticker vorhanden. Es ist das eigene Ergebnis von WhatsApp zur Datei, nichts, das Sie selbst angeben können. Ob ein Sticker statisch oder animiert ist, ändert nur die Größenobergrenze; WebP ist in beiden Fällen erforderlich.
  • WhatsApp speichert eine abgerufene URL für 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.

Nächste Schritte

  • WhatsApp-Servicenachrichten: das Kundenservice-Fenster und das Modell, das alle Servicenachrichten gemeinsam haben
  • Audio: ein weiterer Medientyp ohne Bildunterschrift-Feld
  • Bilder: für ein Foto oder eine Grafik mit Bildunterschrift
  • WhatsApp-Nachrichten senden: der Request-Envelope, das 202-Modell und sicheres erneutes Versuchen