WAHA API icon

WAHA API

Complete WhatsApp automation with WAHA API - Multi-engine support

Overview

The "Get Contact" operation of the WAHA API node allows you to retrieve detailed information about a specific WhatsApp contact by their chat ID. This is useful for workflows that need to access contact details such as name, phone number, or other metadata associated with a WhatsApp user.

Common scenarios include:

  • Fetching contact details before sending personalized messages.
  • Verifying contact information in customer support automation.
  • Integrating WhatsApp contact data into CRM systems.

Example: You can input a WhatsApp chat ID like 5511999999999@c.us and get back the contact's profile information to use later in your workflow.

Properties

Name Meaning
Session Name The name of the WhatsApp session to use (defaults to the configured default session).
Chat ID The WhatsApp Chat ID of the contact to retrieve (e.g., phone number with @c.us).
Additional Fields A collection of optional fields; not specifically used for this operation but available generally.

Output

The output JSON contains the response from the WAHA API for the requested contact. It typically includes contact details such as:

  • Contact identifiers
  • Profile name
  • Status or about info (if available)
  • Profile picture URL or metadata

The exact structure depends on the WAHA API response but will be a JSON object representing the contact's data.

No binary data is output for this operation.

Dependencies

  • Requires an active WAHA API credential with a valid base URL and API key.
  • Requires an n8n Tools API credential for subscription validation.
  • The node uses HTTP requests to communicate with the WAHA API endpoints.
  • The WhatsApp session specified must be active and connected.

Troubleshooting

  • Invalid Credentials: If the WAHA API or n8n Tools API credentials are incorrect or expired, the node will throw authentication errors. Verify API keys and subscription status.
  • Unknown Contact: Providing an invalid or non-existent chat ID may result in errors or empty responses. Ensure the chat ID is correct and formatted properly (e.g., number@c.us).
  • Session Issues: If the specified WhatsApp session is not active or incorrectly named, the request will fail. Confirm the session name matches an active session.
  • API Errors: Network issues or API downtime can cause failures. Check connectivity and WAHA API status.

Links and References


This summary focuses on the "Get Contact" operation under the "Contact" resource as requested.

Discussion