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:
| Strona | Do czego służy |
|---|---|
| Messages | Wiadomości przychodzące i wychodzące, z treścią, zdarzeniami i szczegółami dostarczenia dla każdej wiadomości |
| Metrics | Metryki dostarczenia wychodzących i wolumen wiadomości przychodzących |
| Templates | Szablony, które możesz wysyłać, zarządzane i własne: nazwa, język, kategoria i wyrenderowany podgląd |
| Numbers | Numery nadawcze zarządzane przez Bird oraz podłączone numery własne |
| Grupy | Grupy WhatsApp administrowane przez Twoje numery firmowe, z ich uczestnikami i linkami z zaproszeniami |
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
| Strona | Co obejmuje |
|---|---|
| Wysyłanie wiadomości WhatsApp | API wysyłki: odbiorca, szablon, komponenty, tagi, model asynchroniczny |
| Wiadomości serwisowe | Dziewięć typów treści, okno serwisowe i wysyłanie mediów przez URL |
| Odbieranie | Wiadomości przychodzące, pobieranie mediów i webhook whatsapp.received |
| Szablony | Katalog szablonów, kategorie i zmienne oraz wysyłanie po slugu |
| Log WhatsApp | Wiadomości przychodzące i wychodzące, treść, status i osie czasu zdarzeń |
| Zdarzenia | Osie czasu wiadomości i historia reakcji w API |
| Webhooki | Webhooki dostarczenia, wiadomości przychodzących, reakcji, blokad i grup |
| Grupy | Wspólne czaty z wieloma klientami, linki z zaproszeniami i limity grup |
| Wysyłanie do grupy | Adresowanie grupy, wymagania i potwierdzenia dla poszczególnych uczestników |
| Odbieranie wiadomości grupowych | Który uczestnik napisał wiadomość grupową i jak na nią odpowiedzieć |
| Rezygnacje | Reguły słów kluczowych, preferencje odbiorców i lista blokad |
| Metryki WhatsApp | Wydajność dostarczania wychodzących i wolumen wiadomości przychodzących |
| Limity żądań | Przepustowość polityki organizacji, nagłówki odpowiedzi i obsługa błędu 429 |
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Obejrzyj przewodnikConnecting WhatsApp to Bird: from buying a number to a live channelZrozum koncepcjęWhat is the 24-hour customer service window on WhatsApp?Użyj narzędziaWhatsApp message builderPoznaj możliwościWhatsApp
Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy