N8N Tools - WhatsApp Enhanced icon

N8N Tools - WhatsApp Enhanced

Comprehensive WhatsApp Business API integration for N8N workflows
Join our community

Actions28

Overview

The node provides integration with the WhatsApp Business API via the N8N Tools service, enabling various WhatsApp-related operations within an n8n workflow. Specifically for the Webhooks - Verify Webhook operation, it verifies a webhook subscription by validating the provided verification mode, token, and challenge parameters against the WhatsApp API.

This verification step is essential when setting up WhatsApp webhooks to ensure that the webhook endpoint is correctly registered and trusted by WhatsApp. It is commonly used during initial webhook setup or when re-verifying webhook subscriptions.

Practical example:
When you configure a webhook URL in your WhatsApp Business API settings, WhatsApp sends a verification request containing a mode, token, and challenge. This node operation can be used to respond to that verification request programmatically, confirming the webhook subscription.

Properties

Name Meaning
Mode The webhook verification mode sent by WhatsApp (e.g., "subscribe").
Token The verification token to validate the webhook subscription.
Challenge The challenge string that must be echoed back to confirm webhook ownership.

Output

The output JSON contains two fields:

  • verified: A boolean indicating whether the webhook verification was successful (true if verified).
  • challenge: The challenge string that should be returned to WhatsApp as part of the verification response.

Example output:

{
  "verified": true,
  "challenge": "random_challenge_string"
}

This output confirms that the webhook has been successfully verified and includes the challenge string required by WhatsApp.

Dependencies

  • Requires an active subscription and valid API key credential for the N8N Tools API service.
  • The node internally uses the WhatsApp API client from the bundled whatsapp-api module.
  • No additional environment variables are explicitly required beyond the configured credentials.

Troubleshooting

  • Invalid subscription or API key error: If the node throws an error about invalid subscription or API key, verify that the API key credential is correct and active.
  • Verification failure: If the webhook verification fails (verified is false), ensure that the mode, token, and challenge values exactly match those sent by WhatsApp during webhook setup.
  • HTTP errors: Network issues or incorrect API URLs may cause HTTP request failures; check connectivity and credential configuration.

Links and References

Discussion