N8N Tools - Uazapi icon

N8N Tools - Uazapi

Complete Uazapi integration - Premium WhatsApp API with advanced messaging and automation

Actions37

Overview

The node provides integration with a premium WhatsApp API service, enabling advanced messaging and contact management automation within n8n workflows. Specifically, the Block Contact operation under the Contact resource allows users to block a WhatsApp contact by their phone number. This is useful in scenarios where you want to prevent receiving messages or interactions from specific contacts automatically, such as blocking spam numbers or managing communication preferences programmatically.

Practical examples:

  • Automatically block contacts who send unwanted messages.
  • Integrate with CRM systems to block contacts flagged for compliance reasons.
  • Use in customer support workflows to manage blocked users dynamically.

Properties

Name Meaning
Phone Number The WhatsApp phone number of the contact to block, including country code (e.g., 5511999999999).
Additional Fields Optional extra parameters that can be set when blocking the contact:
- Reply to Message ID: ID of a message to reply to (not typically used in block operation).
- Delay (seconds): Delay before executing the block action.
- Disable Link Preview: Whether to disable link previews in messages (not relevant here).
- Mention Users: Comma-separated phone numbers to mention (not relevant here).

Note: For the Block Contact operation, only the "Phone Number" is strictly required; additional fields are available but may not affect this operation.

Output

The node outputs a JSON object containing the response from the WhatsApp API proxy service after attempting to block the contact. The structure generally includes status information about the block request, such as success confirmation or error details.

Example output JSON structure (simplified):

{
  "status": "success",
  "message": "Contact blocked successfully",
  "data": {
    "number": "5511999999999"
  }
}

If an error occurs, the output JSON will contain an error field describing the issue.

The node does not output binary data.

Dependencies

  • Requires an active connection to the premium WhatsApp API service via an API key credential.
  • Needs configuration of API URL, API token, and instance ID credentials within n8n.
  • Uses an internal proxy endpoint (https://n8ntools.io/api/v1/proxy/uazapi) to forward requests securely.
  • The user must have valid credentials and permissions to perform contact blocking on the WhatsApp instance.

Troubleshooting

  • Common issues:

    • Invalid or missing phone number format: Ensure the phone number includes the country code without spaces or special characters.
    • Authentication errors: Verify that the API key, token, and instance ID credentials are correctly configured and valid.
    • Network or proxy errors: Check connectivity to the proxy service and the WhatsApp API endpoint.
    • Permission denied: The WhatsApp instance might restrict blocking contacts; confirm account permissions.

  • Error messages:

    • "Invalid phone number": Confirm the phone number format matches WhatsApp requirements.
    • "Unauthorized" or "Authentication failed": Recheck API credentials.
    • "Contact not found": The specified number may not exist on WhatsApp or is already blocked.
    • "Rate limit exceeded": Too many requests sent in a short time; implement delays or retries.

Resolving these usually involves correcting input data, updating credentials, or contacting the WhatsApp API provider for access issues.

Links and References

Discussion