WaliChat

Interact with WaliChat WhatsApp API

Actions148

Send messages Actions
- Send text message
- Send multimedia message
- Send scheduled message
- Send poll message
- Send votes in a poll
- Delete votes in a poll
- Send meeting event
- Send meeting confirmation
- Send location
- Send contacts
- Send reaction
- Send catalog product
- Forward message
Outbound Messages Actions
- Search Messages
- Get Message
- Update Message
- Delete Message
WhatsApp Numbers Actions
- Get Numbers
- Get Number by ID
- Create Number
- Update Number
- Delete Number
- Delete Chats
Groups Actions
- Get Groups
- Get Group
- Create Group
- Update Group
- Update Group Image
- Add Participants
- Update Participants
- Remove Participants
- Get Pending Members
- Approve Members
- Reject Members
- Get Invite Code
- Revoke Invite Code
- Join Group
- Leave Group
Channels Actions
- Get Channels
- Get Channel
- Create Channel
- Update Channel
- Update Channel Image
- Delete Channel
- Join Channel
- Search Channels
Chats Actions
- Get Chats
- Get Chat Details
- Send Typing Status
- Sync Device Chats
- Sync Chat Messages
- Update Chat Read Status
- Set Chat Status
- Get Group Participants
- Assign Chat
- Unassign Chat
- Create Chat Note
- Delete Chat Note
- Update Chat Labels
- Update Chat Attributes
- Archive Chat
- Unarchive Chat
- Delete Chat
- Bulk Update Chats
Chat Contacts Actions
- Get Contacts
- Get Contact Details
- Create Contact
- Update Contact
- Update Contact Metadata
- Upsert Contact Metadata
- Delete Contact
- Bulk Create Contacts
- Block Contacts
- Unblock Contacts
Chat Messages Actions
- Get Messages
- Get Message Details
- Get Message Delivery Info
- Edit Message
- Delete Message
Chat Files Actions
- Get Files
- Get File Details
- Download File
Team Actions
- Get Team Members
- Update Team Member
- Delete Team Members
- Get Device Team Members
- Create Team Member
- Grant Device Access
- Revoke Device Access
Labels Actions
- Get Labels
- Create Label
- Update Label
- Delete Label
Departments Actions
- Get Departments
- Create Department
- Update Department
- Delete Department
Files Actions
- Search Files
- Upload File
- Delete Files
- Get File Preview
- Download File
- Get File
- Update File
- Delete File
Quick replies Actions
- Get Quick Replies
- Create Quick Reply
- Update Quick Reply
- Delete Quick Replies
Queue Actions
- Get Queue Status
- Set Queue Status
- Route Queue
- Empty Queue
WhatsApp session Actions
- Sync session
- Start session
- Scan QR
- Reset session
- Reboot session
- Get session health
- Request Authentication Code
WhatsApp profile Actions
- Get Profile
- Update Profile
- Get Profile Image
- Update Profile Image
Business catalog Actions
- Get My Catalog
- Query Business Catalog
Campaigns Actions
- Get Campaigns
- Get Campaign
- Update Campaign Status
- Get Campaign Contacts
- Delete Campaign
Meeting Links Actions
- Get Meeting Links
- Create Meeting Link
- Delete Meeting Links
User Status Actions
- Get User Status
- Get User Status by ID
- Update User Status
- Delete User Status
Webhooks Actions
- Get Webhooks
- Create Webhook
- Get Webhook
- Update Webhook
- Delete Webhook
- Enable Webhook
- Get Webhook Logs
Other Actions
- Verify number exists
- Validate phone numbers
- Send API request

Chats → Get Group Participants

AI-generated

Overview

This node interacts with the WaliChat WhatsApp API to retrieve participants of a WhatsApp group chat. It is useful for scenarios where you need to manage or analyze group membership, such as identifying admins, filtering participants by contact status, or paginating through large groups.

Practical examples include:

Fetching all admins in a specific WhatsApp group to send targeted messages.
Filtering group participants who are saved contacts in your WhatsApp agenda.
Paginating through group members when dealing with very large groups.

Properties

Name	Meaning
WhatsApp Number	The ID of the WhatsApp number (device) from which to fetch the group participants. This identifies the WhatsApp account used for the operation.
Chat ID	The unique identifier of the chat group (e.g., `44736205357600000000@g.us` for a group). Specifies which group’s participants to retrieve.
Filters	Collection of filters to narrow down the participant list:
- Search	Text to 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 saved contacts 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 size).
- Page Number	Page number to retrieve, starting from 0 (for pagination).

Output

The output is an array of JSON objects representing the filtered group participants. Each participant object typically includes:

Participant identifiers (such as WhatsApp ID and phone number).
Role within the group (admin, owner, participant).
Contact information if requested and available (e.g., name, profile details).

If the "Include Contact Info" option is selected, additional contact details are included in each participant's data.

No binary data output is indicated for this operation.

Dependencies

Requires a valid API key credential for authenticating with the WaliChat WhatsApp API.
The node depends on the WaliChat API service being accessible.
The "WhatsApp Number" property must correspond to a configured and active WhatsApp device/account in WaliChat.
Pagination parameters require correct handling to navigate through large participant lists.

Troubleshooting

Common issues:
- Invalid or missing WhatsApp Number (device) ID will cause failures in fetching participants.
- Incorrect Chat ID format or non-existent group ID will result in errors or empty results.
- Overly restrictive filters may return no participants.
- Pagination parameters out of range may cause empty pages or errors.
Error messages:
- Errors related to authentication usually indicate missing or invalid API credentials.
- "Chat not found" or similar errors suggest incorrect Chat ID.
- Network or API downtime errors require checking WaliChat service status.
Resolutions:
- Verify the WhatsApp Number is correctly set and active.
- Confirm the Chat ID corresponds to an existing group.
- Adjust filters to be less restrictive if no results are returned.
- Ensure API credentials are valid and have necessary permissions.

Links and References

WaliChat API Documentation (example placeholder, replace with actual URL if known)
WhatsApp Group Chat IDs format explanation: phoneNumber@g.us indicates a group chat.
n8n documentation on pagination and filtering best practices.

WaliChatInstall