Actions21
Overview
The "List Groups" operation of the DinastiAPI AI node retrieves a comprehensive list of WhatsApp groups associated with the authenticated account. It fetches metadata such as group names, descriptions, participant counts, and admin status. This operation is useful for scenarios where you need to manage or analyze WhatsApp groups programmatically, such as automating group monitoring, generating reports on group activity, or integrating group data into other workflows.
For example, a business could use this operation to automatically gather all active WhatsApp groups they manage, then filter or process these groups based on participant counts or other metadata to target communications or perform analytics.
Properties
| Name | Meaning |
|---|---|
| Ignore Participants | Whether to ignore participant details for better performance (groups will still be listed but without participant information). |
| Optimize Response | Whether to optimize the response to reduce token usage and improve AI processing. |
| Max Response Length | Maximum number of characters in the response. Responses will be truncated if longer. |
| Include Only Essential Fields | Whether to include only essential fields in the response to reduce noise. |
| Response Format | How to format the response for optimal AI agent understanding. Options: - Optimized: Clean, structured response optimized for AI processing - Raw: Complete raw response from the API - Summary: Brief summary with key information only |
Output
The output JSON contains the response from the WhatsApp API endpoint /group/list. This includes an array of group objects with metadata such as group names, descriptions, participant counts, and admin status.
If the "Ignore Participants" property is set to true, participant details are omitted to improve performance.
When "Optimize Response" is enabled, the output may be truncated to the first 10 groups and marked with metadata indicating it was optimized for AI processing, including original and returned counts and the reason for truncation.
No binary data is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the DinastiAPI WhatsApp service.
- The node uses the DinastiAPI HTTP endpoints to fetch group data.
- No additional environment variables or external services are explicitly required beyond the configured API credential.
Troubleshooting
- Error: Unknown operation — This error occurs if an unsupported operation name is provided. Ensure the operation is set to "listGroups".
- Performance issues when fetching large group lists — Use the "Ignore Participants" option to exclude participant details and improve response time.
- Response too large for AI processing — Enable "Optimize Response" to truncate and simplify the output for better handling by AI agents.
- Missing or invalid API credentials — Verify that the API key credential is correctly configured and has access rights to retrieve group information.
Links and References
- DinastiAPI GitHub Repository - Official documentation and source code for the DinastiAPI WhatsApp integration.