Skip to content

Telegram ​

Two things can happen on Telegram, each through a bot made with Telegram's @BotFather:

  • your own bot sends you your notifications (approve or reject what agents ask with a button), and reaches any of your agents when you mention it: @scout what's new?;
  • an agent can have its own bot, so everyone who can use it talks to it there, in private or by mentioning it in a group.

Making a bot takes a minute: in Telegram, open @BotFather, send /newbot, choose a name ("My CrewHall", "Scout") and a username ending in bot. It gives you a token like 123456789:AAH…: that's what CrewHall needs. A bot is used once in CrewHall: yours, or one agent's.

Your notifications ​

  1. Account → Telegram: paste your bot's token and save.
  2. Open your bot with the link or QR code CrewHall shows, and press Start. That links your Telegram account to you; your bot only ever answers you.

Everything is on at first; turn off the kinds you don't want. A task's result comes in full, and when an agent asks before writing, the message has Approve and Reject buttons, so you can decide from your phone. Send /stop to your bot to pause it, /start to resume. Disconnect Telegram removes your bot and forgets your Telegram account.

Talking to your agents from your bot ​

Write @ and an agent's short name (its slug, as in /agents/…), then your message: @scout any news on the release?. Its answer comes back under its name, and your next messages go to it until you mention another one. Its name alone (@scout) switches without a message. /agents lists the agents you can use, /new starts a new conversation with the current one. Two agents with the same short name in different spaces are told apart as @space/slug.

Tasks from Telegram ​

Ask an agent to do something regularly ("every morning at 8, send me the news") and it proposes a task: Telegram shows it with a Create task button, and a schedule without a time zone uses yours (the one your browser had when you connected Telegram). A change it proposes to one of your tasks ("move my brief to 9", "pause the PR reviews") comes with Apply. Nothing happens until you press it; to edit a task first, its message links to the conversation in CrewHall.

An agent on Telegram ​

First, a space's owners and admins turn Telegram on: Settings → Integrations → Add integration → Telegram. Until then its agents have no Telegram box. Telegram then shows in the space's integrations, with which of its agents are on Telegram and any trouble with their bots. Turning it off there pauses them: the bots only say they're not on Telegram for now, and nobody can add one. Their tokens are kept, so turning it back on brings them back. (Your own bot isn't the space's: it keeps working.)

With Telegram on, an agent's editors paste a bot's token in the Telegram box on the agent's Overview. Everyone who can use the agent then sees Open in Telegram there: the first time, the link carries a one-time code so the bot knows who you are (opening your own bot did the same).

Write to it as you would in CrewHall. It works with your access, budget and connected accounts, and the conversation is a normal one: you find it in CrewHall too, and the agent remembers what was said until you send /new. While it works the chat shows "typing"; if it wants to write somewhere that asks first, you get the Approve and Reject buttons right there. A task or a change it proposes comes with Create task or Apply, as in your own bot.

In groups ​

Its editors can let it answer in groups (the switch under its bot). Add the bot to a Telegram group, then mention it (@scout_bot what do you think?) or reply to one of its messages: it answers as a reply, as the person who asked, with their access. Each person has their own conversation with it in that group, and only the person who asked can press its buttons: anyone else is told so, and the buttons stay. Telegram only passes a bot the messages that mention it or reply to it, so it doesn't read the rest of the group. Everyone in the group reads its answers, including people outside CrewHall: that's why it's off until an editor turns it on.

For now bots read text messages only: not files or voice messages. Someone who loses access to the agent can't use its bot anymore.

If a bot's token is revoked in @BotFather (or the bot deleted), CrewHall says so where the token was saved: save the new one there.

Privacy ​

Chats with a bot aren't end-to-end encrypted: what you choose to get on Telegram, and what you write to an agent there, passes through Telegram. CrewHall keeps your Telegram account's id and name until you disconnect.

CrewHall