Connecting a Telegram account

Sign-in by QR code or phone number, the cloud password, how many accounts a plan gives, disconnecting.

Routify reads private sources through a Telegram account you connect — the bot then sees the chats that account sees. Without an account the source can only be a public channel or group, or a chat where our bot is an administrator; private channels, groups, people and bots are read only through an account. Connecting one is optional: public channels do not need it, see Getting started.

The account is connected right on the home screen of the mini app: while there are no accounts — with the connect your account link in the "To monitor private chats and groups, connect your account" line, later — in the Connected accounts block below the destinations. One more way is the Connect account button in the wizard's Destination block.

Why an account

A bot only receives messages from chats it has been added to, and it cannot be added to a private channel or a group you do not manage. Your account already is in those chats. Routify signs in to Telegram as that account — the way a second phone or a desktop app would — and receives the same updates. The account is also what sends the messages when you choose delivery from the account rather than by the bot, see Delivery modes.

Connecting

Press Connect account (or Connect another account when one is already connected). The Connect Telegram account screen opens: at the top — why an account is needed ("We only read the chats you choose"), below — two ways to sign in: QR code (Recommended) and Phone.

By QR code — no SMS code needed, and easier with a cloud password:

  1. Pick QR code. The app shows a code; it refreshes by itself until you scan it.
  2. Open Telegram on another device → Settings → Devices → Link Desktop Device and point the camera at the code. If the code has expired, press Show a new code.
  3. If the account has a cloud password, the app asks for it next. Enter it and press Confirm.

Nothing to scan with — Sign in with a phone number switches to the other way.

By phone number:

  1. Pick Phone. Phone number — enter it in international format, for example +1 234 567 8901, and press Send code.
  2. Code — Telegram sends a confirmation code to that account, as it does when you sign in on a new device. Enter it and press Confirm.
  3. Cloud password — if the account has two-step verification, the app asks for the password right after the code. It is the password you set in Telegram (Settings → Privacy and Security → Two-Step Verification), not the login code. There is no need to turn two-step verification off before connecting.

The app reports Account connected, and the account appears in the list.

Choosing how to sign in
Choosing how to sign in

If you are connecting the same account you are using Telegram in right now, type the code with underscores between the digits, for example 1_2345. A code typed as is into a chat of the same account is treated by Telegram as leaked, and the sign-in is rejected. The underscores are removed on our side.

If the sign-in fails, the app says why: the code is wrong or has expired, the sign-in attempt was interrupted, the cloud password is wrong, Telegram asks to wait N seconds, the number is not accepted, is banned or is not registered in Telegram. When a new code is needed, a Send a new code button appears under the field. If there were too many code requests, or Telegram cannot send a code to the number, the app suggests connecting with a QR code instead. A wrong code or password can be entered at most 5 times per sign-in — after that, start over.

Several accounts

The number of connected accounts depends on the plan: Pro — 1, Expert — 3, Ultra and the trial — 5, Business — no limit; without a plan — 1. The list shows how many are used — Accounts: 2 of 3. Once the limit is reached, the connect button is replaced by Your plan's connected-account limit is reached with a button to the plans. Signing in again with the same account does not take another slot, but paused accounts count against the limit too, and at the limit the app hides the connect button — remove an account you no longer need first. See Plans.

Each account has its own list of chats: when you add a source or a destination, you first pick the account, then a chat of that account. One account can serve as the reader of the sources and another as the sender for the destination.

The list on the home screen shows every account with its photo, phone number, status — Active or Paused — and a Premium mark when the account has Telegram Premium. Premium decides whether premium emoji can go into the template of a source this account delivers.

When an account stops working

A session can end outside Routify: you terminate it in Telegram's Settings → Devices, change the password, or Telegram signs it out. Routify marks the account inactive and sends an Account disconnected message with the number to your chat with the bot; the sources and destinations bound to it stop. Connecting the same account again (the steps above) brings the paused entry back to life — if the plan's account limit allows the connect button to be shown. If you delete the entry instead (the bin icon), its forwards stay bound to the deleted account and are not moved to a new one: create them again.

If the account unsubscribed from a channel

Sometimes the account a source channel is read through unsubscribes from it or leaves it. If the channel is public, delivery does not stop: Routify switches that channel to its own built-in service session and keeps reading it. While the channel is read this way, its deletions are synced as usual, but edits are not; subscribe to it with the account again and reading goes back to the account.

A private channel or group cannot be read this way: for those the account has to stay subscribed. If there is nothing to read the channel with, the bot sends Source unavailable with the rule number — subscribe the account to the channel or replace the source.

An account that delivers the posts itself also has to stay in the destination chat: if it leaves or loses the right to post, the forward is paused, see When a forward stops.

Disconnecting

Tap the bin icon next to the account in that list; the app asks Disconnect this account?. Confirm, and:

  • every source read through this account and every destination that sends from it is paused;
  • the session is deleted on our side.

The session also shows up in Telegram's Settings → Devices as an active device; you can terminate it there at any time, before or after disconnecting. How sessions are stored and what the bot can and cannot do with them is in Security.

Set up your first forward today

Every post you copy by hand is time the bot could save you. Open the bot, send a public channel’s link and pick where to forward it: the first messages arrive within minutes.

Open @RoutifyBot