Connectors
Link your platforms or subscribe to content you care about — Alloomi keeps watch so you don’t have to.
To add a connector, open Settings → Connectors and click + Add New Connector. Alloomi will guide you through the authorization process for each platform.
🔒 Privacy by design: Alloomi only reads messages to generate insights. It does not store raw message content on its servers — data is processed locally or encrypted in transit.
Supported Platforms
Messaging Platforms and Social Media
| Platform | Status | Description |
|---|---|---|
| Telegram | 🟢 Available | Personal messaging |
| 🟢 Available | Personal messaging | |
| Slack | 🟢 Available | Team communications |
| Discord | 🟢 Available | Community & teams |
| iMessage | 🟢 Available | Personal messaging |
| 🟢 Available | Bot messaging | |
| Feishu | 🟢 Available | Bot messaging |
| DingTalk | 🟢 Available | Bot messaging |
| Weixin | 🟢 Available | Personal messaging |
| Gmail | 🟢 Available | |
| Outlook | 🟢 Available | |
| X | 🟢 Available | Marketing Automation |
| 🟡 Coming Soon | Marketing Automation | |
| Microsoft Teams | 🟡 Coming Soon | Team communications |
Productivity Tools
| Platform | Status | Description |
|---|---|---|
| Google Drive | 🟡 Coming Soon | File storage |
| Notion | 🟡 Coming Soon | Knowledge base |
| HubSpot | 🟡 Coming Soon | CRM |
| Google Calendar | 🟡 Coming Soon | Scheduling |
| GitHub | 🟡 Coming Soon | R & D |
Other
| Platform | Status | Description |
|---|---|---|
| RSS | 🟢 Available | News & updates |
What Each Connector Does
The table below compares what each connector supports across key capabilities. Use this to choose the right platform for your workflow.
Note: Microsoft Teams, Google Drive, Notion, HubSpot, Google Calendar, and GitHub are coming soon and not included in the table below.
Messaging Platforms
| Connector | Read Messages | Send / Reply | Interactive Chat | AI Translation | AI Polishing | Notes & Files | Setup |
|---|---|---|---|---|---|---|---|
| Telegram | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | QR / Phone |
| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | QR / Phone | |
| Slack | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | OAuth |
| Discord | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | OAuth |
| iMessage | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | Local (macOS) |
| ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | Bot Token | |
| Feishu | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | Bot Token |
| DingTalk | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | Bot Token |
| Weixin | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | QR |
| Connector | Read Messages | Send / Reply | Interactive Chat | AI Translation | AI Polishing | Notes & Files | Setup |
|---|---|---|---|---|---|---|---|
| Gmail | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | App Password |
| Outlook | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | App Password |
Social / Content
| Connector | Read Messages | Send / Reply | Interactive Chat | AI Translation | AI Polishing | Notes & Files | Setup |
|---|---|---|---|---|---|---|---|
| X | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | OAuth |
| RSS | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | URL / OPML |
How to
Platform Setup Details
Telegram
After clicking [Connect Telegram], you’ll be redirected to Telegram’s authorization page.
- Enter your phone number
- Enter the verification code sent to your Telegram app
- If you have Two-Step Verification enabled, enter your password
Or choose to authorize by scanning a QR code in the Telegram app
Or choose to authorize by quick login in the Telegram app if you have official telegram desktop installed locally, you can use your existing session to login without phone number or verification code
Slack
After clicking [Connect Slack], you’ll be redirected to Slack’s authorization page. Click [Install Alloomi] to add Alloomi to your workspace.
Note: Only workspace owners can install Alloomi currently.
Discord
After clicking [Connect Discord], select a Discord server to install Alloomi.
Note: Only Discord server managers can install Alloomi currently.
After clicking [Connect WhatsApp], scan the QR code in the WhatsApp app to complete authorization.
Or use a phone pair code to link WhatsApp without scanning:
iMessage
iMessage integration is only available on macOS.
- Click [Connect iMessage]
- Grant the required permissions:
- Full Disk Access - Required to read iMessage database
- Automation Permission - Required to send messages
- Enter a display name for your iMessage account
- Click connect
How to grant permissions:
- Go to System Settings > Privacy & Security > Full Disk Access
- Add the running app (Terminal, Node, or Alloomi)
- Restart the app after granting permissions
💡 Your message data stays on your local device. Alloomi only reads recent messages when you use it to generate insights.
QQ integration uses a bot mode via a persistent WebSocket connection. Unlike Telegram or iMessage (which connect to your personal account), QQ requires you to set up a QQ bot first.
Before you start — set up a QQ bot:
- Register a QQ bot at the QQ Open Platform
- Create a new bot application and obtain your Bot App ID and Bot Token
- Enable the message receive permissions for your bot
Connect in Alloomi:
- Click + Add New Connector and select QQ
- Enter your Bot App ID and Bot Token
- Click Connect — Alloomi establishes a long-lived WebSocket connection to your bot
Once connected, users who message your QQ bot will have their conversations processed by Alloomi. Alloomi replies as the bot.
💡 QQ integration is in bot mode — Alloomi reads messages sent to your bot, not your personal QQ account.
Feishu
Feishu integration uses a bot mode via a WebSocket long connection. You need to create an enterprise self-built application on the Feishu Open Platform — no public IP or domain is required.
⚠️ Important — App must be published: After setting up in the Feishu Open Platform, your app must be published in the enterprise admin console before colleagues can find and message it. This is the #1 reason the bot doesn’t appear.
Step 1 — Create a Feishu app:
- Go to Feishu Open Platform and sign in
- Click Create enterprise self-built app → fill in app name → click Create
- On the left sidebar, go to App capabilities → Bot → click Add
Step 2 — Configure permissions:
- Go to Permissions management → Add permissions
- Search and enable these permissions:
Tenant-level scopes:
| Permission key | Description |
|---|---|
aily:file:read | Read Aily files |
aily:file:write | Write Aily files |
application:application.app_message_stats.overview:readonly | Read app message stats |
application:application:self_manage | Manage application |
application:bot.menu:write | Write bot menu |
cardkit:card:write | Write card |
contact:user.employee_id:readonly | Read employee ID |
corehr:file:download | Download CoreHR files |
docs:document.content:read | Read document content |
event:ip_list | IP list |
im:chat | Chat access |
im:chat.access_event.bot_p2p_chat:read | Read bot P2P chat events |
im:chat.members:bot_access | Bot access to chat members |
im:message | Message access |
im:message.group_at_msg:readonly | Read group @ messages |
im:message.group_msg | Group message |
im:message.p2p_msg:readonly | Read direct messages |
im:message:readonly | Read message content |
im:message:send_as_bot | Send messages as bot |
im:resource | Access resources |
sheets:spreadsheet | Spreadsheet access |
wiki:wiki:readonly | Read wiki |
User-level scopes:
| Permission key | Description |
|---|---|
aily:file:read | Read Aily files |
aily:file:write | Write Aily files |
im:chat.access_event.bot_p2p_chat:read | Read bot P2P chat events |
im:chat:read | Read chat |
im:chat:readonly | Read chat info |
Step 3 — Subscribe to events (use WebSocket):
- Go to Event Subscriptions
- Choose Receive events via WebSocket (long connection) — no domain or IP needed
- Click Add event → search for
im.message.receive_v1→ add it
Step 4 — Get your credentials:
Go to Credentials & Basic Info and copy your:
- App ID (starts with
cli_) - App Secret
Step 5 — Connect in Alloomi:
- In Alloomi, go to Settings → Connectors → + Add New Connector → select Feishu
- Enter your App ID and App Secret
- Click Connect
Step 6 — Publish the app (required before use):
🔑 This step is essential. Without publishing, no one (including yourself) can find or chat with the bot.
- Go to Feishu Admin Console → Applications
- Find your app → click Publish
- For a self-built app in development, you can also use Version management → Create version → Submit for internal testing — this lets you and your team test immediately without full publication
Step 7 — Find and chat with your bot:
Once published, open Feishu and search for your bot’s name:
- In Feishu, click the + (new chat) button → Search for your bot name
- Click the bot → start chatting
💡 Your bot only responds to messages sent directly to it — it won’t respond to messages in group chats unless someone @mentions it.
DingTalk
DingTalk integration uses a Stream mode bot — a long-lived WebSocket connection with no public IP or domain required.
Before you start — set up a DingTalk app:
- Go to DingTalk Open Platform and sign in
- Create an enterprise internal app
- Add the Bot capability and choose Stream mode (long connection)
- Obtain your Client ID (AppKey) and Client Secret (AppSecret)
Connect in Alloomi:
- Click + Add New Connector and select DingTalk
- Enter your Client ID (AppKey) and Client Secret (AppSecret)
- Optionally set a display name for your bot
- Click Connect — Alloomi establishes a long-lived WebSocket connection to your bot
💡 Stream mode means Alloomi connects directly via WebSocket — no server or domain setup needed. Once connected, you can chat with your bot directly in DingTalk.
Weixin
After clicking [Connect Weixin], scan the QR code in the Weixin app to complete authorization.
Gmail
After clicking [Connect Gmail], enter your email address and an App Password to authorize. (Regular Gmail password won’t work — App Passwords require 2-Step Verification to be enabled.)
Outlook
After clicking [Connect Outlook], enter your email address and app password to authorize.
X
After clicking [Connect X], complete the OAuth authorization flow to link your X account.
RSS
After clicking [RSS], you can add individual RSS links or upload an OPML file for batch import.
Disconnect / Revoke Access
If you no longer want Alloomi to access a connected platform, you can disconnect it at any time.
- Go to Settings → Connectors
- Find the platform you want to disconnect
- Click [Disconnect] or the remove (×) button
- Confirm the action
Once disconnected:
- Alloomi will immediately stop reading new messages from that platform
- Previously synced data is retained until manually deleted
- You can reconnect at any time by repeating the connection steps
💡 Tip: Before disconnecting, review what data has been synced in the Privacy & Security settings.