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 interacts with the Wassenger WhatsApp API to retrieve information about WhatsApp groups associated with a specified WhatsApp number (device). Specifically, the "Get Groups" operation under the "Groups" resource fetches group chats linked to the selected WhatsApp number.
Common scenarios where this node is beneficial include:
- Managing and monitoring WhatsApp group chats for customer support or community engagement.
- Automating workflows that require fetching group chat details for reporting or further processing.
- Integrating WhatsApp group data into CRM or marketing automation platforms.
For example, a user might use this node to list all active WhatsApp groups for a particular business phone number to analyze group activity or send targeted messages.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) from which to retrieve groups. |
| Filter by Kind | Filters groups by their type; options are: "Group" (regular group chats) and "Broadcast". |
| Results Page Size | Number of results to return per page when listing groups. |
| Page Number | The page number to retrieve, starting from 0, for paginated results. |
Note: The last three properties (Filter by Kind, Results Page Size, and Page Number) apply only to the operation that lists device group chats and may not be relevant for the basic "Get Groups" operation.
Output
The node outputs an array of JSON objects representing the groups retrieved from the Wassenger API. Each object contains details about a WhatsApp group associated with the specified WhatsApp number. The exact structure depends on the API response but typically includes group identifiers, names, types (group or broadcast), and possibly metadata such as participant counts or timestamps.
If the node supports binary data output (not indicated in the provided code), it would represent media or files related to groups, but this is not evident here.
Dependencies
- Requires an API key credential for authenticating with the Wassenger WhatsApp API.
- The node depends on the Wassenger service being accessible and properly configured.
- The "WhatsApp Number" property requires loading available devices via a method named
getDevices(likely implemented elsewhere in the node's codebase).
Troubleshooting
Common Issues:
- Invalid or missing API key will cause authentication failures.
- Specifying a WhatsApp number (device) that does not exist or is not linked to the Wassenger account will result in no groups returned or errors.
- Pagination parameters (
sizeandpage) must be valid numbers; otherwise, the API may reject the request.
Error Messages:
- Errors from the Wassenger API will be caught and can appear in the output if "Continue On Fail" is enabled.
- Typical error messages include authentication errors, invalid parameter errors, or network connectivity issues.
Resolutions:
- Ensure the API key credential is correctly set up in n8n.
- Verify the WhatsApp number/device ID is correct and active.
- Use valid numeric values for pagination parameters.
- Check network connectivity and Wassenger service status.
Links and References
- Wassenger Official Website
- Wassenger API Documentation (for detailed API endpoints and parameters)
- n8n Documentation on Creating Custom Nodes