Evolution API

Interagir com a Evolution API v2
Join our community

Actions53

Overview

This node integrates with the Evolution API v2 to perform various operations related to WhatsApp instances, messages, groups, chats, events, and integrations. Specifically, for the Chat resource and the Buscar Foto de Perfil (fetchProfilePictureUrl) operation, it allows users to retrieve the profile picture URL of a WhatsApp chat/contact.

Common scenarios where this node is beneficial include:

  • Automatically fetching and displaying profile pictures of contacts in customer support workflows.
  • Enriching contact data with profile images for CRM or marketing automation.
  • Verifying or logging profile pictures during chat interactions.

Practical example:

  • A user wants to fetch the profile picture URL of a WhatsApp contact before sending a personalized message or storing the image URL in a database.

Properties

Name Meaning
Instance Name The name of the WhatsApp instance to use for the operation. This identifies which instance the API call will target.

Output

The output JSON contains the response from the Evolution API regarding the profile picture URL of the specified chat/contact. It typically includes fields such as the URL of the profile picture or an indication if no picture is available.

Additionally, the output always includes:

  • success: A boolean indicating if the operation was successful.
  • timestamp: The ISO string timestamp when the operation was performed.

If the API returns no data, the node outputs a success message with a timestamp.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential configured in n8n to authenticate requests to the Evolution API.
  • The node uses HTTP requests to the Evolution API endpoints.
  • The user must have a valid WhatsApp instance registered and connected within the Evolution platform.

Troubleshooting

  • Common issues:

    • Invalid or missing instance name: Ensure the "Instance Name" property is correctly set and corresponds to an active instance.
    • Authentication errors: Verify that the API key credential is properly configured and has necessary permissions.
    • No profile picture found: The contact may not have a profile picture set on WhatsApp; handle empty or null responses gracefully.

  • Error messages:

    • Errors thrown by the API are caught and returned as error messages in the output if "Continue On Fail" is enabled.
    • Network or authentication failures will cause the node to throw errors unless "Continue On Fail" is enabled.

Links and References

Discussion