Skip to main content

Telegram

Telegram is another conversation entrance to the same Office. Assign work in the group and receive Office messages without copying between them. One Office connects to one Telegram group.

Before you start

Connecting, confirming, and disconnecting require an account that can manage this Office. Managers, Admins, and Owners can operate Offices they can see. Someone must also be able to add the bot to the Telegram group and give it administrator rights.

Connect a group to the Office​

For example, connect the project team’s group to its Office so everyone can ask about progress in the group.

  1. Open the Office’s Settings › Telegram and select Connect Telegram.
  2. Scan the QR code with a phone running Telegram, or select Open in Telegram.
  3. Follow Telegram’s instructions to create the bot. Once ready, open the add-to-group link in your conversation with the setup bot. Add it to the intended group and grant the administrator rights Telegram requests.
  4. Return to Soulhall. Check the group name and the person who added the bot, then select Confirm this group.

The card shows which bot connects to which group, and new messages start relaying.

note

The QR code and link appear only once and expire after 15 minutes. Reloading cannot recreate them; select Connect Telegram again if lost. Adding the bot alone does not finish connection: confirm in Soulhall too. Connecting does not send the Office’s entire earlier conversation to the group.

Check connection progress​

Card showsNext step
QR code and Open in TelegramOpen Telegram and follow the bot-creation instructions.
Waiting for you to finish creating the bot in Telegram.Return to Telegram and finish creation.
Bot ready, with instructions to add it to a groupUse the link in the Telegram conversation and grant administrator rights.
Group name, person who added it, and Confirm this groupCheck and confirm. If wrong, select Disconnect and start again.
Connected group and botAssign work in the group and adjust the two trust switches below.
The bot was removed from the group, so nothing is being relayed. Connect again to restore it.Reconnect.

After connection, the card may also show messages awaiting delivery or the latest problem. Follow the displayed error to investigate. See Troubleshooting.

Assign work in the group​

Ordinary group chat enters the Office conversation as context for the next work. To request an Embodiment’s answer, address the Office’s bot.

  1. Mention the card’s @botname in your message, such as “@botname Summarize today’s decisions.”
  2. Or reply directly to a message this bot sent in the group and write your request.

Only these trigger work. Ordinary chat without a mention or reply adds context without consuming a model turn for every message.

When a message starts work, the bot reacts to it with 👀, and the group shows the bot as typing while the Office works. Both mean the Office, not a particular Embodiment — the Office page shows who is working. 👀 stays even if, in the end, nobody has anything to add.

Telegram replies keep their link. When you reply to an earlier message — yours, a colleague’s, or an Embodiment’s — the Office sees which message you are answering and the words you quoted, even if the original was long ago. A reply that does not address the bot is still only context.

The group receives Embodiment messages and messages people send in the Soulhall Office. Messages arriving from Telegram are not sent back to the same group again.

note

The bot needs group administrator rights to receive the full conversation. An ordinary /help or command for another bot does not automatically request a Soulhall answer. The group receives conversation messages and necessary notices, not every internal Office record.

Get results in the group​

When an Embodiment in this Office publishes a report, the group receives it as a research-note card: the title, its opening summary and its key figures, with Read report and Export PDF buttons. A new chart arrives with Open chart. Each version is posted once.

Type /results in the group, or pick it from the group's command menu, to get the Office's latest reports and charts as buttons. An Office that has published nothing yet says so.

The buttons open Soulhall, so readers still need an account that can see the Office.

Keep group experience in this Office​

When an external contractor joins, you may want Embodiments to learn from this work without those conversations affecting the Subject’s judgement elsewhere.

  1. On the connected Telegram card, find What this group may teach.
  2. Uncheck Let conversations in this group teach the Subject and select Save.

Learning from conversations containing Telegram participants’ messages stays with this Office’s Embodiments, not the Subject. Turning this off does not prevent receiving messages, replying, or learning here. It is on by default. When on, knowledge processing still decides what should travel with the Subject; it does not turn every sentence into Subject knowledge.

Limit outward actions the group can trigger​

A group is useful for discussion, but not every participant should be able to direct Embodiments to sign in with your accounts or operate external services.

  1. Under What this group may set in motion, uncheck Let this group set outward actions in motion.
  2. Select Save.

While the group remains connected, all Embodiments in the Office cannot operate browsers, sign in with credentials, or call connected external services, whether instructions come from Telegram or Soulhall. Reading web pages and browser views, files, tasks, reports, and memory remains available. People can still take control in Browser.

note

The switch is on by default. It restricts Embodiment tools, not manual human actions, and does not turn off Office service switches. When the group disconnects or the bot is removed, this connection-based restriction stops applying. Existing tool and service settings still apply.

Stop exchanging messages with the group​

Select Disconnect on the Telegram card. The Office’s connection record is removed, and Connect Telegram becomes available again.

If the bot was removed from the group instead, the card explains that removal and stops relaying. Either way, you can reconnect. Disconnect the current group before connecting another.

Handle a server setup message​

If you see Telegram is not set up on this server yet., contact whoever deploys Soulhall. The server has no usable Telegram connection configuration. Scanning again or changing groups will not fix it, and the card offers no connect button.