Telegram

The Telegram integration connects a Telegram bot with Almirant to receive user feedback, event notifications, and allow basic interaction with the platform directly from the chat.

How it works

Almirant integrates with Telegram through a bot that acts as a bridge between Telegram users and the platform. The bot can:

• Receive feedback -- Users send messages to the bot and these are recorded as feedback in Almirant.
• Send notifications -- Almirant notifies via Telegram about relevant events (status changes, assignments, quota alerts).
• Execute commands -- Basic commands to query project information.

Setting up the Telegram bot

1. Create the bot

If your organization doesn't have a bot configured, you need to create one:

1. Open Telegram and search for @BotFather.
2. Send the /newbot command.
3. Follow the instructions to set the bot's name and username.
4. BotFather will provide you with an API token. Store it securely.

2. Connect the bot to Almirant

1. Go to Settings > Integrations > Telegram.
2. Enter the bot's API token.
3. Configure the desired notification options.
4. Save the configuration.
5. Almirant will automatically set up the bot's webhook to receive messages.

3. Verify the connection

Send a test message to the bot from Telegram. It should appear as feedback in Almirant.

Receiving feedback

One of the bot's main features is receiving feedback from end users or stakeholders who don't have access to Almirant.

Feedback flow

1. A user sends a message to the Telegram bot (text, image, or file).
2. The bot forwards the message to Almirant through the webhook.
3. Almirant records the feedback linked to the organization.
4. The feedback appears in the project's Ideas & Feedback section for review.

Customer feedback

The Telegram bot is ideal for collecting feedback from customers or end users who don't need direct access to Almirant. Share the bot link with the people you want to be able to send feedback.

Message formats

The bot accepts different types of content:

Type	How it's processed
Text	Recorded as text feedback
Image	Stored as a feedback attachment
File	Stored as a feedback attachment
Reply to message	Linked as a conversation thread

Notifications

Configure which project events you want to receive as Telegram notifications:

Event	Description
Work item assigned	A work item is assigned to you
Status change	A work item moves to a different column on the board
Sprint started/finished	A sprint begins or ends
Feedback received	New feedback is recorded in the project
AI quota	Alert when the quota is close to being exhausted

To configure notifications:

1. Go to Settings > Integrations > Telegram.
2. Enable or disable the events you want to receive.
3. Save the changes.

Bot commands

The Telegram bot supports basic commands to query information:

Command	Description
/start	Starts the interaction with the bot and displays a welcome message
/help	Shows the list of available commands
/status	Queries the summary status of the active project
/feedback [text]	Sends feedback directly with a command

Disconnecting Telegram

To disconnect the bot:

1. Go to Settings > Integrations > Telegram.
2. Click Disconnect.
3. Confirm the disconnection.

warning

Disconnecting the bot will stop receiving feedback and notifications via Telegram. The feedback history already recorded is retained in Almirant.

For Developers

Integration architecture

The Telegram integration consists of:

• Webhook endpoint: Receives updates from the Telegram bot (messages, commands, callbacks).
• Message processor: Classifies the message type and routes it to the corresponding service (feedback, command, notification).
• Notification service: Sends proactive messages to the Telegram chat when events occur in Almirant.

Webhook flow

Telegram Bot API --> POST /webhooks/telegram --> Message processor
                                                      |
                                        +-------------+-------------+
                                        |             |             |
                                    Feedback      Command     Notification