Dziennik wiadomości WhatsApp
Strona Messages w panelu Bird to rejestr każdej wiadomości WhatsApp wysłanej z Twojego obszaru roboczego: każde wysłanie przez POST /v1/whatsapp/messages trafia tutaj, od najnowszych. Użyj jej, żeby potwierdzić, że wiadomość została wysłana, sprawdzić, na jakim etapie dostarczenia się znajduje, i zobaczyć, który szablon ją wygenerował. Opis rozmieszczenia tej strony w panelu znajdziesz w przewodniku po panelu.
Lista wiadomości
Każdy wiersz to jedna wiadomość. Kolumny:
| Kolumna | Co pokazuje |
|---|---|
| Status | Bieżący status wiadomości (patrz Statusy), jako kolorowa kropka |
| From | Numer nadawcy WhatsApp, z którego wysłano wiadomość |
| To | Numer odbiorcy |
| Template | Szablon, z którego wysłano wiadomość (kliknij wiersz, żeby otworzyć wiadomość) |
| Category | Kategoria szablonu |
| Sent | Czas przyjęcia wysyłki jako czas względny (najedź kursorem, żeby zobaczyć dokładny znacznik czasu) |
Lista jest podzielona na strony po 25 wiadomości; użyj Prev i Next, żeby przechodzić między stronami.
Wyszukiwanie i filtrowanie
Dziennik wiadomości szybko się zapełnia, dlatego strona zaczyna się od wyszukiwania po odbiorcy i dwóch filtrów. Łączą się: filtr statusu plus zakres dat zawęża wyniki do wiadomości pasujących do obu kryteriów.
Wyszukiwanie po odbiorcy. Pole wyszukiwania dopasowuje dokładny numer odbiorcy w formacie E.164. Wpisz pełny numer, na który wysłałeś wiadomość, na przykład +14155550100, żeby znaleźć każdą wiadomość zaadresowaną do niego. Wyszukiwanie dopasowuje całą wartość, a nie jej fragment.
Status. Filtruj po jednym lub kilku statusach. Status obsługuje wielokrotny wybór, więc możesz na przykład wyświetlić wszystko, co jest jeszcze w trakcie dostarczania, zaznaczając jednocześnie Accepted i Sent. Dostępne opcje to Accepted, Sent, Delivered, Failed, Rejected i Received.
Data. Filtruj po czasie wysłania wiadomości: wybierz gotowy zakres (ostatnie 3, 7 lub 30 dni) albo ustaw własny zakres w kalendarzu.
Gdy kombinacja filtrów nie zwraca wyników, strona wyświetla komunikat o braku wyników z akcją Clear filters, która przywraca pełną listę.
Statusy
Status wiadomości to miejsce, w którym aktualnie znajduje się ona w cyklu życia. Wiadomość przechodzi od accepted do końcowego wyniku dostarczenia.
| Status | Znaczenie |
|---|---|
| Accepted | Wiadomość została przyjęta i jest przygotowywana do przekazania do WhatsApp |
| Sent | Przekazana do WhatsApp; oczekiwanie na potwierdzenie dostarczenia |
| Delivered | WhatsApp potwierdził dostarczenie do odbiorcy |
| Failed | Wysyłka lub dostarczenie nie powiodło się; sprawdź zarejestrowany błąd |
| Rejected | Bird odrzucił wiadomość przed wysłaniem. Wiadomość nie została wysłana i nie zostałeś obciążony |
| Scheduled | W kolejce do wysłania w przyszłości |
| Canceled | Zaplanowana wiadomość anulowana przed wysłaniem; bez kolejnej próby wysyłki |
| Received | Wiadomość przychodząca |
Wiadomość otrzymuje status rejected, gdy odbiorca jest na liście blokad Twojego obszaru roboczego, portfel nie pokrył kosztów wysyłki lub dla miejsca docelowego nie skonfigurowano ceny. Potwierdzenie odczytu nie jest statusem: gdy odbiorca przeczyta dostarczoną wiadomość, Bird zapisuje znacznik czasu read_at i zdarzenie whatsapp.read na wiadomości, a status dostarczenia pozostaje delivered.
Podgląd wiadomości
Kliknij dowolny wiersz, żeby otworzyć wiadomość. Nagłówek pokazuje szablon, który ją wygenerował, bieżący status, odbiorcę i etykietę kategorii, a poniżej dwie karty:
- Events: oś czasu wszystkiego, co wydarzyło się z wiadomością, w kolejności, ze znacznikiem czasu przy każdym zdarzeniu. Przechodzi przez Accepted, Sent, Delivered, potem potwierdzenie odczytu, jeśli odbiorca ją przeczytał, lub błąd albo odrzucenie z opisem błędu. To ten sam strumień, który możesz odczytać przez GET /v1/whatsapp/messages/{message_id}/events.
- Details: metadane wiadomości. Zawiera ID (z przyciskiem kopiowania), numery nadawcy i odbiorcy, slug szablonu, język i kategorię oraz znaczniki czasu wysłania, dostarczenia i odczytu. Zawiera też opis błędu dla wiadomości, która nie dotarła, oraz ewentualne tagi i metadane dołączone do wysyłki.
Ten sam dziennik przez API
Wszystko na tej stronie odczytywane jest z GET /v1/whatsapp/messages i powiązanych zasobów poszczególnych wiadomości. Lista przyjmuje trzy z filtrów dostępnych na stronie: status, category i zakres dat (created_after/created_before). Dodaje kilka filtrów, których strona nie udostępnia: direction, tag oraz dokładny to lub from. to i from oznaczają te same strony wiadomości co w odpowiedzi, więc to to kontakt w wiadomości wychodzącej i Twój numer firmowy w wiadomości przychodzącej; oba przyjmują numer telefonu w formacie E.164 lub ID użytkownika w zakresie firmy. Wyszukiwanie po odbiorcy na stronie to jedyny filtr bez bezpośredniego odpowiednika, ponieważ dopasowuje kontakt w obu kierunkach, a sam to lub from nie jest w stanie tego wyrazić. Oś czasu za kartą Events to GET /v1/whatsapp/messages/{message_id}/events; przewodnik Zdarzenia WhatsApp opisuje ich programistyczne odczytywanie.
Następne kroki
- Wysyłanie wiadomości WhatsApp: payload wysyłki za każdym wierszem
- Zdarzenia WhatsApp: strumień cyklu życia wiadomości za osią czasu
- Metryki WhatsApp: widok zagregowany wszystkich wiadomości
- Cennik WhatsApp: koszt wiadomości według miejsca docelowego i kategorii
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