# Telegram

> Send short messages to your assistants from Telegram and get plain-text replies. Coming soon: connect with a token from Telegram's own app flow.

Status: Coming soon

Telegram is a second way to reach your assistants: short messages from your phone, with plain-text replies and Approve and Reject buttons in the chat. It suits quick questions, nudges, and approvals on the go rather than long work.

> [!SOON]
> Telegram is Coming soon. Chat in the StellarFirm app at [stellarfirm.ai/app](https://stellarfirm.ai/app) works today. See [Delegate work](/docs/ceo/delegate-work) for every place you can hand work over.

## At a glance

| | |
| --- | --- |
| Category | Chat |
| Status | Coming soon |
| Used by | Coder (available now) |

## What assistants can do

| Ability | How it runs |
| --- | --- |
| Receive your messages | Reads on its own |
| Send plain-text replies | Reads on its own |
| Ask you to Approve or Reject work, with buttons in the chat | Reads on its own (it only asks; the decision stays with you) |

## Setup (when it opens)

1. In Telegram, use Telegram's own app-creation flow to make a new app for your assistants, and copy the token it gives you.
2. Find your numeric Telegram user id, so only you can message your assistants.
3. Pick a secret word for the connection. Telegram sends it with every message, so nobody else can post to your assistants.
4. Give your StellarFirm setup a public https address that Telegram can reach.

Today these are set in the configuration of a self-hosted StellarFirm setup, not from the app. When Telegram opens, you will connect it under **Integrations**.

## Permissions

Telegram tokens have no scopes to pick. The token lets your StellarFirm workspace:

- **Receive** messages sent to the app.
- **Send** replies from it.

Only the user ids you list are answered. A message from anyone else is ignored. In a group, the app answers only when you mention it, use one of its commands, or reply to it.

## Good to know

- **Approve in the chat.** When work needs you, the request arrives with **Approve** and **Reject** buttons. Only the person who asked can press them, and the first press wins. You can also reply `approve` or `reject` when one request is waiting, or use the [Approvals page](https://stellarfirm.ai/app/approvals).
- Replies are plain text, with no formatting or attachments.
- Routines and hand-offs between assistants are not started from Telegram.
- Your token stays in your StellarFirm setup and is never shown back to you. The page shows only that it is connected.
- Treat the token like a password. If it leaks, create a new one in Telegram and paste it again.

## Prompts

```prompt title="Quick question"
Coder, what is the state of [repository] right now? Reply in two sentences.
```

```prompt title="Nudge"
Coder, how is [task] going? Tell me what is done and what is left.
```

---

Source: https://stellarfirm.ai/docs/integrations/telegram