Actions16
- Rooms Actions
- Create a new group chat
- Leave/Delete a group chat
- Get detail
- Update info
- Get members
- Change associated members
- Get messages
- Send message
- Get message detail
- Update the specified message
- Delete message
- Get tasks
- Get task detail
- Add a new task to the chat
- Get the list of files
- Get information about the specified file
Overview
This node integrates with the Chatwork API to manage chatrooms and their members. Specifically, the "Change associated members" operation for the "Rooms" resource allows users to update the membership of a group chat by assigning different roles such as administrators, members, and read-only users.
Common scenarios where this node is beneficial include:
- Managing team communication by dynamically updating who has admin rights or member access in a chatroom.
- Automating user role changes in group chats based on project phases or organizational changes.
- Synchronizing chatroom memberships with external systems or databases.
For example, you could use this node to promote certain users to administrators while demoting others to read-only status, ensuring proper permissions are maintained without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Chatroom ID | The unique numeric identifier of the chatroom to modify. |
| Group Chat Administrators | Comma-separated list of user IDs to be assigned administrator permissions. At least one must be specified. |
| Group Chat Members | Comma-separated list of user IDs to be assigned member permissions. |
| Group Chat Read-only Users | Comma-separated list of user IDs to be assigned read-only permissions. |
Output
The output is a JSON object representing the response from the Chatwork API after attempting to change the associated members of the specified chatroom. This typically includes confirmation of the updated membership details or any error messages returned by the API.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Chatwork API using a valid API authentication token configured in n8n credentials.
- The node depends on the
chatworkApiRequesthelper function to make HTTP requests to the Chatwork API endpoints.
Troubleshooting
- Missing or invalid Chatroom ID: Ensure the Chatroom ID is correctly provided and corresponds to an existing chatroom.
- At least one administrator required: The API requires at least one user ID in the administrators list; omitting this will cause an error.
- Invalid user IDs format: User IDs should be provided as comma-separated strings without spaces or invalid characters.
- API authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Unsupported operations or resources: If the node throws an error about unsupported operations, confirm that the selected resource and operation match those supported by the node.