WAHA API icon

WAHA API

Complete WhatsApp automation with WAHA API - Multi-engine support

Overview

This node integrates with the WAHA API to manage WhatsApp groups and perform various group-related operations. Specifically, the "Get Group Invite Code" operation retrieves the invite code for a specified WhatsApp group. This is useful when you want to programmatically obtain the invite link/code to share with others, enabling them to join the group easily.

Practical scenarios include:

  • Automating the distribution of group invite links in marketing or community management workflows.
  • Integrating WhatsApp group management into CRM or customer support systems.
  • Monitoring or auditing group invite codes as part of administrative tasks.

Properties

Name Meaning
Session Name The name of the WhatsApp session to use (defaults to a configured default session).
Chat ID The WhatsApp group ID for which to get the invite code (e.g., groupid@g.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 "Get Group Invite Code" request. It typically includes the invite code or link associated with the specified group. The exact structure depends on the WAHA API response but will be accessible under the json property of the output item.

No binary data is produced by this operation.

Dependencies

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

Troubleshooting

  • Invalid Credentials: If the WAHA API key or session name is incorrect, the node will fail. Verify credentials and session status.
  • Unauthorized Errors: The node performs a subscription validation call to the n8n Tools API. Errors like 401 or 403 indicate invalid or expired API keys.
  • Unknown Resource or Operation: If the resource or operation parameters are misconfigured, the node throws errors indicating unknown resource or operation.
  • Group Not Found: If the provided Chat ID does not correspond to a valid group, the API may return an error or empty result.
  • Network Issues: Ensure the WAHA API endpoint is reachable from the n8n environment.

Links and References

Discussion