Actions64
- Instancia Actions
- Mensagem Actions
- Grupo Actions
- Chat Actions
- Perfil Actions
- Evento Actions
- Integração Actions
Overview
This node, named "Evolution API," allows users to interact with the Evolution API service. Specifically, for the resource Mensagem and operation Enviar Contato, it sends one or more contact cards via WhatsApp to a specified recipient number. This is useful in scenarios where automated sharing of contact information is needed, such as customer support bots sending agent contacts, marketing campaigns distributing sales contacts, or any workflow requiring programmatic transmission of contact details over WhatsApp.
Example use cases:
- Automatically sending a list of company representatives' contact cards to a client after a form submission.
- Distributing event speaker contacts to attendees via WhatsApp.
- Sharing emergency contact information dynamically based on user requests.
Properties
| Name | Meaning |
|---|---|
| Nome Da Instância | The name of the instance that will send the contact message. |
| Número Do Destinatário | The WhatsApp number of the recipient who will receive the contact(s). |
| Contatos | A list of contacts to send. Each contact includes: |
| - Nome 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 of the contact. | |
| - Email: Contact's email address. | |
| - 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 generally includes confirmation of the sent message, status, and any relevant metadata.
If binary data were involved (not indicated here), it would typically represent media attachments; however, this operation focuses on sending contact information as structured data.
Dependencies
- Requires an active connection to the Evolution API service.
- Needs an API authentication token or key configured in n8n credentials (referred generically as "an API key credential").
- Internet access to reach
https://doc.evolution-api.com/api-reference.
Troubleshooting
Common issues:
- Invalid or missing instance name or recipient number will cause the operation to fail.
- Incorrectly formatted WhatsApp numbers may result in delivery errors.
- Missing required contact fields (full name, WhatsApp number, formatted number) will prevent sending.
- Network or authentication failures with the Evolution API can block message sending.
Error messages:
"Operação não suportada."indicates the requested operation-resource combination is not implemented; verify correct resource and operation selection.- API errors returned by the Evolution API usually include HTTP status codes and error messages; check API credentials and network connectivity.
Resolution tips:
- Ensure all required fields are filled correctly.
- Validate phone numbers follow expected formats.
- Confirm API credentials are valid and have necessary permissions.
- Test connectivity to the Evolution API endpoint.
Links and References
- Evolution API Documentation (official API reference)
- WhatsApp contact card format guidelines (consult WhatsApp Business API docs for contact message structure)