Actions148
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Files Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
Overview
This node operation retrieves participants of a WhatsApp group chat using the Wassenger WhatsApp API. It is useful for scenarios where you need to manage or analyze group members, such as identifying admins, filtering participants by contact status, or paginating through large groups.
Practical examples include:
- Fetching all admins in a group to send targeted messages.
- Filtering participants who are saved contacts in your WhatsApp agenda.
- Searching for specific participants by name or phone number within a group.
- Paginating results when dealing with very large groups.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) from which to retrieve the group participants. This identifies the WhatsApp account used for the API call. |
| Chat ID | The unique identifier of the group chat (e.g., 44736205357600000000@g.us). |
| Filters | Collection of filters to narrow down the participant list: |
| - Search | Search participants by name, phone number, or WhatsApp ID. |
| - Phone Numbers | Filter participants by one or more phone numbers. |
| - Role | Filter participants by their role in the group. Options: Admin, Owner, Participant. |
| - Only Contacts | Boolean flag to filter only participants that are contacts saved in the WhatsApp agenda. |
| - Include Contact Info | Optionally include detailed contact information for each participant if available. |
| - Results Page Size | Maximum number of results to return per page (pagination). |
| - Page Number | Page number to retrieve, starting from 0 (pagination). |
Output
The output JSON contains an array of participant objects matching the specified filters and pagination settings. Each participant object typically includes:
- Participant identifier (WhatsApp ID).
- Role in the group (admin, owner, participant).
- Contact information if requested and available (such as name, phone number).
- Other metadata related to the participant's status in the group.
No binary data output is expected from this operation.
Dependencies
- Requires an active Wassenger WhatsApp API key credential configured in n8n.
- The node depends on the Wassenger API service to fetch group participant data.
- Proper permissions and access rights on the WhatsApp number (device) are necessary to query group details.
Troubleshooting
Common issues:
- Invalid or missing WhatsApp number (device) ID can cause failures.
- Incorrect or malformed Chat ID will result in errors or empty results.
- Insufficient permissions on the WhatsApp number to access group info.
- API rate limits or connectivity issues with the Wassenger service.
Error messages:
- Errors indicating "chat not found" usually mean the Chat ID is incorrect or the device does not have access.
- Authentication errors suggest problems with the API key credential.
- Pagination parameters out of range may cause empty responses or errors.
Resolutions:
- Verify the WhatsApp number and Chat ID values.
- Ensure the API key is valid and has required scopes.
- Adjust pagination parameters to valid ranges.
- Check network connectivity and Wassenger service status.