Wappfy icon

Wappfy

Interact with WhatsApp through Wappfy API

Actions76

Overview

This node allows you to interact with WhatsApp groups via the Wappfy API, specifically enabling you to set or update the picture of a WhatsApp group. This operation is useful when you want to programmatically change the group's display image, for example, to reflect a new event, branding, or theme.

Typical use cases include:

  • Automatically updating group pictures based on external triggers or schedules.
  • Managing multiple WhatsApp groups' images in bulk from an automation workflow.
  • Integrating with other systems that provide image URLs to keep group pictures up-to-date.

Properties

Name Meaning
Group ID The unique identifier of the WhatsApp group whose picture you want to set or update.
File URL The URL of the image file to be used as the new group picture. Must be accessible online.

Output

The node outputs the JSON response returned by the Wappfy API after setting the group picture. This typically includes confirmation details about the updated group picture or any relevant metadata returned by the API.

The output structure is:

{
  "json": {
    // API response data confirming the picture update
  }
}

No binary data output is involved in this operation.

Dependencies

  • Requires a valid connection to the Wappfy API, including:

    • Base URL of the Wappfy API instance.
    • Instance name (session identifier).
    • An API key credential for authentication.

  • The node sends HTTP PUT requests to the Wappfy API endpoint to update the group picture.

  • The image must be accessible via the provided URL; the node does not upload files directly but references the URL.

Troubleshooting

  • Invalid Group ID: If the group ID is incorrect or the bot/user does not have permission to modify the group, the API will return an error. Verify the group ID and permissions.

  • File URL Issues: The file URL must be publicly accessible and point directly to an image file. If the URL is invalid, inaccessible, or points to a non-image resource, the operation will fail.

  • Authentication Errors: Ensure the API key and instance name are correctly configured in the node credentials. Authentication failures will prevent the request from succeeding.

  • API Endpoint Errors: Network issues or incorrect base URL configuration can cause request failures. Confirm the base URL and network connectivity.

  • Error Handling: If the node is set to continue on failure, errors will be included in the output JSON under an error field for each failed item.

Links and References

This summary focuses exclusively on the "Group" resource with the "Set Picture" operation as requested.

Discussion