---
title: "Odbieranie wiadomości grupowych WhatsApp"
description: "Jak odczytać wiadomość grupową, który uczestnik ją napisał, jak odpowiedzieć grupie i co zawiera webhook whatsapp.received."
canonical: "https://bird.com/pl-pl/dokumentacja/guides/whatsapp/groups/receiving"
---

# 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](/docs/guides/whatsapp/receiving-whatsapp) opisuje części, które nie są specyficzne dla grup: wszystkie typy treści, [pobieranie mediów przychodzących](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) 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](/docs/guides/whatsapp/business-scoped-user-ids)), 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](/docs/guides/whatsapp/groups/sending#4-read-one-groups-conversation).

## Odpowiadanie grupie

Uczestnik piszący w grupie otwiera jedno 24-godzinne [okno obsługi klienta](/docs/knowledge-base/whatsapp/customer-service-window) 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](/docs/guides/whatsapp/groups/sending).

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`](/docs/api/errors/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ą](/docs/guides/whatsapp/mark-message-as-read) podając identyfikator wiadomości. W przypadku grupy wywołanie nie zmienia się w niczym.
- [Zareaguj na nią](/docs/guides/whatsapp/reactions) jednym emoji. Reakcja trafia do grupy, więc widzi ją każdy uczestnik. Nieaktywna grupa odrzuca zmianę z błędem `409` [`E15047`](/docs/api/errors/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`:

```json
{
  "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**](https://bird.com/dashboard/w/whatsapp/groups) albo odczytaj ją tak, jak pokazuje [Zarządzanie grupami WhatsApp](/docs/guides/whatsapp/groups/management#2-wait-for-whatsapp-to-confirm-it).

## Następne kroki

- [Wysyłanie do grupy WhatsApp](/docs/guides/whatsapp/groups/sending): adresowanie grupy, wymagania i potwierdzenia dostarczenia na uczestnika
- [Zarządzanie grupami WhatsApp](/docs/guides/whatsapp/groups/management): tworzenie grupy przez API, linki z zaproszeniami, prośby o dołączenie i przypięte wiadomości
- [Grupy WhatsApp](/docs/guides/whatsapp/groups): do czego służy grupa i jakie ograniczenia nakłada WhatsApp
- [Odbieranie wiadomości WhatsApp](/docs/guides/whatsapp/receiving-whatsapp): wszystkie typy treści, multimedia i cytowane odpowiedzi
- [Identyfikatory użytkowników w zakresie firmy](/docs/guides/whatsapp/business-scoped-user-ids): adresowanie uczestnika, którego numeru telefonu nie masz

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/whatsapp-api) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)