Evolution API icon

Evolution API

Complete WhatsApp automation with Evolution API
Join our community

Actions48

Overview

This node enables sending a contact card message via WhatsApp using the Evolution API. It is part of a broader WhatsApp automation toolset that supports various messaging and management operations.

The Send Contact operation allows users to share contact information directly in a WhatsApp chat by specifying the recipient's phone number and optional additional parameters such as delay before sending, quoting a previous message, enabling link previews, or mentioning other contacts.

Practical scenarios include:

  • Automatically sharing customer support contact cards during conversations.
  • Sending business contact details in bulk campaigns.
  • Replying with contact info linked to specific messages for clarity.

Properties

Name Meaning
Phone Number The recipient's phone number including country code but without the "+" sign (e.g., 5511999999999).
Additional Fields Optional extra settings:
• Delay: Time in milliseconds to wait before sending the contact.
• Link Preview: Enable or disable link preview in the message.
• Quoted Message ID: ID of a message to quote or reply to.
• Mentions: Comma-separated list of phone numbers to mention in the message.

Output

The node outputs a JSON object representing the response from the Evolution API after attempting to send the contact card. This typically includes status information about the message delivery or any errors encountered.

The output structure is:

{
  "json": {
    // API response fields indicating success or failure details
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Evolution API service.
  • Needs valid credentials including:
    • Base URL of the Evolution API.
    • API key for authentication.
    • Instance name identifying the WhatsApp instance.
  • Optionally integrates with an auxiliary API ("N8N Tools API") for subscription validation.
  • Proper configuration of these credentials within n8n is necessary for successful execution.

Troubleshooting

  • Invalid Credentials or Subscription Errors:
    If the node throws errors related to invalid API keys or subscription issues, verify that the provided API keys are correct and that your subscription to the Evolution API service is active.

  • Unknown Operation or Resource Errors:
    These occur if the operation or resource parameters are misconfigured. Ensure the "Resource" is set to "Message" and "Operation" to "Send Contact".

  • Network or API Endpoint Issues:
    Failures connecting to the API endpoint may indicate network problems or incorrect base URLs. Confirm the Evolution API base URL is reachable and correctly configured.

  • Message Delivery Failures:
    If the contact card does not reach the recipient, check the phone number format (country code included, no plus sign) and ensure the recipient is available on WhatsApp.

  • Delay Parameter Misuse:
    Setting an excessively long delay might cause unexpected behavior; use reasonable values.

Links and References

Discussion