Communities

WhatsApp Cloud API Webhooks for Communities

Webhooks for Communities work the same way as they do for Groups. Read more here: Groups You can use the same webhook events to track membership changes, updates, and activity within community sub-groups.

It is also important to take into account the nuances related to the logic of Communities, for example, how a group of ads looks like in the system and how it differs from other groups. We wrote more about it here: Communities

Creation of new community

Use the groups.post setting to get this webhook.

When you create a Community, three entities are automatically created by WhatsApp itself: 1 - the Community itself, 2 - the Announcement Group within that Community (has the same name as the Community), 3 - the General Regular Group within the Community

Here's the community that's been created:

{
  "groups": [
    {
      "id": "[email protected]",
      "name": "Archery Fans",
      "type": "group",
      "timestamp": 1747725964,
      "participants": [
        {
          "id": "61371989950",
          "rank": "creator"
        }
      ],
      "name_at": 1747725964,
      "description": "Hey everyone!",
      "description_id": "0328DC0E8747E2A1D905678779AD87A2",
      "created_at": 1747725964,
      "created_by": "61371989950"
    }
  ],
  "event": {
    "type": "groups",
    "event": "post"
  },
  "channel_id": "SPRWMN-MU3RE"
}

Here's an established group of announcements within the Community:

{
  "groups": [
    {
      "id": "[email protected]",
      "name": "Archery Fans",
      "type": "group",
      "timestamp": 1747725964,
      "participants": [
        {
          "id": "61371989950",
          "rank": "creator"
        }
      ],
      "name_at": 1747725964,
      "description": "Hey everyone!",
      "description_id": "0328DC0E8747E2A1D905678779AD87A2",
      "created_at": 1747725964,
      "created_by": "61371989950",
      "announcements": true,
      "linkedParent": "[email protected]",
      "isCommunityAnnounce": true
    }
  ],
  "event": {
    "type": "groups",
    "event": "post"
  },
  "channel_id": "SPRWMN-MU3RE"
}

Important: If you're seeing identifiers like ***@lid, it means that at the time of the request, your WhatsApp account did not have access to the phone number of the other participant.

If you can see the participant’s number in your WhatsApp app but not in the API, please contact our support team so we can investigate.