LINQ Chat SDK / Telegram + Linq

Wire Telegram and Linq into this API without touching raw webhook commands.

This page checks Postgres, verifies your Telegram bot token, stores webhook secrets in the database, and lets you register both the Telegram bot webhook and the minimal Linq inbound-message webhook.

Inspect API routes Manage threads

Setup Control

Register Webhooks

Public app URL Used to build /api/webhooks/telegram and /api/webhooks/linq?version=2026-02-03. Change this if you are behind a proxy or tunnel. Setup access token Optional guard for the setup endpoints. The app never writes this token anywhere. Rotate the stored webhook secret before registering the webhook

The Linq setup button creates the smallest subscription possible: message.received only, with the signing secret stored in Postgres for raw payload intake.

Status

Connection Snapshot

Database

Checking…

Pending

Telegram token

Checking…

Pending

Webhook secret

Checking…

Pending

Telegram webhook

Checking…

Pending

Expected webhook: —
Stored secret: —
Telegram bot: —
Telegram username env: —
Setup access token: —

Loading status…

BotFather Guide

Make the Telegram bot

Open Telegram and start a chat with @BotFather.
Send /newbot and choose a display name for the bot.
Choose a username that ends in bot, like linq_support_bot.
Copy the token BotFather gives you and set it as TELEGRAM_BOT_TOKEN.
Set TELEGRAM_BOT_USERNAME to the username without the leading @.
Set POSTGRES_URL or DATABASE_URL for this app, then come back here and click Register webhook.
After registration succeeds, open your bot chat and send /start or any message to verify the API responds.

Required Env

What to configure

POSTGRES_URL=postgres://...
TELEGRAM_BOT_TOKEN=123456:ABCDEF...
TELEGRAM_BOT_USERNAME=your_bot_name
BOT_SETUP_ACCESS_TOKEN=optional-setup-password

Tip: if you use the optional setup token, enter the same value in the field above before refreshing status or registering the webhook.