Evolution API Direct icon

Evolution API Direct

Interact with Evolution API using direct URL and API Key

Actions64

Overview

The "Evolution API Direct" node allows users to interact with the Evolution API by specifying a direct server URL and an API key for authentication. It supports various resources and operations, including sending contact information as a message.

Specifically, the Mensagem - Enviar Contato operation enables sending one or more contacts to a specified WhatsApp recipient number through the Evolution API instance. This is useful in scenarios such as automating customer support, sharing contact cards in bulk, or integrating contact sharing into workflows.

For example, a user can configure this node to send a list of business contacts to a client’s WhatsApp number automatically after a form submission or CRM update.

Properties

Name Meaning
Server URL The full URL of your Evolution API server (e.g., https://api.exemplo.com).
API Key The API key credential for authenticating requests to the Evolution API instance.
Nome Da Instância The name of the Evolution API instance that will send the contact(s).
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 (optional).
- Email: Contact's email address (optional).
- URL: URL related to the contact (optional).

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).

No binary data output is indicated for this operation.

Dependencies

  • Requires access to an Evolution API server reachable via the provided Server URL.
  • Requires a valid API key credential for authentication.
  • The node expects the Evolution API instance name to identify which instance sends the contact.
  • Network connectivity to the Evolution API endpoint must be configured properly in n8n.

Troubleshooting

  • Common Issues:

    • Incorrect Server URL or API Key will cause authentication failures.
    • Invalid or improperly formatted WhatsApp numbers may result in message delivery errors.
    • Missing required fields like instance name or recipient number will prevent execution.

  • Error Messages:

    • "Operação não suportada." indicates the selected operation is not implemented or recognized; verify resource and operation names.
    • API errors returned from the Evolution API will be passed through; check the API documentation for error codes and meanings.

  • Resolutions:

    • Double-check all required parameters are filled correctly.
    • Ensure the API key has sufficient permissions.
    • Validate phone numbers follow the expected format.
    • Confirm the Evolution API instance name matches exactly what is configured on the server.

Links and References

Discussion