WAHA API icon

WAHA API

Complete WhatsApp automation with WAHA API - Multi-engine support
Join our community

Actions55

Overview

This node integrates with the WAHA API to manage WhatsApp contacts and retrieve information about them. Specifically, the "Get Contact About" operation fetches the "about" or status message of a specified WhatsApp contact. This is useful for workflows that need to display or process contact status information, such as customer support bots checking user statuses or marketing automations personalizing messages based on contact info.

Practical examples:

  • Retrieve a contact's status message before sending a personalized greeting.
  • Monitor changes in contact statuses for analytics or notifications.
  • Use contact "about" info to filter or segment contacts in automated campaigns.

Properties

Name Meaning
Session Name The name of the WhatsApp session to use (defaults to a configured default session).
Chat ID The WhatsApp chat ID of the contact, typically a phone number with @c.us suffix.
Additional Fields Optional extra parameters; not used specifically for this operation but available generally.

Output

The node outputs JSON data containing the response from the WAHA API about the contact's "about" or status information. The exact structure depends on the API response but typically includes fields like the contact's status text and possibly metadata related to the contact.

No binary data output is involved in this operation.

Example output snippet (conceptual):

{
  "status": "Hey there! I am using WhatsApp.",
  "lastUpdated": "2024-06-01T12:34:56Z",
  "contactId": "5511999999999@c.us"
}

Dependencies

  • Requires an active WAHA API credential with a valid base URL and API key.
  • Optionally uses an additional API key credential for N8N Tools API validation.
  • The node requires configuration of a WhatsApp session name that corresponds to an active WhatsApp session managed by WAHA.
  • Network access to the WAHA API endpoint.

Troubleshooting

  • Invalid Credentials: If the node throws errors related to authentication, verify that the WAHA API key and session name are correct and active.
  • Contact Not Found: Ensure the Chat ID is correctly formatted (e.g., 5511999999999@c.us) and that the contact exists in the WhatsApp session.
  • API Validation Errors: The node performs a validation call to an external API service; failures here may indicate subscription or API key issues.
  • Unknown Operation or Resource: Using unsupported operations or resources will cause errors; confirm the selected operation is "Get Contact About" under the "Contact" resource.
  • Network Issues: Connectivity problems to the WAHA API endpoint can cause request failures.

Links and References

  • WAHA API Documentation (replace with actual URL if available)
  • WhatsApp Business API concepts for contact management
  • n8n documentation on creating custom nodes and using credentials

Discussion