Telegram is connected by pasting a bot token. Natiq validates the token with Telegram and registers the webhook for you, so there's no callback URL to copy anywhere.
Create a bot (if you don't have one)
The Connect a Telegram bot panel asks "Do you already have a bot?". If not, create one in Telegram first. It takes about a minute:
Open @BotFather in Telegram (the panel has an Open @BotFather button).
Send the command
/newbot.Pick a display name, the one people see at the top of the chat. You can change it later.
Pick a username. It must end in "bot", for example
acme_support_bot. Usernames are unique across all of Telegram, so a short one is probably taken, and you can't change it later.Copy the token BotFather sends back.
Connect the bot
Open Connect, go to the Catalog tab and select Telegram.
Paste the token into Bot token. Tokens look like
123456789:AA.... If yours doesn't match that shape you get a soft warning, but you can still send it: Natiq checks it with Telegram.Select Connect bot. Natiq shows "Validating the token and registering the webhook...".
When it says your bot is connected, open the chat in Telegram and send your bot a message. It should appear in your Inbox.
Under Who should answer, pick an agent or live agents, or select Decide later.
Pick who answers now
If you choose Decide later, your bot receives messages and never replies until you assign an agent. You can change it any time from the channel row on the Connected tab. See Choose who answers a channel.
The channel is named after the bot's username by default. You can rename it later with Edit.
If the bot already sends elsewhere
If the bot is already connected to another tool, Natiq shows This bot already sends to another tool. Connecting it here points the bot at Natiq, and the other tool stops receiving its messages. Select Connect here anyway only if that's what you want.
Common errors
| Message | What to do |
|---|---|
| Paste the token BotFather gave you. | The token field was empty. |
| Telegram rejected that token. | Copy it again from BotFather, or send /token there for a fresh one. |
| That bot is already connected. | Disconnect it where it's in use, or create a second bot for this workspace. |
Refresh a connection
If you regenerate the token in BotFather, or the bot stops receiving, select the refresh icon (Refresh connection) on the channel's row. Natiq checks the bot with Telegram and registers its webhook again. Paste a new token only if you regenerated it; leave the field empty to keep the token you already connected.