Skip to main content
By connecting Telegram, you and your team can send messages to your AI assistant directly from the Telegram app — on mobile or desktop. This takes about 5 minutes and requires a Telegram account.

​
Step 1: Create a Telegram bot

You create Telegram bots through a special Telegram account called @BotFather.
1

Open BotFather

In Telegram, search for @BotFather (the verified account with a blue checkmark) and start a conversation.
2

Create a new bot

Send the command:
/newbot
BotFather will ask you a couple of questions.
3

Set your bot's display name

When asked “Alright, a new bot. How are we going to call it?”, type a friendly name for your bot. This is the name users will see in chats, for example:
Hellenic Assistant
4

Set your bot's username

When asked for a username, type a unique handle ending in bot, for example:
HellenicAssistantBot
The username must be unique across all of Telegram. If it is already taken, try adding your company name or a number.
5

Copy your bot token

BotFather will confirm the bot is created and show a message like:
Done! Congratulations on your new bot. You will find it at t.me/HellenicAssistantBot. You can now add a description… Use this token to access the HTTP API: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
Copy the token — you will need it in the next step.
Keep your bot token private. Anyone who has the token can send messages as your bot and read all conversations. Never share it publicly or commit it to a code repository.

​
Step 2: Connect to Hellenic Claw

1

Go to your instance dashboard

Log in at app.hellenicai.com and open your instance.
2

Open the Channels tab

Click the Channels tab on your instance page.
3

Select Telegram

Find the Telegram card and click Connect.
4

Paste your bot token

Paste the token you copied from BotFather into the token field, then click Save or Connect.
You should see the Telegram channel status change to Connected.

​
Step 3: Test the connection

1

Open Telegram

On your phone or desktop, open Telegram and search for your bot username (e.g. @HellenicAssistantBot).
2

Start a conversation

Tap Start or send /start.
3

Send a message

Type any question, for example: “What can you help me with?”
4

Check the reply

Your AI assistant should reply within a few seconds. If it does, the connection is working.

​
Troubleshooting

ProblemSolution
No reply from botDouble-check the token was pasted correctly with no extra spaces
”Unauthorised” error in dashboardThe token may be incorrect — regenerate it in BotFather with /revoke and reconnect
Bot replies but answers seem offCheck the AI model selected in your instance settings
Need more help? Email [email protected].