Skip to main content

Chats

The Chats page shows every connected conversation where Clark is active. Use it to check channel status, review recent context, and identify the single Admin / Master Chat.

Chat Types

TypePurpose
Telegram groupTeam discussions, operational work, documents, tasks, and digests.
Telegram private chatAdmin setup, direct questions, registration, and private work.
Slack channelTeam collaboration in Slack, with context saved silently.
Slack DMDirect conversation with Clark, no mention required.
Slack threadFocused follow-up on a file, answer, task, or summary.
Admin / Master ChatThe one protected Telegram chat with cross-chat summaries, tasks, and document access.

Connect a Telegram Chat

  1. Add @xdocai_bot to the Telegram group, or open a private chat with the bot.
  2. Send /link <tenant_id> in that chat. For example: /link admin-0501-ccf9.
  3. Wait for the confirmation message with the workspace name, Tenant ID, and connected chat count.
  4. Refresh the Chats page in the dashboard.

You do not need to mention Clark before /link. Telegram commands such as /link@xdocai_bot <tenant_id> also work. If the chat was linked to another test workspace, Clark moves it and shows Moved from: ....

Regular /link <tenant_id> connects an isolated working chat. It can use its own messages, tasks, documents, and memory, but it cannot run cross-chat commands.

Set the Admin / Master Chat

Use a separate command for the workspace master chat:

/link_admin <tenant_id>

You can also send:

/link admin <tenant_id>

The Admin / Master Chat can be a private Telegram chat with the bot or a dedicated admin group. Only one master chat can exist per workspace. When you link a new one, Clark removes master access from the previous master chat and keeps cross-chat commands available only in the new master chat.

Listener mode

In team chats Clark listens quietly and saves context. It responds when:

  • someone says Clark or Кларк;
  • someone tags the bot;
  • someone replies to a Clark message;
  • a direct/private conversation is used;
  • a Slack slash command is used.

In Telegram, /listener can toggle a more proactive mode where Clark may step into the conversation when it sees a useful reason.

Add a Team Member From Telegram

CEO/Admin users can add a person to the Team dashboard from Telegram:

Clark, добавь @memera в панель, он занимается логистикой и документами, статус менеджер

Clark creates or updates the Team member, saves the description as Bio, and assigns the requested role. Supported statuses are client, manager, admin, and member.

Master Chat Commands

CommandResult
/link_admin <tenant_id>Make the current Telegram chat the single Admin / Master Chat.
/sum allDaily digest across connected chats.
/sum_week allWeekly digest across connected chats.
/tasks allTasks grouped across chats.
/statsCurrent chat statistics.

Automatic Summaries

In chat settings, admins can turn on daily and weekly summaries. Daily summaries run Monday through Thursday at the local end-of-day time and are skipped if there were no messages in the previous 24 hours. Weekly summaries run every Monday at 10:00 in the CEO/admin timezone and cover the previous week. Clark sends them to Telegram or Slack according to the connected chat, can route them privately to the CEO/admin, and saves them in Memory.

Troubleshooting

ProblemFix
Chat is missingSend /link <tenant_id> in Telegram, or install the Slack app and send a test message, then refresh the dashboard.
Clark does not answerMention the bot directly or use a private chat/DM.
Wrong chat is masterSend /link_admin <tenant_id> in the correct private bot chat or admin group, then refresh the dashboard.
Slack messages are not processedCheck that the Slack app is installed and has channel permissions.