Actions55
- Message Actions
- Contact Actions
- Chat Actions
- Group Actions
- Queue Actions
- Account Actions
- Session Actions
- Session Control Actions
- Call Actions
Group → Add Participants
AI-generatedOverview
This node integrates with the Maytapi WhatsApp Unofficial API to manage WhatsApp groups and perform various group-related operations. Specifically, the Add Participants operation allows users to add one or more phone numbers as participants to an existing WhatsApp group. It supports sending invitation messages optionally, including a custom invitation message.
Common scenarios where this node is beneficial include:
- Automating the management of WhatsApp groups by programmatically adding members.
- Sending customized welcome messages when inviting new participants to a group.
- Integrating WhatsApp group management into broader workflows such as customer support, community management, or marketing campaigns.
Example use case:
- A business wants to automatically add customers who sign up on their website to a WhatsApp support group and send them a personalized welcome message.
Properties
| Name | Meaning |
|---|---|
| Phone ID Source | Select how to provide the Phone ID: either "From Credentials" (uses Phone ID stored in credentials) or "Custom" (enter a custom Phone ID). |
| Phone ID | The WhatsApp instance Phone ID to use if "Custom" is selected as Phone ID Source. |
| Group ID | The unique identifier of the WhatsApp group (conversation ID ending with @g.us) to which participants will be added. |
| Phone Numbers | Comma-separated list of phone numbers (without @c.us suffix) to add as participants to the group. |
| Send Invite | Boolean flag indicating whether to send invitation messages to the newly added group members. Defaults to true. |
| Invitation Message | Custom message text to include in the group invitations if Send Invite is enabled. |
Output
The node outputs JSON data representing the response from the Maytapi API after attempting to add participants to the specified group. This typically includes success status, details about the added participants, or error information if the operation failed.
No binary data output is produced for this operation.
Dependencies
- Requires an API key credential for the Maytapi WhatsApp API integration.
- The Phone ID must be provided either via credentials or manually as a custom value.
- Network access to the Maytapi API endpoint (
https://api.maytapi.com/api) is required.
Troubleshooting
- Missing Phone ID Error: If neither credentials nor a custom Phone ID is provided, the node throws an error stating "Phone ID is required." Ensure that the Phone ID is correctly set in credentials or entered manually.
- Invalid Group ID: Providing an incorrect or malformed Group ID (not ending with
@g.us) may cause API errors. Verify the Group ID format. - Invalid Phone Numbers: Phone numbers must be comma-separated without the
@c.ussuffix. Incorrect formatting can lead to failures. - Invitation Message Issues: If
Send Inviteis true but the invitation message is empty, the default invitation behavior applies. To customize, provide a non-empty invitation message. - API Errors: Any API-level errors returned by Maytapi (e.g., rate limits, invalid tokens) will be surfaced in the node's output. Check API credentials and usage limits.
Links and References
If you need further details on other operations or resources, feel free to ask!