@btafoya/n8n-nodes-rocketchat
v0.1.2
Published
n8n community node for Rocket.Chat
Readme
@btafoya/n8n-nodes-rocketchat
An n8n community node for Rocket.Chat. Use it to send messages, manage channels and rooms, and interact with the Rocket.Chat REST API from your workflows.
Published on npm: Install the latest version from npmjs.com or directly inside n8n.
Installation
n8n cloud / managed instances
Community nodes can be installed directly from the n8n editor:
- Open Settings → Community nodes.
- Enter
@btafoya/n8n-nodes-rocketchatand click Install. - Accept the security prompt.
Self-hosted n8n
From your n8n installation directory, run:
npm install @btafoya/n8n-nodes-rocketchatThen restart n8n.
Setup
Personal access token authentication
- In Rocket.Chat, open My Account → Personal Access Tokens and create a token.
- In n8n, create a new Rocket.Chat API credential.
- Enter:
- Base URL — the URL of your Rocket.Chat server, e.g.
https://chat.example.com. - User ID — your Rocket.Chat user ID.
- Auth Token — the personal access token.
- Base URL — the URL of your Rocket.Chat server, e.g.
OAuth2 authentication
- In Rocket.Chat, create an OAuth application at Administration → OAuth Apps.
- In n8n, create a new Rocket.Chat OAuth2 API credential.
- Enter:
- Base URL — the URL of your Rocket.Chat server.
- User ID — your Rocket.Chat user ID (used for
X-User-Idheaders). - Client ID and Client Secret from the Rocket.Chat OAuth app.
- Complete the OAuth2 authorization flow in n8n.
Operations
This node exposes common Rocket.Chat REST API operations, including:
- Send, update, and delete chat messages.
- Create, archive, and delete channels and groups.
- Get room information and members.
- Invite and kick users from rooms.
- List and manage users.
Authentication
The node supports two authentication methods:
- Personal access token — simple and server-wide.
- OAuth2 — user-scoped, suitable for integrations that act on behalf of a user.
Both methods inject the X-Auth-Token and X-User-Id headers required by the Rocket.Chat REST API.
Compatibility
Built and tested against Rocket.Chat 6.x REST API.
Resources
- n8n Community Nodes documentation
- Rocket.Chat REST API documentation
- Local REST API reference — complete overview and endpoint index
- Local applied REST API reference — endpoint details for operations implemented in this node
- Local Realtime API reference — WebSocket/DDP overview and method-call index
- Rocket.Chat personal access tokens
- Rocket.Chat OAuth apps
- n8n workflow examples
