Dokumentacja
Sign inGet started
Rozpocznij
Przewodniki
Referencja API
SDK
CLI
Baza wiedzy
Changelog

Odbieranie wiadomości tekstowych WhatsApp

Kontakt, który pisze na czacie, tworzy wiadomość przychodzącą z text. To najczęstszy typ przychodzący i ten, który otwiera lub resetuje okno obsługi klienta.

Co zawiera przychodzący tekst

text.body zawiera to, co kontakt wpisał, i nic więcej na tym typie nie występuje:
Przykład kodu
{
  "id": "wam_01kya19eknftrs2s6p82asmvnh",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100", "display_name": "Alex Rivera" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "text": { "body": "Is my order out for delivery yet?" },
  "created_at": "2026-08-25T09:04:11Z"
}
preview_url to pole strony wysyłającej. Przychodzący tekst nie zawiera flagi podglądu linku, niezależnie od tego, co wyświetlił klient kontaktu, więc URL w body jest odczytywany jako część tekstu.
Schemat odczytu nie deklaruje maksimum dla przychodzącego body. Limit 4096 znaków dotyczy strony wysyłającej, więc ustaw magazyn danych jako tekst bez ograniczeń, a nie na limit, którego strona przychodząca nie gwarantuje.

Tekst wysłany jako odpowiedź z cytatem

Gdy kontakt odpowiada na jedną z Twoich wiadomości, cytując ją, typ pozostaje bez zmian, a in_reply_to_message_id wskazuje wiadomość, na którą odpowiedziano:
Przykład kodu
{
  "id": "wam_01kyb2m4xq7whs0d8n3prv6tez",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
  "text": { "body": "Yes, that one" },
  "created_at": "2026-08-25T09:06:02Z"
}
WhatsApp nie oznacza każdej odpowiedzi, a nieoznaczona nie zawiera żadnego ID. Zobacz odpowiedzi z cytatem w hubie, aby dowiedzieć się, co rozwiązywanie może pominąć i jak korelować bez niego.

Payload webhooka

whatsapp.received zawiera ten sam typ na kopercie zdarzenia, więc endpoint przetwarza tekst bez ponownego odczytu wiadomości:
Przykład kodu
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:04:11.118Z",
  "data": {
    "whatsapp_id": "wam_01kya19eknftrs2s6p82asmvnh",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100", "display_name": "Alex Rivera" },
    "to": { "phone_number": "+13124495569" },
    "text": { "body": "Is my order out for delivery yet?" },
    "tags": null,
    "metadata": null
  }
}

Na co uważać

  • Tekst to najtańszy sposób, w jaki kontakt ponownie otwiera okno. Każda wiadomość przychodząca resetuje okno obsługi do 24 godzin, a tekst to najczęściej wysyłany typ; od tego momentu można dostarczyć Twoją odpowiedź w dowolnej formie.
  • from może nadejść bez numeru telefonu. Kontakt, który przyjął nazwę użytkownika WhatsApp, dociera do Ciebie przez identyfikator użytkownika w zakresie firmy, więc odczytuj tożsamość z from, zamiast zakładać, że from.phone_number jest ustawione.
  • Treść to tekst wpisany przez kontakta. Dotknięcie czegoś, co wysłałeś, trafia jako odpowiedź interaktywna na osobnym typie.

Następne kroki

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