Direct and group support
Use one bot account for private chats and group conversations.
Available now
Telegram Integration
Connect a Telegram bot to Lumika for direct-message support, group assistance, and robust webhook-based delivery.
Operational Behavior
What you get out of the box
Webhook with secret validation
Inbound updates are verified with Telegram webhook secret for safer processing.
Markdown-capable responses
Outgoing messages support rich formatting so headings and structure render cleanly.
Customer approval controls
Account/customer status model controls whether assistant replies are allowed.
How Telegram Connection Works
The mechanics behind the integration
Security model
Lumika uses your bot token server-to-server and validates incoming webhook signatures/secrets.
- Your bot token is stored on the backend and used only for Telegram API calls.
- Webhook callback includes a secret token check to reject invalid traffic.
- You can rotate credentials by re-running setup with a fresh bot token.
Conversation model
Each Telegram user/chat maps to a customer record in Lumika with activity timeline.
- Incoming messages create or update customer identity fields.
- When account status requires approval, customer status determines if replies are allowed.
- Manual messages and internals can be managed from Activities.
Telegram Setup Instructions
Get connected step by step
End-to-end setup for BotFather token, Lumika connection, and webhook activation.
01
Create a Telegram bot in BotFather
- Open Telegram and search for @BotFather.
- Run /newbot and follow prompts for bot name and username.
- Copy the bot token returned by BotFather.
Store the token securely. Anyone with this token can control your bot.
02
Connect bot in Lumika
- In Dashboard → Integrations, create or open Telegram integration.
- Paste the bot token and save setup.
- Assign a Responder assistant in the account card (required for replies).
- Choose response mode: Auto or Manual approval.
03
Webhook configuration and test
- Lumika configures webhook automatically after successful setup.
- Webhook endpoint used by Lumika: https://api.<your-domain>/webhook/telegram/<bot-id>.
- Send a test DM to the bot and verify activity appears in dashboard.
- Add the bot to a group and validate mention/reply behavior with your settings.
Get started
Launch Telegram Support
Create your Telegram integration, validate webhook delivery, and start handling conversations from one dashboard.