Dokumentation
Sign inGet started
Jetzt starten
Anleitungen
API-Referenz
SDKs
CLI
Wissensdatenbank
Changelog

WhatsApp-Sticker empfangen

Ein Sticker, den ein Kontakt aus seinem Sticker-Bereich auswählt, kommt als eingehende Nachricht mit sticker an: eine WebP-Dateireferenz plus ein animated-Flag.

Was ein eingehender Sticker enthält

Codebeispiel
{
  "id": "wam_01kye7t1rgyw9u5l8p2zaf7sid",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "sticker": {
    "id": "waf_01kye6r7as0zkv3g1q6suy9whc",
    "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kye7t1rgyw9u5l8p2zaf7sid/media/waf_01kye6r7as0zkv3g1q6suy9whc",
    "mime_type": "image/webp",
    "animated": false
  },
  "created_at": "2026-08-25T09:19:37Z"
}
FeldWas es enthält
idDie gespeicherte Datei, als media_id beim Abrufen der Bytes zu übergeben
urlEine Bird-URL, abzurufen mit Ihrem API-Key
mime_typeDer von WhatsApp gemeldete Medientyp, image/webp bei einem Sticker
animatedOb der Sticker animiert ist; nur bei einem eingehenden Sticker vorhanden
Der Arm enthält in keiner Richtung eine Beschriftung und keinen Namen für den Sticker oder das Paket, aus dem er stammt. Ein Sticker ist die gesamte Nachricht.
animated unterscheidet ein animiertes WebP von einem statischen. Das ist relevant, wenn Sie die Datei selbst rendern: Ein animierter Sticker ist ein Multi-Frame-WebP, das ein Standbild-Renderer auf das erste Frame reduziert.

Bytes abrufen

Übergeben Sie die Nachrichten-ID und die Medien-id an die Media-Methode des Channels. Die Hub-Seite Eingehende Medien abrufen zeigt diesen Aufruf in jeder Sprache, beschreibt die Weiterleitungs- und Header-Regeln und dokumentiert das Aufbewahrungsfenster, in dem die Datei verfügbar ist.
Die meisten Integrationen rufen einen Sticker nie ab. Er trägt in der Regel Stimmung statt Information, sodass ein Agenten-Posteingang einen Platzhalter anzeigen und ein automatisierter Flow die Nachricht als fensterverlängernde Bestätigung behandeln kann, ohne etwas herunterzuladen.

Die Webhook-Payload

whatsapp.received enthält den sticker-Arm im Event-Envelope:
Codebeispiel
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:19:37.882Z",
  "data": {
    "whatsapp_id": "wam_01kye7t1rgyw9u5l8p2zaf7sid",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "sticker": {
      "id": "waf_01kye6r7as0zkv3g1q6suy9whc",
      "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kye7t1rgyw9u5l8p2zaf7sid/media/waf_01kye6r7as0zkv3g1q6suy9whc",
      "mime_type": "image/webp",
      "animated": false
    },
    "tags": null,
    "metadata": null
  }
}

Worauf Sie achten sollten

  • Ein Sticker setzt das Servicefenster trotzdem zurück. Er ist eine eingehende Nachricht wie jede andere und verschafft Ihnen weitere 24 Stunden für freie Antworten, auch wenn er keinen Text zum Verarbeiten enthält.
  • Ein Sticker ist keine Reaktion. Eine Emoji-Reaktion, die ein Kontakt auf eine Ihrer Nachrichten setzt, ist überhaupt keine eingehende Nachricht: Sie wird im Reaktionsprotokoll dieser Nachricht gespeichert. Das Auslesen wird unter WhatsApp-Events beschrieben.

Nächste Schritte

Verwandte Ressourcen

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.

Anleitung ansehenConnecting WhatsApp to Bird: from buying a number to a live channelDas Konzept verstehenWhat is the 24-hour customer service window on WhatsApp?Das Tool verwendenWhatsApp message builderDie Funktion erkundenWhatsApp
Übung ausprobieren und ein Implementierungs-Briefing erhalten