N8N Tools - WhatsApp Enhanced icon

N8N Tools - WhatsApp Enhanced

Comprehensive WhatsApp Business API integration for N8N workflows
Join our community

Actions28

Overview

This node provides integration with the WhatsApp Business API via the N8N Tools platform, enabling a wide range of WhatsApp-related operations within n8n workflows. Specifically, for the Webhooks resource and the Subscribe to Webhook operation, it allows users to subscribe a given URL to receive WhatsApp webhook events.

Use cases include:

  • Automatically subscribing your application or service endpoint to WhatsApp webhook notifications.
  • Enabling real-time event handling such as message delivery updates, incoming messages, or status changes by receiving webhook callbacks.
  • Integrating WhatsApp event-driven data into broader automation workflows in n8n.

For example, you might use this node to register your server’s webhook URL so that whenever a user sends a message to your WhatsApp Business number, your workflow is triggered to process the message.

Properties

Name Meaning
Webhook URL The URL endpoint to subscribe to for receiving WhatsApp webhook events. This must be a publicly accessible URL where WhatsApp can send HTTP POST requests.

Output

The node outputs JSON data representing the response from the subscription request to the WhatsApp webhook service. The structure depends on the external API's response but generally includes confirmation details about the subscription status.

  • The output JSON will contain fields indicating success or failure of the subscription.
  • If the subscription is successful, it may include identifiers or metadata related to the webhook subscription.
  • In case of errors, the output will contain error messages describing what went wrong.

The node does not output binary data for this operation.

Dependencies

  • Requires an active subscription and valid API key credential for the N8N Tools API service.
  • The node uses the N8N Tools WhatsApp API wrapper internally to perform the subscription.
  • The webhook URL provided must be reachable by the WhatsApp servers (publicly accessible).
  • Proper configuration of credentials in n8n is necessary to authenticate API calls.

Troubleshooting

  • Invalid API Key or Subscription: If the node throws an error about invalid subscription or API key, verify that the API key credential is correctly configured and active.
  • Webhook URL Unreachable: Ensure the webhook URL is publicly accessible and can accept POST requests; otherwise, subscription may fail or webhook events won't be delivered.
  • Permission Errors: HTTP 401 or 403 errors indicate authentication issues; recheck credentials.
  • Malformed Webhook URL: Confirm the URL is properly formatted (including protocol https:// if required).
  • API Validation Failures: General validation errors from the API may require checking the parameters or contacting support.

Links and References

Discussion