Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

This node, named "Evolution API," allows users to interact with the Evolution API service. Specifically, for the Message resource and the Send Contact operation, it enables sending one or multiple contact cards via a messaging platform (likely WhatsApp based on property names). This is useful in scenarios where automated workflows need to share contact information dynamically, such as customer support bots sending agent contacts, marketing campaigns sharing sales contacts, or internal tools distributing team member details.

Practical examples:

  • Automatically send a list of company representatives' contact cards to new customers.
  • Share event speaker contact details through a messaging channel.
  • Distribute emergency contact information to a group of users.

Properties

Name Meaning
Name Da Instância The name of the instance that will send the contact message.
Número Do Destinatário The recipient's phone number in string format (likely including country code).
Contatos A list of contacts to send. Each contact includes:
- Name Completo: Full name of the contact.
- Número Do WhatsApp: WhatsApp number (digits only, e.g., 559999999999).
- Número Formatado: Formatted phone number (e.g., +55 99 9 9999-9999).
- Organização: Organization or company name associated with the contact.
- Email: Email address of the contact.
- URL: URL related to the contact (e.g., personal or company webpage).

Output

The node outputs a JSON array containing the response from the Evolution API after attempting to send the contact(s). The exact structure depends on the API response but typically includes status information about the sent message(s).

If binary data were involved (e.g., media files), it would be included in the output, but this operation focuses on sending contact information, so no binary output is expected.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API service.
  • The node expects the Evolution API base URL and headers to be configured internally.
  • No additional external dependencies are indicated beyond the Evolution API itself.

Troubleshooting

  • Operation not supported error: If you select an unsupported operation or resource, the node throws an error indicating the function is not supported. Ensure you use valid combinations of resource and operation.
  • Missing required properties: The node requires certain fields like instance name, recipient number, and contact details. Omitting these will likely cause errors.
  • API authentication failures: Incorrect or missing API credentials will prevent successful requests.
  • Invalid phone number formats: Ensure phone numbers follow the expected format (digits only for WhatsApp ID, properly formatted for display).
  • Empty contact list: Sending without any contacts defined may result in no action or errors.

Links and References

Discussion