Wappfy icon

Wappfy

Interact with WhatsApp through Wappfy API

Actions76

Overview

This node allows you to interact with WhatsApp groups via the Wappfy API, specifically enabling you to add a participant to an existing WhatsApp group. This operation is useful for automating group management tasks such as onboarding new members into a group without manual intervention.

Practical examples include:

  • Automatically adding new customers or team members to a WhatsApp support or project group.
  • Integrating with CRM or user databases to sync group membership dynamically.
  • Managing event or community groups by programmatically adding participants based on external triggers.

Properties

Name Meaning
Group ID The unique identifier of the WhatsApp group where the participant will be added.
Participant ID The phone number or WhatsApp ID of the participant to add to the group.

Output

The node outputs the JSON response returned by the Wappfy API after attempting to add the participant. This typically includes confirmation details about the updated group or error information if the operation failed.

The output structure is:

{
  "json": {
    // API response data confirming participant addition or error details
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires a valid Wappfy API credential configured in n8n, including:
    • Base URL of the Wappfy API instance.
    • Instance name (session identifier).
    • An API key for authentication.
  • The node makes HTTP POST requests to the Wappfy API endpoint /api/{instanceName}/groups/{groupId}/participants/add.

Troubleshooting

  • Common issues:

    • Invalid or missing Group ID or Participant ID parameters.
    • Insufficient permissions or invalid API key leading to authorization errors.
    • Participant already in the group causing API to reject the addition.
    • Network connectivity issues preventing API communication.

  • Error messages and resolutions:

    • "Unauthorized" or "Invalid API key": Verify that the API key credential is correctly set up and has necessary permissions.
    • "Group not found": Check that the Group ID is correct and the group exists.
    • "Participant ID invalid": Ensure the participant's phone number or ID is properly formatted and registered on WhatsApp.
    • "Participant already in group": Confirm if the participant is already a member; no need to add again.
    • For network errors, check your internet connection and API endpoint accessibility.

Links and References

Discussion