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 group chats (referred to as "rooms"). Specifically, for the "Rooms" resource and the "Create a new group chat" operation, it allows users to create a new group chat by specifying its name, description, icon type, and members with different permission levels. This is useful in scenarios where teams want to automate the creation of project-specific or topic-specific chat groups within Chatwork, enabling streamlined communication and collaboration.
Practical examples:
- Automatically creating a group chat for a new project team when a project is initiated.
- Setting up a discussion room with predefined administrators and members for event planning.
- Creating a read-only announcement channel with specific users having read-only access.
Properties
| Name | Meaning |
|---|---|
| Group chat name | Title of the group chat. Required field. |
| Chat description | Description text explaining the purpose or details of the group chat. Optional. |
| Icon type | Type of the group chat icon. Options include: group, check, document, meeting, event, project, business, study, security, star, idea, heart, magcup, beer, music, sports, travel. |
| Group Chat Administrators | Comma-separated list of user IDs who will have administrator permissions in the group chat. At least one administrator must be specified. |
| Group Chat Members | Comma-separated list of user IDs who will have member permissions in the group chat. Optional. |
| Group Chat Read-only Users | Comma-separated list of user IDs who will have read-only permissions in the group chat. Optional. |
Output
The output is a JSON object representing the newly created group chat's details as returned by the Chatwork API. This typically includes information such as the group's ID, name, description, icon type, and lists of members with their roles.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Chatwork API using a valid API authentication token configured in n8n credentials.
- The node uses internal helper functions to make HTTP requests to Chatwork endpoints.
Troubleshooting
- Missing required fields: If the "Group chat name" or "Group Chat Administrators" are not provided, the node will likely throw an error because these are mandatory.
- Invalid user IDs: Providing invalid or non-existent user IDs in any of the members' lists may cause the API request to fail.
- API authentication errors: Ensure that the API key credential is correctly set up and has sufficient permissions to create rooms.
- Unsupported operations or resources: Errors like "
createRoomoperation is not supported" or "roomsresource is not supported" indicate misconfiguration of parameters. - Network issues: Connectivity problems with the Chatwork API endpoint can cause timeouts or failures.