Actions15
Overview
The "Update Participants" operation of the DinastiAPI Group node allows managing participants within a WhatsApp group. It supports adding new participants, removing existing ones, promoting participants to admin status, and demoting admins back to regular participants. This operation is useful for automating group membership management in WhatsApp groups, such as onboarding new members, moderating group access, or adjusting administrative roles dynamically.
Practical examples include:
- Automatically adding new customers or team members to a support or project group.
- Removing inactive or unauthorized users from a group.
- Promoting trusted members to admin to help moderate the group.
- Demoting admins who no longer require elevated privileges.
Properties
| Name | Meaning |
|---|---|
| Group JID | The unique identifier (JID) of the WhatsApp group where participants will be managed. |
| Action | The participant action to perform: Add, Remove, Promote, or Demote participants. |
| Phone Numbers | Comma-separated list of phone numbers or JIDs representing the participants to update. |
Output
The node outputs JSON data reflecting the result of the participant update request. This typically includes confirmation of the performed action and details about the affected participants or any errors encountered.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the DinastiAPI service.
- Depends on the external DinastiAPI WhatsApp API to perform group participant management.
- The node expects valid WhatsApp group JIDs and participant phone numbers formatted correctly.
Troubleshooting
- Invalid Group JID: If the provided group JID is incorrect or does not exist, the API call will fail. Verify the group JID format and existence.
- Incorrect Phone Number Format: Phone numbers must be validated and properly formatted. Use international format without spaces or special characters.
- Permission Errors: Attempting to promote or demote participants without sufficient permissions may cause errors. Ensure the API user has admin rights in the group.
- Empty Participant List: Providing an empty or malformed list of phone numbers will result in failure. Always supply at least one valid participant.
- Binary Property Not Found: Although not applicable here, other operations involving images may throw errors if expected binary data is missing.
To resolve errors, check input parameters carefully, ensure API credentials are valid, and confirm that the targeted WhatsApp group and participants exist and are accessible.
Links and References
- DinastiAPI Documentation (for detailed API usage and authentication)
- WhatsApp Group Management Concepts: https://faq.whatsapp.com/general/chats/about-groups/