Actions64
- Instance Actions
- Chat Actions
- Message Actions
- Group Actions
- Profile Actions
- Event Actions
- Integration Actions
Overview
The node "Evolution API" allows interaction with the Evolution API service. Specifically, for the Message resource and Send Contact operation, it sends one or more contact cards to a specified recipient via WhatsApp. This is useful in scenarios where you want to programmatically share contact information through WhatsApp messages, such as sending business contacts, customer support details, or event attendee lists.
Practical examples:
- Automatically sending new customer contact cards to a sales team member.
- Sharing emergency contact details with a group of users.
- Distributing updated company directory contacts to employees.
Properties
| Name | Meaning |
|---|---|
| Instance Name | The name of the instance that will send the contact message. |
| Recipient Number | The WhatsApp number of the message recipient (in string format). |
| Contacts | A list of contacts to send. Each contact includes: |
| - Full Name | Full name of the contact. |
| - WhatsApp Number | WhatsApp number of the contact (numbers only, e.g., 559999999999). |
| - Formatted Number | Formatted phone number (e.g., +55 99 9 9999-9999). |
| - Organization | Name of the organization or company associated with the contact. |
| Email address of the contact. | |
| - URL | URL of the contact's webpage or profile. |
Output
The node outputs a JSON array containing the result of the send contact operation. Each item in the output corresponds to the response from the Evolution API after attempting to send the contact(s) to the specified recipient. The exact structure depends on the API response but generally includes status and confirmation details.
If binary data were involved (e.g., media files), it would be summarized here, but this operation focuses on sending contact information only.
Dependencies
- Requires an active connection to the Evolution API service.
- Needs an API authentication token or API key credential configured in n8n to authorize requests.
- The base URL for the API is
https://doc.evolution-api.com/api-reference. - Proper configuration of the "Instance Name" to identify the sending instance.
Troubleshooting
- Unsupported operation error: If the node throws an error about unsupported operations, verify that the Resource is set to "messages-api" and Operation to "send-contact".
- Missing required fields: Ensure all required properties like Instance Name, Recipient Number, and contact details are provided.
- Invalid phone numbers: Phone numbers must be correctly formatted; WhatsApp numbers should contain only digits without symbols.
- API authentication errors: Confirm that the API key or token is valid and has permissions to send contacts.
- Network issues: Check connectivity to the Evolution API endpoint.
Links and References
- Evolution API Documentation
- WhatsApp contact card format guidelines (refer to official WhatsApp Business API docs for contact card formatting)