Sign inGet started

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:
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);
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

PoleOgraniczenieWymuszane przez
Rozmiar pliku, statyczny100 KBtylko WhatsApp, przy pobraniu (async)
Rozmiar pliku, animowany500 KBtylko WhatsApp, przy pobraniu (async)
Typ plikutylko WebPtylko WhatsApp, przy pobraniu (async)
captionnieprawidłowe poleBird, przy przyjęciu (422, odrzucenie schematu)
urlbezwzględny, https, zawiera host, bez surowych spacjiBird, 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 i gdy media zawodzą.

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, 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.
  • Bird odrzuca http; WhatsApp sam by go pobrał. Zobacz w hubie wysyłanie mediów przez URL, aby poznać pełną walidację kształtu.
  • Odrzucone pobranie i tak jest naliczane. Zobacz w hubie gdy media zawodzą. 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