Documentation menu

Guides

Groups

Receive group traffic on an opt-in basis, send to any group the number belongs to, and manage membership and invite links.

Receiving group messages

Group traffic is off by default because it is noisy and most automations only want 1:1 chats. Enable per session:

POST https://api.meowsapp.com/set-enable-group-ai   { "clientId": "acmemain", "enabled": true }

From then on group messages arrive as normal webhook events with isGroup: true, remoteJid = the group, chatRoomId = <clientId>-<myLid>-<groupId>, and a group object identifying the sender:

event.group
{
  "jid": "120363012345678901@g.us",
  "subject": "Launch team",
  "participant": "123456789012345",
  "participantPhone": "60123456789",
  "participantUsername": "janelim"
}

Broadcast lists, status updates and channels are never delivered regardless of this setting.

Sending to a group

Any send route accepts a group JID in to. Mentions work as in 1:1 chats.

POST https://api.meowsapp.com/send-message   { "clientId": "acmemain", "to": "120363012345678901@g.us", "body": "Meeting moved to 4 pm.", "mentions": ["123456789012345"] }

Managing groups

POST /get-groups              { "clientId": "acmemain" }
POST /get-group-participants  { "clientId": "acmemain", "groupJid": "120363…@g.us" }
POST /create-group            { "clientId": "acmemain", "subject": "Project Alpha", "participants": ["+60123456789", "123456789012345"] }
POST /update-group-members    { "clientId": "acmemain", "groupJid": "120363…@g.us", "action": "add", "participants": ["+60198765432"] }
POST /group-invite-link       { "clientId": "acmemain", "groupJid": "120363…@g.us", "reset": false }
POST /leave-group             { "clientId": "acmemain", "groupJid": "120363…@g.us" }
  • subject is limited to 25 characters by WhatsApp.
  • action is one of add, remove, promote, demote; the session must be an admin for all but add in open groups.
  • /update-group-members returns a per-member status. A non-zero error is WhatsApp's code for that member — 403 means their privacy settings only let admins add them; send them the invite link instead.
  • reset: true on /group-invite-link revokes the old link and issues a new one.

Adding strangers to groups is a ban signal

Only add people who expect it. Prefer invite links for anything resembling marketing.

Who sent it?

Groups may address members by LID or phone (addressingMode on /get-group-participants). group.participant is always the sender's LID user-part; participantPhone and participantUsername are filled when WhatsApp reveals them. Reply privately withto: group.participant, or in the group with to: group.jid plus mentions: [group.participant].

Full endpoint details: Groups reference.