Wappfy

Overview

This node interacts with WhatsApp groups via the Wappfy API, specifically allowing you to update the subject (name) of a WhatsApp group. It is useful when you want to programmatically rename a group based on external triggers or workflows, such as updating project names, event titles, or team names dynamically.

For example, you could use this node in an automation that changes a group's subject when a project status changes in your project management tool, keeping group members informed with the latest context.

Properties

Output

The node outputs the JSON response from the Wappfy API after attempting to update the group subject. This typically includes confirmation details about the updated group subject or error information if the update failed.

The output structure is:

{
  "json": {
    // API response object confirming the update or containing error details
  }
}

No binary data is output by this operation.

Dependencies

• Requires a valid Wappfy API credential configured in n8n, including:
  • Base URL of the Wappfy API.
  • Instance name identifying the WhatsApp session.
  • An API key for authentication.
• The node makes HTTP PUT requests to the endpoint /api/{instanceName}/groups/{groupId}/subject with a JSON body containing the new subject.

Troubleshooting

• Common issues:

  • Invalid or missing Group ID: Ensure the Group ID corresponds to an existing WhatsApp group accessible by the session.
  • Insufficient permissions: The authenticated session must have rights to change the group subject.
  • Network or API errors: Check connectivity and API key validity.

• Error messages:

  • Errors returned by the API will be included in the node output under json.error.
  • If the node throws an exception, it usually indicates a failure in making the HTTP request or invalid parameters.

• Resolution tips:

  • Verify the Group ID is correct and the session is active.
  • Confirm the API key and instance name are properly set in credentials.
  • Use the "Continue On Fail" option in n8n to handle errors gracefully in workflows.

Links and References

• Wappfy API Documentation (general reference for API endpoints)
• WhatsApp Group Management Concepts (for understanding group subjects and permissions)