Evolution API

Overview

The Buscar Foto Do Perfil operation under the Chat resource of this custom n8n node interacts with the Evolution API to fetch the profile picture of a specified contact. This node is useful in scenarios where you need to retrieve and process user profile images from chat applications, such as for CRM enrichment, automated user verification, or displaying contact avatars in dashboards.

Practical examples:

• Automatically fetching and storing WhatsApp profile pictures for new leads.
• Displaying up-to-date contact photos in internal tools or customer support systems.
• Verifying if a contact has set a profile picture before sending personalized messages.

Properties

Output

The output will be a JSON object containing the result of the profile picture fetch operation. While the exact structure depends on the Evolution API's response, it typically includes:

{
  "profilePictureUrl": "https://example.com/path/to/profile-picture.jpg",
  "number": "5511999999999",
  // ...other metadata fields as provided by the API
}

• If the API returns binary data (such as the image itself), the node may output a reference to the binary file, but this is not explicitly detailed in the static code.

Dependencies

• External Service: Requires access to the Evolution API.
• API Key/Credentials: You must configure valid Evolution API credentials in n8n under the credential type evolutionApi.
• n8n Configuration: Ensure the node is properly configured with the required properties and credentials.

Troubleshooting

Common Issues:

• Missing or Invalid Credentials: If the Evolution API credentials are not set or are incorrect, authentication errors will occur.
• Unsupported Operation: If an unsupported resource or operation is selected, the node throws an error:
  "Operação não suportada."
  How to resolve: Double-check that you have selected the correct resource ("Chat") and operation ("Buscar Foto Do Perfil").
• Invalid Contact Number: If the contact number format is incorrect, the API may return an error or no results. Use the format countrycode+number (e.g., 5511999999999).

Error Messages:

• "A função \"{operation}\" para o recurso \"{resource}\" não é suportada!"
  Resolution: Ensure you are using a supported combination of resource and operation.

Links and References

• Evolution API Documentation
• n8n Documentation