Maytapi icon

Maytapi

Integrate with Maytapi WhatsApp Unofficial API

Actions55

Group → Promote Admin

AI-generated

Overview

The node integrates with the Maytapi WhatsApp Unofficial API to perform various WhatsApp-related actions. Specifically, for the Group - Promote Admin operation, it promotes a specified group participant to an admin role within a WhatsApp group.

This operation is useful in scenarios where you manage WhatsApp groups programmatically and need to elevate certain members to admin status automatically, such as when onboarding new moderators or managing permissions dynamically.

Practical example:
You have a WhatsApp group for customer support, and whenever a new team member joins, you want to promote them to admin so they can manage the group settings and participants without manual intervention.

Properties

Name Meaning
Phone ID Source Select how to provide the Phone ID: either "From Credentials" (default) or "Custom".
Phone ID The custom Phone ID of your WhatsApp instance (required if "Custom" is selected).
Group ID The unique identifier of the WhatsApp group (conversation ID ending with @g.us).
Participant Number The phone number of the participant to promote (without the @c.us suffix).

Output

The node outputs a JSON object representing the response from the Maytapi API after attempting to promote the participant to admin. This typically includes success confirmation or error details.

No binary data output is involved in this operation.

Example output JSON structure:

{
  "success": true,
  "message": "Participant promoted to admin successfully"
}

or in case of failure:

{
  "error": "Participant not found in group"
}

Dependencies

  • Requires an active Maytapi WhatsApp API account with valid API credentials.
  • The node expects an API key credential that includes a Phone ID unless a custom Phone ID is provided.
  • Network access to https://api.maytapi.com/api is required.
  • Proper configuration of credentials in n8n with the necessary API authentication token and optionally the default Phone ID.

Troubleshooting

  • Missing Phone ID Error:
    If neither credentials nor custom Phone ID is provided, the node throws an error:
    "Phone ID is required. Please provide it in credentials or select custom Phone ID."
    Resolution: Provide a valid Phone ID either in credentials or via the custom input.

  • Invalid Group ID or Participant Number:
    Errors may occur if the Group ID or participant number is incorrect or the participant is not part of the group.
    Resolution: Verify the Group ID format (should end with @g.us) and ensure the participant's phone number is correct and belongs to the group.

  • API Request Failures:
    Network issues or invalid API keys will cause request failures.
    Resolution: Check API credentials, network connectivity, and Maytapi service status.

  • Permission Issues:
    The API user must have sufficient rights to promote admins in the target group.
    Resolution: Confirm that the WhatsApp instance has admin privileges in the group.

Links and References

This summary covers the logic and usage of the "Promote Admin" operation under the "Group" resource in the Maytapi node for n8n.

Discussion