# 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

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

| Feld        | Was es enthält                                                             |
| ----------- | -------------------------------------------------------------------------- |
| `id`        | Die gespeicherte Datei, als `media_id` beim Abrufen der Bytes zu übergeben |
| `url`       | Eine Bird-URL, abzurufen mit Ihrem API-Key                                 |
| `mime_type` | Der von WhatsApp gemeldete Medientyp, `image/webp` bei einem Sticker       |
| `animated`  | Ob 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](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) 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:

```json
{
  "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](/docs/guides/whatsapp/events#reaction-events) beschrieben.

## Nächste Schritte

- [So funktioniert der Empfang](/docs/guides/whatsapp/receiving-whatsapp): der Eingangs-Envelope, Medienabruf und der `whatsapp.received`-Webhook
- [WhatsApp-Sticker-Nachrichten](/docs/guides/whatsapp/message-types/stickers): die Sendeseite desselben Arms
- [Nicht unterstützte Nachrichtentypen](/docs/guides/whatsapp/receiving-whatsapp/unsupported): Bestellungen, Systemmeldungen und alles Weitere, was unmodelliert ankommt
- [WhatsApp-Events](/docs/guides/whatsapp/events): die vollständige Event-Liste, über die API oder Webhooks

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)