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

{
  "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"
}

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 transportiert meist eine Stimmung statt einer Information. Daher kann ein Agenten-Posteingang einen Platzhalter anzeigen, und ein automatisierter Flow kann die Nachricht als Bestätigung behandeln, die das Fenster zurücksetzt, ohne etwas herunterzuladen.

Die Webhook-Payload

whatsapp.received enthält den sticker-Arm im Event-Envelope:

{
  "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
    }
  }
}

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 erfasst. Das Auslesen wird unter Reaktionsereignisse behandelt.

Nächste Schritte

• So funktioniert der Empfang: der Eingangs-Envelope, Medienabruf und der whatsapp.received-Webhook
• WhatsApp-Sticker-Nachrichten: die Sendeseite desselben Arms
• Nicht unterstützte Nachrichtentypen: Bestellungen, Systemmeldungen und alles Weitere, was unmodelliert ankommt
• WhatsApp-Webhooks: alle Ereignisse, die Sie abonnieren können