WAHA

Connect with Whatsapp HTTP API

Actions116

Overview

This node operation promotes specified participants to admin status within a WhatsApp group. It is useful for managing group roles dynamically, such as elevating trusted members to admin for better group moderation. For example, a community manager can automate the promotion of active members to admin based on certain triggers.

Use Case Examples

  1. Promote a list of participants to admin in a specific WhatsApp group identified by its group ID.
  2. Use session credentials to authenticate and perform the promotion action securely.

Properties

Name Meaning
Session The session name used to authenticate and identify the WhatsApp session.
Id The unique identifier of the WhatsApp group where participants will be promoted to admin.
Participants A JSON array of participant objects, each containing an 'id' field representing the participant's WhatsApp ID to be promoted.
Request Options Optional settings to control request behavior such as batching, SSL certificate validation, proxy usage, and timeout settings.

Output

JSON

  • success - Indicates whether the promotion operation was successful.
  • promotedParticipants - List of participants who were successfully promoted to admin.
  • groupId - The ID of the group where the promotion took place.

Dependencies

  • Requires a valid WhatsApp session credential to authenticate API requests.

Troubleshooting

  • Ensure the session name is correct and active; invalid or expired sessions will cause authentication failures.
  • Verify the group ID is valid and the bot or user has permission to promote participants in the group.
  • Participants must be valid WhatsApp user IDs; malformed or non-existent IDs will cause errors.
  • If batching is enabled, ensure batch size and interval are set appropriately to avoid rate limiting or timeouts.
  • If SSL issues occur, consider enabling 'Ignore SSL Issues' only if you trust the network environment.

Discussion