💬 Telegram Bot

Two ways to use Telegram in Synalux: as a chat provider for your team and patients, or as a sign-in method via Telegram Login Widget.

---

📨 Telegram Bot API Integration

Send and receive Telegram messages from inside Synalux's unified chat surface. No separate Telegram app for staff to monitor.

* Webhook-driven — incoming messages POST to /api/v1/telegram/webhook and surface in the Synalux chat surface in real time.

* Send — outbound replies via /api/v1/telegram/send. Workspace-scoped bot token; one bot per workspace.

* Bot setup — provide your bot token from @BotFather in the workspace settings; webhook URL auto-registers via setWebhook.

* Media support — text, images, documents, voice notes (transcribed via the Transcription module on receipt).

---

!Team Chat Integration

🔐 Telegram Login Widget

End-to-end implementation of the Telegram Login Widget for sign-in.

* Users click a Telegram-blue button on /auth; Telegram OAuth flow returns user identity (telegram_id, name, photo).

* Identity is bound to a Synalux user record; subsequent sign-ins are one-tap.

* bot_token HMAC validation per the Telegram Login Widget spec — replay-attack proof.

---

🏗️ Architecture


POST /api/v1/telegram/webhook      Webhook ingress (validated against bot token + IP allowlist)
POST /api/v1/telegram/send          Outbound message (workspace-scoped)
GET  /api/v1/telegram/auth/callback Login Widget callback (HMAC-validated)

Provider abstraction: lib/message-providers/telegram.ts — same shape as Gmail / Outlook / Slack so the unified chat surface lights up automatically.



---

🧪 Tests

24+ tests cover bot routes + lib (auth callback HMAC validation, webhook ingestion, send queue, error paths, retry logic). See portal/src/app/api/v1/telegram/__tests__/`.

---

💳 Plans

Available on Standard+ as part of the unified chat experience. Free tier: receive only via the public landing page contact form.

See full pricing →