# 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:

**TypeScript**

```typescript
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);
```

Examples: [TypeScript](/de-de/dokumentation/guides/whatsapp/message-types/stickers.ts.md) · [Python](/de-de/dokumentation/guides/whatsapp/message-types/stickers.py.md) · [Go](/de-de/dokumentation/guides/whatsapp/message-types/stickers.go.md) · [PHP](/de-de/dokumentation/guides/whatsapp/message-types/stickers.php.md) · [CLI](/de-de/dokumentation/guides/whatsapp/message-types/stickers.cli.md) · [MCP](/de-de/dokumentation/guides/whatsapp/message-types/stickers.mcp.md) · [cURL](/de-de/dokumentation/guides/whatsapp/message-types/stickers.curl.md)

`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

| Feld                 | Grenzwert                                          | Geprüft von                                 |
| -------------------- | -------------------------------------------------- | ------------------------------------------- |
| Dateigröße, statisch | 100 KB                                             | Nur WhatsApp, beim Abruf (async)            |
| Dateigröße, animiert | 500 KB                                             | Nur WhatsApp, beim Abruf (async)            |
| Dateityp             | Nur WebP                                           | Nur WhatsApp, beim Abruf (async)            |
| `caption`            | Kein gültiges Feld                                 | Bird, bei Annahme (`422`, Schema-Ablehnung) |
| `url`                | Absolut, `https`, mit Host, ohne rohes Leerzeichen | Bird, 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](/docs/guides/whatsapp/message-types#sending-media-by-url) und [Wenn Medien fehlschlagen](/docs/guides/whatsapp/message-types#when-media-fails).

## 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](/docs/guides/whatsapp/receiving-whatsapp/stickers) 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](/docs/guides/whatsapp/message-types#the-customer-service-window).
- **Bird lehnt `http` ab; WhatsApp selbst würde es abrufen.** Siehe im Hub [Medien per URL senden](/docs/guides/whatsapp/message-types#sending-media-by-url) für die vollständige Formprüfung.
- **Ein abgelehnter Abruf wird trotzdem berechnet.** Siehe im Hub [Wenn Medien fehlschlagen](/docs/guides/whatsapp/message-types#when-media-fails). 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](/docs/guides/whatsapp/message-types): das Kundenservice-Fenster und das Modell, das alle Servicenachrichten gemeinsam haben
- [Audio](/docs/guides/whatsapp/message-types/audio): ein weiterer Medientyp ohne Bildunterschrift-Feld
- [Bilder](/docs/guides/whatsapp/message-types/images): für ein Foto oder eine Grafik mit Bildunterschrift
- [WhatsApp-Nachrichten senden](/docs/guides/whatsapp/sending-whatsapp): der Request-Envelope, das `202`-Modell und sicheres erneutes Versuchen

## 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)