# Wiadomości ze stickerami WhatsApp

Wiadomość ze stickerem zawiera publiczny URL WebP, który WhatsApp pobiera w momencie wysyłki. To najprostsza gałąź mediów: bez podpisu, bez żadnego innego opcjonalnego pola przy wysyłce.

## Wyślij sticker

Ustaw `sticker.url`; nie trzeba dodawać nic więcej:

**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](/pl-pl/dokumentacja/guides/whatsapp/message-types/stickers.ts.md) · [Python](/pl-pl/dokumentacja/guides/whatsapp/message-types/stickers.py.md) · [Go](/pl-pl/dokumentacja/guides/whatsapp/message-types/stickers.go.md) · [PHP](/pl-pl/dokumentacja/guides/whatsapp/message-types/stickers.php.md) · [CLI](/pl-pl/dokumentacja/guides/whatsapp/message-types/stickers.cli.md) · [MCP](/pl-pl/dokumentacja/guides/whatsapp/message-types/stickers.mcp.md) · [cURL](/pl-pl/dokumentacja/guides/whatsapp/message-types/stickers.curl.md)

`sticker` nie ma pola `caption`, a `animated` nie jest czymś, co ustawiasz przy wysyłce; Bird zwraca tę wartość tylko w stickerze przychodzącym. `from` jest wymagane w każdej wiadomości serwisowej: numer należący do Twojego obszaru roboczego, a nie zarządzany przez Bird.

## Limity

| Pole                     | Ograniczenie                                            | Wymuszane przez                                   |
| ------------------------ | ------------------------------------------------------- | ------------------------------------------------- |
| Rozmiar pliku, statyczny | 100 KB                                                  | tylko WhatsApp, przy pobraniu (async)             |
| Rozmiar pliku, animowany | 500 KB                                                  | tylko WhatsApp, przy pobraniu (async)             |
| Typ pliku                | tylko WebP                                              | tylko WhatsApp, przy pobraniu (async)             |
| `caption`                | nieprawidłowe pole                                      | Bird, przy przyjęciu (`422`, odrzucenie schematu) |
| `url`                    | bezwzględny, `https`, zawiera host, bez surowych spacji | Bird, przy przyjęciu (`422`)                      |

Bird sprawdza kształt URL-a, zanim cokolwiek zostanie dodane do kolejki; nie sprawdza rzeczywistego rozmiaru pliku, formatu ani tego, czy jest statyczny, czy animowany. Może to zrobić tylko WhatsApp podczas własnego pobrania w momencie wysyłki. Wysłanie `caption` nie jest błędem długości; pole nie istnieje w schemacie tej gałęzi, więc kończy się odrzuceniem jako nierozpoznana właściwość. Zobacz w hubie [wysyłanie mediów przez URL](/docs/guides/whatsapp/message-types#sending-media-by-url) i [gdy media zawodzą](/docs/guides/whatsapp/message-types#when-media-fails).

## Odczyt stickera przychodzącego

Sticker przychodzący zawiera `id`, `mime_type` i `animated`, które Bird uzyskał, pobierając plik. Wszystkie trzy są nieobecne w odczycie wiadomości wychodzącej, ponieważ Bird nigdy nie pobrał ani nie sprawdził pliku, który wysłał. Zobacz [Odbieranie stickerów WhatsApp](/docs/guides/whatsapp/receiving-whatsapp/stickers), aby poznać pełny odczyt przychodzący, ładunek `whatsapp.received` i na co zwrócić uwagę.

## Limity i tryby awarii

- **Okno obsługi klienta musi być otwarte.** Stickery to wiadomości serwisowe, dostarczalne tylko w otwartym oknie; zobacz w hubie [okno obsługi klienta](/docs/guides/whatsapp/message-types#the-customer-service-window).
- **Bird odrzuca `http`; WhatsApp sam by go pobrał.** Zobacz w hubie [wysyłanie mediów przez URL](/docs/guides/whatsapp/message-types#sending-media-by-url), aby poznać pełną walidację kształtu.
- **Odrzucone pobranie i tak jest naliczane.** Zobacz w hubie [gdy media zawodzą](/docs/guides/whatsapp/message-types#when-media-fails). Własny tekst odrzucenia stickera od WhatsApp nie został niezależnie zmierzony, więc traktuj to mapowanie jako wywnioskowane przez symetrię, a nie potwierdzone dla każdego przypadku.
- **`animated` jest tylko do odczytu i występuje wyłącznie w stickerze przychodzącym lub pobranym.** To ocena pliku dokonana przez WhatsApp, a nie coś, co możesz zadeklarować. To, czy sticker jest statyczny, czy animowany, zmienia jedynie limit rozmiaru; WebP jest wymagany w obu przypadkach.
- **WhatsApp przechowuje pobrany URL w pamięci podręcznej przez około 10 minut.** Ponowne wysłanie tego samego URL-a w tym oknie serwuje pierwsze pobranie; zmień URL, aby wymusić nowe.

## Następne kroki

- [Wiadomości serwisowe WhatsApp](/docs/guides/whatsapp/message-types): okno obsługi klienta i model wspólny dla każdej wiadomości serwisowej
- [Audio](/docs/guides/whatsapp/message-types/audio): kolejna gałąź mediów bez pola podpisu
- [Obrazy](/docs/guides/whatsapp/message-types/images): dla zdjęcia lub grafiki z podpisem
- [Wysyłanie wiadomości WhatsApp](/docs/guides/whatsapp/sending-whatsapp): koperta żądania, model `202` i bezpieczne ponawianie

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