Chatwork icon

Chatwork

Retrieve data from Chatwork API.

Overview

This node integrates with the Chatwork API to manage chatrooms and their related data. 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 organize work by assigning tasks directly in chatrooms, ensuring accountability and deadlines are clearly communicated.

Practical examples include:

  • Assigning follow-up tasks after a meeting discussion in a project chatroom.
  • Creating reminders or action items for team members responsible for specific deliverables.
  • Tracking task deadlines and responsibilities without leaving the chat environment.

Properties

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

Output

The output JSON contains the response from the Chatwork API after creating the task. It typically includes details about the newly created task such as its ID, description, assigned members, deadline, and status.

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 on the Chatwork account to add tasks to the specified chatroom are necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Chatroom ID can cause errors; ensure the room exists and the ID is correct.
    • Incorrect formatting of the "To" field (e.g., missing commas between multiple IDs) may lead to API rejection.
    • Providing an invalid or past deadline might cause unexpected behavior or errors.
    • Insufficient permissions to add tasks in the chatroom will result in authorization errors.
  • Error messages:

    • "operation is not supported." — This indicates that the selected operation is not implemented for the Rooms resource; verify you have chosen "createTask".
    • API authentication errors — Check that the API key credential is correctly set up and has required scopes.
    • Validation errors from the API — Review input fields for correctness, especially roomId, body, toIds, and limit.

Links and References

Discussion