Connect a Telegram bot to Aysali Bot so user messages arrive in the unified inbox and agents can reply from the admin panel.

Configure under Settings → Telegram. The help link on Synchronization points here.

Settings overview

Field	Purpose
Token	Bot token from @BotFather
Synchronize now	Registers the webhook on your Aysali Bot host
Department	Assign new Telegram conversations to a department
Tags	Apply tags to new conversations
Label	Internal label for this bot (useful with multiple bots)
Additional bots	Extra tokens linked to other departments
Disable chatbot	Turn off chatbot for Telegram only
Ignore start message	Skip Telegram’s automatic /start payload
Welcome message	Reply when the user sends /start — see Welcome message
Notifications	Alert agents via a Telegram channel — see Agent notifications
User ban	Block usernames (comma-separated, with or without @)

---

Installation

1. •

   Create or open a bot in BotFather

   Open @BotFather in Telegram.

   • Existing bot: send /mybots → select your bot → API token
   • New bot: send /newbot → follow prompts for name and username → copy the token

   Official guide: core.telegram.org/bots

2. •

   Paste token and synchronize

   In Settings → Telegram → Synchronization, paste the Token, then click Synchronize now.

3. •

   Test

   Message your bot in Telegram. The conversation should appear in the Aysali Bot admin inbox.

Your bot host must use a valid SSL certificate (for example https://360-bot.aysali.com).

---

Additional bots

Use Settings → Telegram → Additional bots when different departments need separate Telegram bots:

1. Add a row with Token, Department, optional Tags and Label.
2. Click Synchronize now on that row.
3. Each bot registers its own webhook to the same Aysali Bot installation.

---

Welcome message

Settings → Telegram → Welcome message

Option	Purpose
Active	Send a message when the user starts the chat (/start)
Message	Text body — supports text formatting and rich messages where compatible

Pair with Ignore start message if you do not want the raw /start event to open a conversation without your welcome text.

---

Agent notifications

Settings → Telegram → Notifications

Send alerts to a Telegram channel or group when new messages arrive.

Option	Purpose
Active	Enable Telegram agent notifications
All messages	Notify on every message (not only when agents are offline)
Channel name	Channel username (with or without @)
Message	Template with merge fields

Merge fields: \{message\}, \{sender_name\}, \{sender_email\}, \{conversation_link\}, \{attachments\}

Add the bot as an admin of the target channel so it can post notifications.

---

Rich messages

Rich messages are converted to Telegram format when possible (inline keyboards for buttons/chips/select, images as photos, etc.). Unsupported parts may be removed or simplified.

---

Chatbot and AI

Feature	Supported on Telegram
Chatbot	Yes
Human takeover	Yes — OpenAI & AI
Language detection	Yes
Spelling correction	Yes
Multilingual via translation	Yes
Google search	Yes
Speech recognition (visible transcript)	No — audio is handled by the chatbot internally, but the Speech recognition setting does not add on-screen transcription for Telegram voice messages

Use Disable chatbot to route all Telegram traffic to agents.

---

Channel behavior

Topic	Detail
Queue & routing	Supported — Queue & routing
Follow-up message	Supported — sends even if an agent already replied
Offline message	Supported — weekly timetable text is not sent on Telegram
User ban	Blocked usernames cannot start or continue chats

---

Webhook troubleshooting

Check webhook status (replace YOUR_BOT_TOKEN):

https://api.telegram.org/botYOUR_BOT_TOKEN/getWebhookInfo

getWebhookInfo issue	Action
Empty or wrong url	Click Synchronize now again
last_error_message mentions certificate	Fix HTTPS / SSL on your bot host
409 Conflict	Another server uses the same bot token — remove the other webhook or use a dedicated bot

---

Related