Evolution API icon

Evolution API

Complete WhatsApp automation with Evolution API
Join our community

Actions48

Overview

The "Unblock Contact" operation in the Evolution API node allows users to unblock a previously blocked WhatsApp contact by specifying their phone number. This is useful in scenarios where communication with a contact was intentionally paused or restricted and now needs to be resumed. For example, a business that had blocked a spammy customer can use this operation to restore messaging capabilities once the issue is resolved.

Properties

Name Meaning
Phone Number The phone number of the contact to unblock, including country code but without the "+" sign.
Additional Fields Optional extra parameters such as:
- Delay: Time in milliseconds to wait before sending the unblock request.
- Link Preview: Enable or disable link previews in messages (true/false).
- Quoted Message ID: ID of a message to quote or reply to when unblocking.
- Mentions: Comma-separated list of phone numbers to mention in the unblock context.

Output

The node outputs a JSON object containing the response from the Evolution API after attempting to unblock the contact. This typically includes status information about the unblock action, such as success confirmation or error details if the unblock failed.

If the operation fails and "Continue On Fail" is enabled, the output will contain an error message describing the failure.

No binary data is produced by this operation.

Dependencies

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

Troubleshooting

  • Invalid Credentials: If the API key or subscription is invalid, the node throws an error indicating invalid subscription or API key. Verify and update credentials accordingly.
  • Unknown Operation or Resource: Errors occur if the resource or operation names are incorrect or unsupported. Ensure "Contact" resource and "Unblock Contact" operation are selected.
  • Network Issues: Connectivity problems with the Evolution API endpoint may cause request failures. Check network access and API availability.
  • Missing Required Parameters: The phone number must be provided; otherwise, the node will fail. Confirm all required fields are filled.
  • API Rate Limits or Restrictions: If the API enforces rate limits, excessive requests might be rejected. Monitor usage and adjust workflow frequency.

Links and References

Discussion