WaAPI icon

WaAPI

Interact with WaAPI API

Actions85

Overview

This node operation allows you to add a participant to a WhatsApp group using the WaAPI service. It is useful in scenarios where you want to programmatically manage group memberships, such as automating the addition of users to groups for marketing campaigns, community management, or customer support groups.

For example, you can use this node to automatically add new customers to a WhatsApp group after they sign up on your platform, or to include team members into project-specific groups without manual intervention.

Properties

Name Meaning
Id The instance ID representing the specific WhatsApp session or connection to use.
Chat Id The unique identifier of the WhatsApp group chat to which the participant will be added. Format example: <group_id>@g.us.
Participant The WhatsApp identifier of the user to add to the group. Format example: <user_number>@c.us.

Output

The node outputs JSON data that reflects the response from the WaAPI service after attempting to add the participant to the group. This typically includes confirmation of success or details about any error encountered.

No binary data output is expected from this operation.

Dependencies

  • Requires an active API key credential for the WaAPI service.
  • The node depends on the external WaAPI REST API endpoint at https://waapi.app/api/v1.
  • Proper configuration of the API key credential within n8n is necessary for authentication.
  • The node uses HTTP headers to specify JSON content type and accept JSON responses.

Troubleshooting

  • Common issues:

    • Invalid or expired API key leading to authentication errors.
    • Incorrect format of Chat Id or Participant identifiers causing the API to reject the request.
    • Attempting to add a participant who is already in the group may result in an error or no change.
    • Network connectivity problems preventing access to the WaAPI endpoint.
  • Error messages:

    • Authentication failures usually indicate invalid credentials; verify and update the API key.
    • Validation errors related to Chat Id or Participant suggest checking the formatting and correctness of these values.
    • Rate limiting or quota exceeded errors require reviewing your WaAPI plan limits.

Links and References

Discussion