💬 Telegram Integration
The Telegram Integration lets you connect your AI Assistant to your own Telegram bot.
Once connected, users can chat with your bot directly in Telegram — and all conversations will appear in your Ainisa Business Chats dashboard in real time.
🌐 Manage Telegram Integrations
Go to your Business Dashboard → Integrations
👉 https://ainisa.com/business/integrations
From this page, you can view all existing integrations (Web, Telegram, etc.).
To create a new one, click Create Integration, then select Telegram.
⚙️ Creating a Telegram Integration
After selecting Telegram, you’ll see a form like this:
| Field | Description |
|---|---|
| Integration Title | A custom name for your Telegram integration (e.g., “Ainisa Telegram Support”). |
| Assistant | Select which AI Assistant will handle Telegram messages. |
| API Key | Choose your Ainisa API Key for authorization. |
| Bot Token | Paste your Telegram bot token (see below how to get it). |
Click Save when finished.
Your integration will be added to the list and ready to configure its webhook.
🤖 Getting Your Telegram Bot Token
If you don’t have a Telegram bot yet, you can create one easily:
- Open Telegram and search for @BotFather.
- Send the command
/newbot. - BotFather will ask for:
- Bot name (e.g., VakansiyaBiz AI Support)
- Bot username (must end with “bot”, e.g.,
vakansiyabiz_ai_bot)
- After setup, BotFather will send a message containing your bot token, similar to this:
1234567890:ABCdEfGhIjkLmNoPQRsTUVwXyZ - Copy this token and paste it into the Bot Token field when creating your Telegram integration.
⚠️ Important: Keep your bot token private. Anyone with this token can control your bot.
🔗 Setting Telegram Webhook
When you create a Telegram Integration in Ainisa, the platform automatically configures your Telegram bot’s webhook if your Bot Token is correct.
The webhook connects your Telegram bot with Ainisa’s API, allowing messages to flow between Telegram users and your AI Assistant.
⚙️ Automatic Webhook Setup
If your Bot Token is valid, Ainisa will automatically register the webhook with Telegram during integration creation.
In the Integrations list, you’ll see:
| Icon | Meaning |
|---|---|
| ✅ Green check | Webhook successfully set — your bot is connected. |
| ❌ Red cross | Webhook not set — usually means the Bot Token is invalid or Telegram rejected it. |
You don’t need to take any extra steps if you see the green check — your Telegram bot is live and ready.
🔁 Manual Webhook Setup
If the webhook wasn’t set automatically, you can manually apply it.
- Go to Business Dashboard → Integrations
👉 https://ainisa.com/business/integrations - Find your Telegram integration in the list.
- Click the ⋯ menu on the right.
- Choose Set Webhook.
- On the opened page, click the Set Webhook button to confirm.
Ainisa will send the webhook request to Telegram using the URL displayed, which looks like: https://api.ainisa.com/api/v1/webhooks/telegram/aaaaa-11111-3333-eeeee-mmmmmmm
Once successful, your webhook indicator in the list will change to a green check.
🧩 Notes
- The webhook is what allows Ainisa to receive and respond to messages instantly.
- Normally, you don’t need to set it manually — only do this if the automatic setup fails.
- If your bot token is later changed in @BotFather, remember to update it in Ainisa and reapply the webhook.