Chatwork icon

Chatwork

Retrieve data from Chatwork API.

Overview

This node integrates with the Chatwork API to manage chatrooms and their related entities. Specifically, for the "Rooms" resource and the "Add a new task to the chat" operation, it allows users to create a new task within a specified chatroom. This is useful for teams using Chatwork to assign and track tasks directly in their chat environment.

Typical use cases include:

  • Assigning tasks to team members during or after a chat discussion.
  • Setting deadlines for tasks related to ongoing projects discussed in chatrooms.
  • Automating task creation based on external triggers or workflows integrated with n8n.

Example: Automatically create a task in a project chatroom assigning specific team members with a deadline when a new issue is logged in an external system.

Properties

Name Meaning
Chatroom ID The unique numeric identifier of the chatroom where the task will be created.
Task description A text description detailing what the task is about.
Deadline (Optional) The due date and time for the task completion, provided as a datetime value (converted to Unix time internally).
To Comma-separated account IDs of the person or people responsible for completing the task.

Output

The node outputs JSON data representing the newly created task object returned by the Chatwork API. This typically includes details such as task ID, description, assigned members, deadline timestamp, status, and other metadata related to the task.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Chatwork API via an API key credential configured in n8n.
  • The node uses the Chatwork API endpoint /rooms/{roomId}/tasks with a POST method to create tasks.
  • Proper permissions are needed on the Chatwork account to add tasks to the specified chatroom.

Troubleshooting

  • Common issues:

    • Invalid or missing Chatroom ID: Ensure the room ID exists and is accessible by the authenticated user.
    • Incorrect format for "To" field: Account IDs must be comma-separated without spaces.
    • Deadline format errors: The deadline must be a valid datetime; otherwise, the API may reject the request.
    • Insufficient permissions: The API key used must have rights to create tasks in the target chatroom.
  • Error messages:

    • "operation is not supported." — Occurs if an unsupported operation is selected; verify that "createTask" is chosen.
    • API errors related to authentication or authorization indicate issues with the API key or user permissions.
    • Validation errors from the API usually specify which input property is invalid or missing.

Resolving these generally involves verifying input values, ensuring correct API credentials, and confirming user permissions in Chatwork.

Links and References

Discussion