Sign inGet started

Wiadomości obrazkowe WhatsApp

Wiadomość obrazkowa zawiera publiczny URL, który WhatsApp pobiera w momencie wysyłki, z opcjonalnym podpisem pod spodem.

Wyślij obraz

Ustaw image.url:
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  image: { url: "https://cdn.example.com/receipt.png" },
});
console.log(msg.id, msg.status);
Pełna struktura dodaje opcjonalny caption:
Przykład kodu
{
  "to": "+16505551234",
  "from": "+13124495648",
  "image": {
    "url": "https://cdn.example.com/receipts/a1b2c3.png",
    "caption": "Your receipt for order A1B2C3"
  }
}
image nie ma pola filename. from jest wymagany w każdej wiadomości serwisowej: numer należący do Twojego obszaru roboczego, a nie zarządzany przez Bird.

Limity

PoleOgraniczenieWymuszane przez
Rozmiar pliku5 MBtylko WhatsApp, przy pobraniu (async)
Typ plikuJPEG lub PNGtylko WhatsApp, przy pobraniu (async)
captiondo 1024 znakówBird, przy przyjęciu (422)
urlbezwzględny, https, ma host, bez surowych spacjiBird, przy przyjęciu (422)
Bird sprawdza kształt URL-a i długość podpisu, zanim cokolwiek trafi do kolejki. Nie sprawdza rzeczywistego rozmiaru ani typu pliku; to może zrobić dopiero pobranie wykonywane przez WhatsApp w momencie wysyłki. Zobacz w hubie wysyłanie mediów przez URL, żeby dowiedzieć się, co obejmuje ta walidacja kształtu, oraz gdy media zawodzą, żeby zobaczyć, co się dzieje, gdy pobranie przez WhatsApp odrzuci plik.

Odczytywanie przychodzącego obrazu

Przychodzący obraz zawiera ten sam obiekt image oraz id i mime_type, które Bird poznał, pobierając plik. Oba są nieobecne przy odczycie wiadomości wychodzącej, ponieważ Bird nigdy nie pobierał pliku, który wysłał. Zobacz Odbieranie obrazów WhatsApp, żeby poznać pełny odczyt przychodzący, ładunek whatsapp.received i na co uważać.

Limity i tryby awarii

  • Okno obsługi klienta musi być otwarte. Obrazy to wiadomości serwisowe, dostarczalne tylko w otwartym oknie; zobacz w hubie okno obsługi klienta.
  • Bird odrzuca http; WhatsApp sam by go pobrał. To rozróżnienie i reszta walidacji kształtu URL-a znajdują się w hubie na stronie wysyłanie mediów przez URL.
  • Za duży plik, nieprawidłowy typ MIME lub nieosiągalny URL kończą się tak samo i po naliczeniu opłaty. Zobacz w hubie gdy media zawodzą, żeby poznać media_rejected i fakt naliczania opłaty przy błędzie.
  • WhatsApp przechowuje pobrany URL w pamięci podręcznej przez około 10 minut. Ponowne wysłanie identycznego URL-a w tym oknie serwuje wynik pierwszego pobrania zamiast pobierać ponownie; zmień URL (np. dodaj parametr zapytania), żeby wymusić nowe pobranie.

Następne kroki