دليل المنتج
تيليجرام
Connect your Telegram account, configure channel settings, and manage Telegram contacts within SkyLight Chat.
Telegram
Engage customers on Telegram with the same unified inbox, AI agents, and campaign tools you use for WhatsApp. This guide covers connecting your Telegram account, adjusting settings, and managing Telegram-specific contacts.
Purpose
Telegram integration brings your Telegram conversations into SkyLight Chat so you can:
- Centralize messaging — handle Telegram and WhatsApp in one inbox.
- Deploy AI agents — automate replies using your knowledge base.
- Run campaigns — broadcast to Telegram contacts (where applicable).
- Track conversations — see full chat history and contact profiles.
- Collaborate — assign chats to team members, add notes, and transfer between agents.
Who can access
| Role | Permissions |
|---|---|
| Owner | Full access — connect, disconnect, configure settings |
| Admin | Full access |
| Member | View and reply to conversations; cannot change channel settings |
| Viewer | Read-only |
Prerequisites
- Telegram account — a personal or business Telegram account to link.
- Telegram app installed — needed to scan the connection QR code.
- Plan with Telegram access — verify your subscription includes Telegram channel support.
Full walkthrough
Connecting Telegram
- Go to Channels → Telegram.
- Click Connect Telegram.
- A QR code appears on screen.
- Open Telegram on your phone → Settings → Devices → Link Desktop Device.
- Scan the QR code with the Telegram app.
- Wait 5–15 seconds; the status changes to Connecting, then Connected.
Once connected, your Telegram conversations sync into the SkyLight Chat inbox.
Verifying connection status
| Status | Meaning |
|---|---|
| Connected | Account linked and syncing |
| Connecting | Link in progress; keep waiting |
| Disconnected | No active link |
| Error | Sync issue; try refreshing or reconnecting |
Click Refresh to pull the latest status from the server.
Configuring Telegram settings
- Open the Settings tab under Channels → Telegram.
- Adjust:
- Display Name — label shown in the inbox (e.g., Support Bot).
- Auto-Reply — enable to have the AI agent respond automatically.
- Assigned AI Agent — select which agent profile handles Telegram chats.
- Notifications — toggle browser and email alerts for new messages.
- Click Save.
Managing Telegram contacts
Telegram contacts appear automatically when someone messages you. To add a contact manually:
- Go to the Contacts tab.
- Click + Add Contact.
- Enter:
- Name (required)
- Phone (required, E.164 format)
- Email (optional)
- Select Type = Telegram.
- Click Save.
You can tag, list, and segment Telegram contacts just like WhatsApp contacts.
Disconnecting Telegram
- Go to Channels → Telegram.
- Click Disconnect.
- Confirm the dialog.
Disconnecting removes the Telegram session from SkyLight Chat. Your Telegram account remains active on your phone. To reconnect, repeat the QR code flow.
Field glossary
| Field | Description |
|---|---|
| Username | Telegram @handle or phone number |
| Display Name | Custom label for the inbox |
| Status | Connected, Connecting, Disconnected, Error |
| Last Synced At | Timestamp of the most recent sync |
| AI Agent | Assigned agent profile for auto-replies |
| Auto-Reply | When enabled, the AI agent responds to new messages |
Statuses and badges
| Status | Badge color | Meaning |
|---|---|---|
| Connected | Green | Fully operational |
| Connecting | Yellow | Link in progress |
| Disconnected | Gray | Not linked |
| Error | Red | Sync failure; action required |
| Credentials | Orange | Session expired; reconnect needed |
Nested screens
Connection status card
| Element | Description |
|---|---|
| Status badge | Visual indicator of connection health |
| Username/phone | Identifies the linked Telegram account |
| Last synced | Shows recency of data sync |
| Connect/Disconnect button | Action to link or unlink |
Settings tab
| Option | Description |
|---|---|
| Display Name | Editable label |
| Auto-Reply toggle | On/Off switch |
| AI Agent dropdown | Select from available agent profiles |
| Notifications checkboxes | Browser, email, mobile push |
Contacts tab
| Column | Description |
|---|---|
| Name | Contact display name |
| Phone | E.164 phone number |
| Tags | Applied labels |
| Last Message | Timestamp of last conversation activity |
| Actions | Edit, view conversation, delete |
Connections to other areas
| Feature | How it connects |
|---|---|
| Inbox | Telegram conversations appear alongside WhatsApp and other channels |
| AI Agents | Agents can be assigned to auto-reply on Telegram |
| Contacts | Telegram contacts share the same contact database (filtered by type) |
| Campaigns | Campaigns can target Telegram contacts (where messaging policies allow) |
| Webhooks | message.received and message.sent events include Telegram messages |
Limits and plan behavior
| Plan | Telegram channel | Contacts (shared) |
|---|---|---|
| Starter | Not included | 500 |
| Pro | 1 channel | 5,000 |
| Business | 1 channel | 10,000 |
| Enterprise | Multiple channels | Unlimited |
Telegram-specific rate limits follow platform policies; SkyLight Chat does not impose additional sending caps beyond plan quotas.
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| QR code expired | Took too long to scan | Click Regenerate QR and scan within 60 seconds |
| Connection stuck at "Connecting" | Network delay or app not updated | Wait 30 seconds; if still stuck, refresh and retry |
| Conversations not syncing | Session invalidated | Disconnect and reconnect |
| "Credentials" status | Password changed or session revoked on phone | Disconnect, then reconnect by scanning a new QR |
| Cannot send messages | Channel disconnected or rate-limited | Check connection status; wait if rate-limited |
| Duplicate contacts | Same phone added for multiple channels | Contacts are unified by phone; use tags or type filter to distinguish |
Related articles
- Inbox — unified messaging view
- AI Agents — automate Telegram replies
- WhatsApp Contacts — shared contact management
- Channels API — connect and manage channels via API