Actions83
- 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 add a new user to a specific WhatsApp group by providing the group's chat ID and the participant's contact ID.
Properties
| Name | Meaning |
|---|---|
| Id | The instance ID representing the specific WaAPI session or connection to use. |
| Chat Id | The unique identifier of the WhatsApp group chat (format: <group_id>@g.us). |
| Participant | The WhatsApp contact ID of the participant to add to the group (format: <user_id>@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 errors encountered.
No binary data output is produced by this operation.
Dependencies
- Requires an active API key credential for the WaAPI service.
- The node communicates with the WaAPI endpoint at
https://waapi.app/api/v1. - Proper configuration of the API key credential within n8n is necessary for authentication.
Troubleshooting
Common issues:
- Invalid or missing instance ID may cause the request to fail.
- Incorrectly formatted chat ID or participant ID will result in errors.
- Network connectivity problems or invalid API credentials will prevent successful execution.
Error messages:
- Errors related to authorization usually indicate invalid or expired API keys; recheck and update credentials.
- "Participant not found" or similar errors suggest the participant ID does not exist or is not valid.
- "Group not found" indicates the chat ID is incorrect or the bot/user does not have access to the group.
To resolve these, verify all IDs are correctly formatted, ensure the API key is valid, and confirm network connectivity.
Links and References
- WaAPI Official Documentation
- WhatsApp Group Chat ID Format Explanation (general reference)