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 behandelt de onderdelen die niet groepsspecifiek zijn: elke content-arm, inkomende media ophalen 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), 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 laat zien.

De groep beantwoorden

Een deelnemer die in de groep schrijft, opent één 24-uurs klantenservicevenster 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.

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, 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 met het eigen ID van het bericht. Niets aan de call verandert voor een groep.
• Reageer erop 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. 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:

{
  "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, of lees het terug zoals WhatsApp-groepen beheren laat zien.

Volgende stappen

• Verzenden naar een WhatsApp-groep: de groep adresseren, wat ervoor nodig is en de ontvangstbevestigingen per deelnemer
• WhatsApp-groepen beheren: een groep aanmaken via de API, uitnodigingslinks, deelnameverzoeken en pins
• WhatsApp-groepen: waarvoor een groep dient, en welke limieten WhatsApp stelt
• WhatsApp-berichten ontvangen: elk inhoudstype, media en geciteerde antwoorden
• Business-scoped user-ID's: een deelnemer adresseren van wie je het telefoonnummer niet hebt