Evolution API icon

Evolution API

Complete WhatsApp automation with Evolution API
Join our community

Actions48

Overview

This node integrates with the Evolution API to automate WhatsApp contact-related actions. Specifically, for the Contact resource and the Get Profile Picture operation, it retrieves the profile picture URL of a specified WhatsApp contact by their phone number.

This functionality is useful in scenarios where you want to display or process a contact's profile picture within your workflow, such as:

  • Enriching customer data with their WhatsApp profile images.
  • Automatically fetching profile pictures for contact verification or display in CRM systems.
  • Archiving or backing up contact profile pictures.

Properties

Name Meaning
Phone Number The target contact's phone number including country code (without the "+" sign).
Additional Fields Optional extra parameters (not used specifically in this operation but available generally):
- Delay: Wait time before sending.
- Link Preview: Enable/disable link preview.
- Quoted Message ID: ID of message to reply to.
- Mentions: Comma-separated list of numbers to mention.

Output

The node outputs JSON data containing the response from the Evolution API for the profile picture request. Typically, this includes the URL or metadata of the contact's profile picture.

Example output structure:

{
  "json": {
    "profilePictureUrl": "https://example.com/path/to/profile-picture.jpg"
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Evolution API service.
  • Needs valid credentials including:
    • Base URL of the Evolution API.
    • API key for authentication.
    • Instance name identifying the WhatsApp instance.
  • Optionally uses another API ("N8N Tools API") for subscription validation.
  • Proper configuration of these credentials in n8n is necessary.

Troubleshooting

  • Invalid Credentials or Subscription Errors:
    If the node throws errors related to invalid API keys or subscription issues, verify that the API keys and subscription status are correct and active.

  • Unknown Resource or Operation Errors:
    These indicate misconfiguration of the resource or operation parameters. Ensure "Contact" is selected as the resource and "Get Profile Picture" as the operation.

  • Network or API Endpoint Issues:
    Failures connecting to the Evolution API may be due to incorrect base URLs, network restrictions, or downtime. Confirm endpoint accessibility.

  • Empty or Missing Profile Picture:
    If the returned profile picture URL is empty or missing, the contact might not have set a profile picture on WhatsApp.

Links and References

Discussion