--- title: "WhatsApp-groepsberichten ontvangen" description: "Hoe een groepsbericht eruitziet, welke deelnemer het heeft geschreven, hoe je de groep beantwoordt en wat de whatsapp.received-webhook ervoor bevat." canonical: "https://bird.com/nl-nl/documentatie/guides/whatsapp/groups/receiving" --- # WhatsApp-groepsberichten ontvangen Alles wat een deelnemer in een groep schrijft, komt binnen zoals elk ander inkomend WhatsApp-bericht: dezelfde `whatsapp.received`-event, dezelfde content-arms, dezelfde media-fetch. Twee dingen zijn specifiek voor een groep. Het bericht vermeldt zowel de deelnemer die het heeft geschreven als de groep waar het doorheen kwam, en je antwoord gaat naar de groep in plaats van naar die persoon. [WhatsApp-berichten ontvangen](/docs/guides/whatsapp/receiving-whatsapp) behandelt de onderdelen die niet groepsspecifiek zijn: elke content-arm, [inkomende media ophalen](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) en geciteerde antwoorden. ## Wat een groepsbericht bevat Een inkomend groepsbericht bevat twee adressen in plaats van één: - **`from` is de deelnemer die het heeft geschreven**, nooit de groep. Het bevat hun `bsuid` ([business-scoped user ID](/docs/guides/whatsapp/business-scoped-user-ids)), hun `phone_number` wanneer je bedrijf dat kent, en hun `username` en `display_name` wanneer ze een profiel publiceren. Een deelnemer die hun nummer niet met je heeft gedeeld, wordt geïdentificeerd door alleen het `bsuid`, en dat is voldoende om ze te adresseren. - **`to` bevat je zakelijke nummer en de groep.** `phone_number` is het nummer dat het bericht heeft ontvangen, en `group_id` is de groep waar het doorheen binnenkwam. `group_id` verschijnt op `to` en nergens anders, dus de aanwezigheid ervan is wat een groepsbericht onderscheidt van een één-op-één-bericht, in beide richtingen. Een groepsbericht bevat geen tellers: `recipient_count`, `delivered_count` en `read_count` rapporteren een uitgaande fan-out, en een inkomend bericht heeft er geen. Om de thread van één groep te lezen, beide richtingen tegelijk, filter je de berichtenlijst op `group_id` zoals [Verzenden naar een WhatsApp-groep](/docs/guides/whatsapp/groups/sending#4-read-one-groups-conversation) laat zien. ## De groep beantwoorden Een deelnemer die in de groep schrijft, opent één 24-uurs [klantenservicevenster](/docs/knowledge-base/whatsapp/customer-service-window) voor de hele groep, niet één per persoon. Zolang het open is, bereikt vrije content de groep; zodra het vervalt, is een template nodig. Adresseer het antwoord aan de groep, met de groeps-ID in `to` en zonder `from`. Zie [Verzenden naar een WhatsApp-groep](/docs/guides/whatsapp/groups/sending). Privé schrijven naar die deelnemer is een apart gesprek met een eigen venster, en het groepsbericht opent dat niet. Een vrij bericht gericht aan hun telefoonnummer of `bsuid` wordt geweigerd met een `422` [`E15044`](/docs/api/errors/E15044), tenzij ze je bedrijf de afgelopen 24 uur apart een bericht hebben gestuurd. Een template bereikt ze hoe dan ook. ## Bevestigen en reageren Beide bevestigingen werken op een groepsbericht en gebruiken dezelfde calls als bij elk ander inkomend bericht: - [Markeer het als gelezen](/docs/guides/whatsapp/mark-message-as-read) met het eigen ID van het bericht. Niets aan de call verandert voor een groep. - [Reageer erop](/docs/guides/whatsapp/reactions) met één emoji. De reactie gaat naar de groep, dus elke deelnemer ziet het. Een groep die niet actief is, weigert de wijziging met een `409` [`E15047`](/docs/api/errors/E15047). Dat is de enige weigering die een reactie op een groepsbericht heeft en een één-op-één-reactie niet. ## De webhook `whatsapp.received` draagt een groepsbericht in dezelfde envelope als elk ander bericht, met de groep op `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 } } ``` Lees `data.to.group_id` om het bericht naar de thread van de groep te routeren, en `data.from` om het aan een deelnemer toe te schrijven. Een subscriber die gesprekken alleen op `from` indexeert, plaatst elke deelnemer van een groep in een aparte thread en verliest de groep. Er is geen event voor de groep zelf. Iemand die toetreedt of vertrekt, een naamswijziging of een pin levert geen webhook op, dus het lidmaatschap van een groep wordt gelezen in plaats van gepusht: open de groep op de pagina [**Groups**](https://bird.com/dashboard/w/whatsapp/groups), of lees het terug zoals [WhatsApp-groepen beheren](/docs/guides/whatsapp/groups/management#2-wait-for-whatsapp-to-confirm-it) laat zien. ## Volgende stappen - [Verzenden naar een WhatsApp-groep](/docs/guides/whatsapp/groups/sending): de groep adresseren, wat ervoor nodig is en de ontvangstbevestigingen per deelnemer - [WhatsApp-groepen beheren](/docs/guides/whatsapp/groups/management): een groep aanmaken via de API, uitnodigingslinks, deelnameverzoeken en pins - [WhatsApp-groepen](/docs/guides/whatsapp/groups): waarvoor een groep dient, en welke limieten WhatsApp stelt - [WhatsApp-berichten ontvangen](/docs/guides/whatsapp/receiving-whatsapp): elk inhoudstype, media en geciteerde antwoorden - [Business-scoped user-ID's](/docs/guides/whatsapp/business-scoped-user-ids): een deelnemer adresseren van wie je het telefoonnummer niet hebt ## 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)