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 a comprehensive integration with the WhatsApp Business API via the N8N Tools platform. Specifically, for the Contacts resource and the Get Contact Info operation, it retrieves detailed information about a WhatsApp contact based on their phone number.

Common scenarios where this node is beneficial include:

  • Enriching customer data by fetching up-to-date contact details before sending messages.
  • Validating if a phone number corresponds to an active WhatsApp user.
  • Automating workflows that require personalized communication based on contact info.

Practical example:

  • Before sending a promotional message, use this node to get the contact's profile name and status to customize the greeting or decide whether to proceed.

Properties

Name Meaning
Phone Number The target contact's phone number in international format (e.g., 5511999999999). Required to identify which contact's info to retrieve.

Output

The node outputs JSON data containing the contact information retrieved from the WhatsApp Business API. This typically includes fields such as the contact's profile name, WhatsApp ID, and possibly other metadata related to the contact.

The output structure is an array of items, each with a json property holding the contact info object. Each item corresponds to one input execution.

No binary data output is produced by this operation.

Example output snippet (conceptual):

{
  "profile": {
    "name": "John Doe"
  },
  "wa_id": "5511999999999",
  "status": "active"
}

Dependencies

  • Requires valid credentials for the N8N Tools API and WhatsApp API authentication configured in n8n.
  • The node internally validates the subscription and API key against the N8N Tools API before executing operations.
  • Network access to the WhatsApp Business API endpoints via the N8N Tools platform is necessary.

Troubleshooting

  • Invalid subscription or API key error: If you receive an error indicating invalid subscription or API key, verify that your API credentials are correctly set up and have the required permissions.
  • Contact not found or empty response: Ensure the phone number is in the correct international format without spaces or special characters.
  • HTTP request failures: Check network connectivity and that the N8N Tools API service is reachable.
  • JSON parsing errors: Input parameters like phone numbers must be properly formatted strings; malformed inputs can cause failures.

Links and References

Discussion