Przegląd WhatsApp

Bird WhatsApp korzysta z tej samej platformy i kluczy API co Bird Email i Bird SMS. Wywołuj regionalny host dla klucza API (https://us1.platform.bird.com lub https://eu1.platform.bird.com). Endpointy WhatsApp znajdują się pod /v1/whatsapp/….

Wysyłki inicjowane przez firmę używają wcześniej zatwierdzonego szablonu wiadomości. Wyślij szablon z zarządzanego katalogu Bird, który nie wymaga własnego numeru i wysyła z nadawcy zarządzanego przez Bird, albo podłącz własny numer i wysyłaj z niego własne szablony. Kontakty mogą wysyłać wiadomości na Twój własny numer, a Bird rejestruje te wiadomości przychodzące obok wychodzących.

Jak działa wysyłanie

Wyślij wiadomość WhatsApp za pomocą POST /v1/whatsapp/messages: jeden odbiorca, jeden szablon oraz opcjonalne tagi i metadane. Walidujemy żądanie i zwracamy 202 Accepted z identyfikatorem wiadomości. Naliczanie opłat i dostarczanie odbywają się asynchronicznie. API nie ma endpointu zbiorczego, więc wysyłaj jedno żądanie na wiadomość.

Trzy koncepcje kształtują całe API:

• Wysyłanie i dostarczanie to osobne etapy. 202 oznacza, że Bird przyjął wiadomość. Urządzenie odbiorcy otrzymuje ją dopiero po przejściu wiadomości przez WhatsApp do końcowego wyniku dostarczenia. Potwierdzenie odczytu pojawia się jako znacznik czasu read_at i zdarzenie whatsapp.read; nie zmienia statusu wiadomości.
• Każda wysyłka inicjowana przez firmę używa szablonu. Podaj slug szablonu, opcjonalny language oraz wartości jego zmiennych. Wiadomość serwisowa, czyli dowolny tekst lub media, dociera do kontaktu tylko w 24-godzinnym oknie otwartym przez jego własną wiadomość i tylko z numeru należącego do Twojego obszaru roboczego. Zobacz Wysyłanie wiadomości WhatsApp.
• Kategoria i miejsce docelowe określają nadawcę i cenę. Każdy szablon ma kategorię authentication, utility lub marketing. Szablon zarządzany jest wysyłany z numeru Bird przypisanego do jego kategorii, więc nie zawiera pola from; każda inna wysyłka wskazuje własnego nadawcę. Cena zależy też od kraju odbiorcy, a opłata za wiadomość jest naliczana w dwóch krokach: opłata Bird podczas przetwarzania wysyłki przez Bird oraz udział Meta po dostarczeniu wiadomości. Zobacz Koszty i rozliczenia.

Aplikacja WhatsApp w dashboardzie

W dashboardzie WhatsApp jest jedną z aplikacji kanałowych obszaru roboczego. Jej strony:

Widoczność

Bird rejestruje oś czasu dla każdej wiadomości. Osie czasu wychodzących obejmują zdarzenia: zaakceptowano, wysłano, dostarczono, odczytano i błąd. Oś czasu przychodzącej rejestruje moment odebrania wiadomości przez Bird.

• Odczytaj oś czasu: GET /v1/whatsapp/messages/{message_id}/events zwraca zdarzenia wiadomości. Strona Messages pokazuje tę samą oś czasu. Zobacz zdarzenia WhatsApp.
• Subskrybuj zdarzenia dostarczenia wychodzących: wysyłaj publiczne zdarzenia whatsapp.accepted, whatsapp.sent, whatsapp.delivered, whatsapp.read, whatsapp.failed i whatsapp.rejected do endpointu webhooka.
• Przeglądaj zagregowane metryki: strona Metrics ma osobne karty Outbound i Inbound.

Odbieranie

Bird przechowuje wiadomości przychodzące wysłane na numer należący do Twojego obszaru roboczego, ze statusem received. Numery zarządzane przez Bird nie odbierają wiadomości dla Twojego obszaru roboczego. Znajdź wiadomości na stronie Messages lub za pomocą GET /v1/whatsapp/messages?direction=inbound. Szczegóły wiadomości pokazują tekst, obsługiwane media, dokumenty, lokalizacje i typy treści, których Bird nie może wyrenderować. Odebrane media są dostępne przez 30 dni.

Karta Inbound na stronie Metrics pokazuje szereg czasowy Messages received oraz podział By phone number. Aby reagować na każdą wiadomość przychodzącą w chwili jej otrzymania, zasubskrybuj zdarzenie webhook whatsapp.received; zobacz Webhooki wiadomości przychodzących.

Niektórzy odbiorcy proszą o zaprzestanie wysyłki, a odpowiedź STOP to najczęstszy sposób, w jaki to robią: Bird dostarcza listę słów kluczowych, więc działa to na Twoich numerach bez żadnej konfiguracji. Możesz też zapisać blokadę w zakresie jednego konta biznesowego albo rezygnację obejmującą cały obszar roboczy. Bird blokuje dalsze wysyłki na dany adres w obu przypadkach. Zobacz Rezygnacje i słowa kluczowe.

Następne kroki

• Wysyłanie wiadomości WhatsApp: wyślij szablon lub wiadomość serwisową przez API
• Podłączanie własnego numeru: skonfiguruj numer do wysyłania i odbierania wiadomości pod własną marką
• Szablony: przeglądaj szablony i znajdź zmienne potrzebne do ich wysłania
• Odbieranie wiadomości WhatsApp: odczytuj wiadomości przychodzące i pobieraj media
• Webhooki: subskrybuj wiadomości przychodzące i aktualizacje dostarczenia