Actions85
- Instances Actions
- Client Actions
- Message Actions
- Chat Actions
- Contact Actions
- Number Actions
- Group Actions
- Channel Actions
- Label Actions
- Story Actions
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 IdorParticipantidentifiers 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 IdorParticipantsuggest checking the formatting and correctness of these values. - Rate limiting or quota exceeded errors require reviewing your WaAPI plan limits.
Links and References
- WaAPI Official Documentation (for detailed API usage and parameters)
- WhatsApp Group IDs Format Explanation