Description
n8n-nodes-chatwork
This is an n8n community node. It lets you use ChatWork in your n8n workflows.
ChatWork is a business chat platform that provides messaging, task management, file sharing, and team collaboration features via a REST API.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history
Installation
Follow the installation guide in the n8n community nodes documentation.
After installation, restart n8n to load the ChatWork node.
Operations
This node supports the following ChatWork API operations:
Me
- Get account information
- Get status (unread counts, tasks)
- Get tasks assigned to the authenticated user
- Get contact list
- List incoming requests
- Approve request
- Decline request
- Get all rooms
- Get room details
- Create a room
- Update room information
- Leave or delete a room
- Get room members
- Change associated members
- Get messages
- Send a message
- Get message details
- Update a message
- Delete a message
- Mark as Read
- Mark as unread
- Get tasks
- Create a task
- Update task status
- Get task details
- Get files
- Get file details (with optional temporary download URL)
- Upload file
- Get invite link
- Create invite link
- Delete invite link
- Signature header:
x-chatworkwebhooksignature - Hash algorithm: HMAC-SHA256
- Secret key: Base64-decoded webhook token
- The workflow must be active for webhooks to be registered
- Webhooks will return
404 – unknown webhookif the workflow is inactive - Signature verification should be disabled when testing with manual
curlrequests - Webhook events are currently processed as-is
- Duplicate or replayed webhook events are not yet deduplicated
- Replay protection and idempotency will be added in a future release
- A ChatWork account
- An API token generated from your ChatWork account settings
- Minimum n8n version: 1.x
- Tested with: n8n 1.x (community nodes API v1)
- Boolean options such as Create download URL control optional API query parameters.
- n8n community nodes documentation
My
Contacts
Incoming Requests
Rooms
Webhook Trigger
This package provides a Chatwork Trigger node that allows n8n workflows to receive events from Chatwork via webhooks.
Supported Events
The trigger node listens to incoming Chatwork webhook events and routes them to different outputs:
| Event Type | Output |
|——————-|—————–|
| mentiontome | Mention To Me |
| message_created | Message Created |
| message_updated | Message Updated |
Webhook Security
Chatwork signs webhook requests using an HMAC-SHA256 signature.
The Chatwork Trigger node supports optional signature verification using one or more webhook tokens:
> Signature verification can be disabled for local development and testing.
Each output can be connected independently in your workflow.
Development Notes
Known Limitations
Credentials
This node requires a ChatWork API Token.
Prerequisites
Setup
1. In n8n, go to Credentials
2. Create new credentials of type ChatWork API
3. Paste your ChatWork API token
4. Save the credentials and select them in the ChatWork node
Authentication is handled via the X-ChatWorkToken request header.
Compatibility
This node uses the new routing-based request system introduced in n8n v1. Older n8n versions are not supported.
Usage
Most operations are straightforward and map directly to ChatWork API endpoints.
Notes:
If you are new to n8n, see the Try it out guide to get started.