Maytapi icon

Maytapi

Integrate with Maytapi WhatsApp Unofficial API

Actions55

Group → Set Group Image

AI-generated

Overview

This node integrates with the Maytapi WhatsApp Unofficial API to manage WhatsApp groups and perform various group-related operations. Specifically, the "Set Group Image" operation allows users to update the profile picture of a WhatsApp group by providing the group's ID and a URL to the new image.

Common scenarios where this node is beneficial include:

  • Automating group management tasks such as updating group images based on events or campaigns.
  • Synchronizing group profile pictures across multiple groups from a central system.
  • Enhancing branding by programmatically setting group images without manual intervention.

Practical example:

  • A marketing team wants to update the WhatsApp group image for a promotional campaign. Using this node, they can set the group image URL dynamically based on the current campaign banner hosted on their website.

Properties

Name Meaning
Phone ID Source Select how to provide the Phone ID: either "From Credentials" (uses stored credentials) or "Custom" (enter manually).
Phone ID The WhatsApp instance Phone ID to use when "Custom" is selected as Phone ID Source.
Group ID The unique identifier of the WhatsApp group (conversation ID ending with @g.us).
Group Image URL The URL of the image to set as the group's profile picture. Recommended size is 512x512 pixels square.

Output

The node outputs a JSON object containing the response from the Maytapi API after attempting to set the group image. This typically includes success status and any relevant metadata returned by the API.

No binary data output is produced by this operation.

Example output structure:

{
  "success": true,
  "message": "Group image updated successfully",
  // ...additional API response fields
}

Dependencies

  • Requires an active Maytapi WhatsApp API account with valid API credentials including an API key and associated Phone ID.
  • The node expects the Phone ID either from stored credentials or provided manually.
  • Internet access to the Maytapi API endpoint (https://api.maytapi.com/api) and to the image URL provided.
  • Proper configuration of credentials in n8n for authentication with Maytapi.

Troubleshooting

  • Missing Phone ID: If neither credentials nor custom Phone ID is provided, the node will throw an error stating that the Phone ID is required. Ensure you have configured your credentials correctly or provide a custom Phone ID.
  • Invalid Group ID: Providing an incorrect or malformed Group ID (not ending with @g.us) may cause the API to reject the request.
  • Invalid Image URL: The image URL must be accessible and point to a valid image file. Broken links or unsupported formats may cause failures.
  • API Errors: Network issues or invalid API keys will result in errors from the Maytapi API. Verify your API key and network connectivity.
  • Image Size/Format: Although not enforced by the node, using non-square or very large images might lead to unexpected results on WhatsApp clients.

Links and References

Discussion