Actions37
- Message Actions
- Media Actions
- Contact Actions
- Group Actions
- Instance Actions
- Webhook Actions
Overview
The "Promote Admin" operation within the Group resource of this node allows users to promote one or more participants in a WhatsApp group to admin status. This is useful for managing group permissions dynamically, such as when you want to delegate administrative control to trusted members without leaving the group or creating a new one.
Practical scenarios include:
- Automatically promoting certain users to admin after they join a group.
- Managing group roles programmatically in large communities or customer support groups.
- Integrating with workflows that adjust group admins based on external triggers or events.
Properties
| Name | Meaning |
|---|---|
| Group ID | The unique identifier of the WhatsApp group where participants will be promoted to admin. |
| Participants | Comma-separated list of phone numbers (with country code) representing participants to promote. Example: 5511999999999,5511888888888 |
| Additional Fields | Optional extra parameters including: |
| - Reply to Message ID: ID of a message to reply to | |
| - Delay (seconds): Delay before sending the promotion command | |
| - Disable Link Preview: Whether to disable link previews in messages | |
| - Mention Users: Comma-separated phone numbers to mention in the message |
Output
The node outputs a JSON object containing the response from the WhatsApp API proxy service regarding the promotion request. This typically includes confirmation of success or details about any errors encountered.
The output structure is:
{
"json": {
// API response data confirming promotion or error details
},
"pairedItem": {
"item": <index_of_input_item>
}
}
No binary data is produced by this operation.
Dependencies
- Requires an active connection to the Uazapi WhatsApp API service.
- Needs credentials including an API key, API token, instance ID, and API URL configured in n8n.
- The node sends requests through a proxy endpoint at
https://n8ntools.io/api/v1/proxy/uazapi. - Proper WhatsApp group IDs and participant phone numbers must be provided.
Troubleshooting
- Invalid Group ID: If the group ID is incorrect or the bot is not part of the group, the API will return an error. Verify the group ID and ensure the WhatsApp instance has access.
- Invalid Participant Numbers: Phone numbers must be in international format without spaces or special characters. Incorrect formatting may cause failures.
- Permission Errors: The WhatsApp instance must have permission to manage the group. If the instance is not an admin, promotion requests will fail.
- API Authentication Issues: Ensure the API key, token, and instance ID are correctly set and valid.
- Rate Limits or Delays: Using the delay field can help avoid hitting rate limits if promoting many participants at once.
Common error messages usually come from the underlying WhatsApp API and will be included in the output JSON under an error property if the node is set to continue on failure.