Chatwork icon

Chatwork

Retrieve data from Chatwork API.

Overview

This node integrates with the Chatwork API to manage group chat rooms. Specifically, for the "Rooms" resource and the "Leave/Delete a group chat" operation, it allows users to either leave a chatroom or delete it entirely. This is useful in scenarios where a user wants to exit a group conversation without deleting it for others, or when they want to remove the entire chatroom (if they have the necessary permissions).

Practical examples:

  • A team member leaves a project discussion room after the project ends.
  • An admin deletes an obsolete or redundant group chat to keep the workspace organized.

Properties

Name Meaning
Chatroom ID The unique numeric identifier of the chatroom to leave or delete.
Action type The action to perform on the chatroom: either "Leave" to exit the room or "Delete" to remove the room completely.

Output

The node outputs JSON data representing the response from the Chatwork API after performing the leave or delete action on the specified chatroom. The exact structure depends on the API's response but typically includes confirmation of the action taken or details about the updated state of the chatroom.

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 HTTP methods (DELETE) to interact with the Chatwork API endpoints related to chatrooms.

Troubleshooting

  • Common issues:

    • Insufficient permissions: Trying to delete a chatroom without admin rights will result in an error.
    • Invalid Chatroom ID: Providing a non-existent or incorrect chatroom ID will cause the API to return an error.
    • Network or authentication errors: If the API key is invalid or network connectivity fails, the request will not succeed.
  • Error messages:

    • "operation is not supported." — This indicates that the selected operation is not implemented; ensure "leaveOrDeleteRoom" is chosen.
    • API errors related to authorization or resource not found should be checked by verifying credentials and chatroom IDs.

Links and References

Discussion