Group Messaging

The Groups API enables you to programmatically create groups for messaging and collaboration for more complex use cases than 1:1 messaging, expanding the way your business can operate using WhatsApp.

Eligibility for Groups API

To qualify for group features, your business must meet both of the following requirements:

• Have a messaging limit of at least 100,000 business-initiated conversations in a rolling 24-hour period. Learn more about Messaging Limits.

• Be an Official Business Account (OBA)

Overview

Groups are invite-only, meaning that potential group participants are ultimately in control of whether they want to join the group or not.

When you create a group, a unique invite link is generated, which you can share with potential group participants. This link provides information about the group, enabling users to make an informed decision about whether they want to join.

Once a user joins the group, a webhook is triggered, signaling that you are now eligible to send messages to the group.

Limitations

• Max group participants: 08

• Supported message types: Text, media, text-based templates, and media-based templates

• Max groups you can create: 10,000 per business number

• Max Cloud API business per group: 01

• Groups are not available for Coexistence users and phone numbers onboarded to Multi-solution Conversations.

The Calling API is not supported in groups.

Follow below for more features that are not supported:

Non-supported message types

• Calling

• Disappearing messages

• View-once

• Auth

• Commerce messages

• Interactive messages

Non-supported actions

• Admin hide group participant list

• Edit message

• Delete message

• Marking message as read

Pricing

The Groups API uses per-message pricing — the same as the messages sent using the Cloud API.

How to Start Using Groups

1

Create a group

Use the Create Group endpoint to create a group, providing a subject and an optional description. Once a group has been successfully created, a group_lifecycle_update webhook for successful group creation will be returned. This webhook will include a invite_link field with the invite link that you can now share with potential group participants.

2

Invite WhatsApp Users to the Group

Add a group invite link template to your account templates.

3

Send the invite link to potential group participants

Once the template has been approved, use the template to invite members to the group using the invite link provided in the webhook from Step 01.

4

Notification of when participants join the group

When a participant joins, a group_participants_update webhook for a group participant joining will be triggered.

Only if the join_approval_mode is set to auto-approve (does not require approval).

5

Send and receive messages

You can now use the messaging endpoint to send messages to the group. The same webhooks will be triggered (sent, delivered, and read). Replies from participants will also trigger webhooks.

Useful links for Group Management

Creating template

Create a Group Invite Link Template Message

Managing Groups and Members

• Create a group

• Groups with join requests

• Delete Group

• Remove Group Participants

Invitation Access

Get and Reset Group Invite Link