Wazzap API icon

Wazzap API

Interact with Wazzap API
Join our community

Actions23

Overview

The node interacts with the Wazzap API to add participants to a specified WhatsApp group. It is designed to send a text message to one or more phone numbers, inviting or notifying them as part of the group identified by its unique group ID (JID). This node is useful for automating group management tasks such as onboarding new members or broadcasting messages to selected contacts within a WhatsApp group.

Practical examples:

  • Automatically adding new customers or team members to a WhatsApp group and sending them a welcome message.
  • Sending announcements or updates to specific users by adding them temporarily to a group.
  • Managing event invitations by adding participants to a dedicated WhatsApp group with a custom message.

Properties

Name Meaning
👥 Group ID (JID) The unique identifier of the WhatsApp group where participants will be added. Format example: 1234567890-123456@g.us.
✉️ Text Message The content of the text message that will be sent to each participant when they are added to the group.
📞 Phone Numbers One or multiple phone numbers (including country code, e.g., +521234567890) to which the add-participant action and message will be applied.
⚙️ Additional Options Optional settings to customize the behavior:
• 🔢 Priority Number: Selects which sending number to use (0 = default, 999 = random, 1–5 = specific slot).
• ⏱️ Delay Settings: Configure a random delay range (in ms) before sending each message.

Output

The node outputs a JSON array containing the results of the add-participants operation. Each element corresponds to an attempt to add a phone number to the group and send the message. The exact structure depends on the API response but typically includes success status, any error messages, and metadata about the operation.

If the node supports binary data output (not indicated in the provided code), it would represent media or files related to the operation, but this is not applicable here.

Dependencies

  • Requires an active connection to the Wazzap API service.
  • Needs an API authentication token or key configured in n8n credentials to authorize requests.
  • The base URL for API requests is https://doc.wazzap.mx/api-reference.
  • No additional external dependencies are indicated.

Troubleshooting

  • Common issues:

    • Invalid or missing Group ID (JID) can cause failures in identifying the target group.
    • Incorrectly formatted phone numbers may result in errors or failed message delivery.
    • Missing or invalid API credentials will prevent successful communication with the Wazzap API.
    • Network connectivity problems can cause timeouts or request failures.

  • Error messages:

    • "Unsupported operation." — Occurs if the node is configured with an unsupported resource or operation combination. Verify that "👥 Group" and "➕ Add Participants" are correctly selected.
    • API errors returned from Wazzap (e.g., unauthorized, bad request) should be checked in the node's execution logs. Ensure all required parameters are valid and credentials are correct.

  • Resolution tips:

    • Double-check the format and correctness of the Group ID and phone numbers.
    • Confirm that the API key credential is properly set up and has necessary permissions.
    • Use the delay options to avoid rate limiting or flooding the API with rapid requests.

Links and References

  • Wazzap API Documentation (official API reference)
  • WhatsApp group JID format explanation (external resources may help understand the JID structure)

Discussion