Odbieranie wiadomości grupowych WhatsApp

Wszystko, co uczestnik pisze w grupie, dociera tak samo jak każda inna wiadomość przychodząca WhatsApp: to samo zdarzenie whatsapp.received, te same typy treści, to samo pobieranie mediów. Dwie rzeczy są specyficzne dla grupy. Wiadomość zawiera zarówno uczestnika, który ją napisał, jak i grupę, przez którą przyszła, a Twoja odpowiedź trafia do grupy, a nie do tej osoby.

Odbieranie wiadomości WhatsApp opisuje części, które nie są specyficzne dla grup: wszystkie typy treści, pobieranie mediów przychodzących oraz cytowane odpowiedzi.

Co zawiera wiadomość grupowa

Wiadomość grupowa przychodząca zawiera dwa adresy zamiast jednego:

• from to uczestnik, który ją napisał, nigdy grupa. Zawiera jego bsuid (identyfikator użytkownika w zakresie firmy), jego phone_number, jeśli Twoja firma go zna, oraz username i display_name, jeśli publikuje profil. Uczestnik, który nie udostępnił Ci swojego numeru, jest identyfikowany wyłącznie przez bsuid, co wystarcza, żeby się do niego zwrócić.
• to zawiera numer Twojej firmy i grupę. phone_number to numer, który odebrał wiadomość, a group_id to grupa, przez którą wiadomość dotarła.

group_id występuje w to i nigdzie indziej, więc jego obecność tam pozwala odróżnić wiadomość grupową od wiadomości jeden-do-jednego w obu kierunkach. Wiadomość grupowa nie zawiera liczników: recipient_count, delivered_count i read_count raportują rozsyłanie wychodzące, a wiadomość przychodząca ich nie ma.

Aby odczytać wątek jednej grupy w obu kierunkach jednocześnie, przefiltruj listę wiadomości po group_id, jak pokazuje Wysyłanie do grupy WhatsApp.

Odpowiadanie grupie

Uczestnik piszący w grupie otwiera jedno 24-godzinne okno obsługi klienta dla całej grupy, a nie osobne dla każdej osoby. Dopóki jest otwarte, treść dowolna trafia do grupy; po wygaśnięciu konieczny jest szablon. Skieruj odpowiedź do grupy, podając identyfikator grupy w to i bez from. Zobacz Wysyłanie do grupy WhatsApp.

Napisanie do tego uczestnika prywatnie to osobna konwersacja z własnym oknem, a wiadomość grupowa go nie otwiera. Wiadomość dowolna skierowana na jego numer telefonu lub bsuid jest odrzucana z błędem 422 E15044, chyba że uczestnik osobno napisał do Twojej firmy w ciągu ostatnich 24 godzin. Szablon dotrze do niego w każdym przypadku.

Potwierdzanie i reagowanie

Oba potwierdzenia działają na wiadomości grupowej i wymagają tych samych wywołań co na każdej innej wiadomości przychodzącej:

• Oznacz jako przeczytaną podając identyfikator wiadomości. W przypadku grupy wywołanie nie zmienia się w niczym.
• Zareaguj na nią jednym emoji. Reakcja trafia do grupy, więc widzi ją każdy uczestnik. Nieaktywna grupa odrzuca zmianę z błędem 409 E15047. To jedyne odrzucenie, które reakcja na wiadomość grupową dostaje, a reakcja w rozmowie jeden-do-jednego nie.

Webhook

whatsapp.received przekazuje wiadomość grupową w tej samej kopercie co każdą inną, z grupą w to:

{
  "type": "whatsapp.received",
  "timestamp": "2026-09-15T14:05:41.204Z",
  "data": {
    "whatsapp_id": "wam_01kya1b3xdq7fe8m2v5t9rncgs",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+15550002222", "bsuid": "US.AbC1", "display_name": "Dana Reyes" },
    "to": { "phone_number": "+15550001111", "group_id": "wag_01krdgeqcxet5s7t44vh8rt9mg" },
    "text": { "body": "Got it, thanks." },
    "tags": null,
    "metadata": null
  }
}

Odczytaj data.to.group_id, aby skierować wiadomość do wątku grupy, i data.from, aby przypisać ją uczestnikowi. Subskrybent, który rozróżnia konwersacje wyłącznie po from, rozdzieli każdego uczestnika grupy do osobnego wątku i utraci kontekst grupy.

Dla samej grupy nie ma żadnego zdarzenia. Dołączenie lub opuszczenie grupy, zmiana nazwy ani przypięcie wiadomości nie generują webhooka, więc skład grupy odczytuje się zamiast otrzymywać w powiadomieniu: otwórz grupę na stronie Groups albo odczytaj ją tak, jak pokazuje Zarządzanie grupami WhatsApp.

Następne kroki

• Wysyłanie do grupy WhatsApp: adresowanie grupy, wymagania i potwierdzenia dostarczenia na uczestnika
• Zarządzanie grupami WhatsApp: tworzenie grupy przez API, linki z zaproszeniami, prośby o dołączenie i przypięte wiadomości
• Grupy WhatsApp: do czego służy grupa i jakie ograniczenia nakłada WhatsApp
• Odbieranie wiadomości WhatsApp: wszystkie typy treści, multimedia i cytowane odpowiedzi
• Identyfikatory użytkowników w zakresie firmy: adresowanie uczestnika, którego numeru telefonu nie masz