A Telegram account is needed so Telegrin can read chats and send replies on your behalf. Connect it before you create a Telegram campaign.
Open Settings → Accounts and press Connect.
Method 1. QR code (the fastest)
The panel opens on the QR code straight away.
- Open Telegram on your phone.
- Go to: Settings → Devices → Link Desktop Device.
- Point the camera at the code in Telegrin.
The code refreshes by itself while the panel is open - if it has gone stale, just wait for the next one.
Method 2. Code from Telegram
Under the QR code, press Sign in with a Telegram code.
- Enter your phone number in international format:
+380XXXXXXXXX. It must be the number your Telegram runs on. - Press Send the code.
- Enter the code you receive in the Code from Telegram field.
ℹ️ Note: if you are already signed in to Telegram on any device, the code arrives as a message inside Telegram from the "Telegram" account, not by SMS. Telegrin tells you exactly where the code was sent.
The code is valid for a few minutes. If you missed it, press Send it again (available once a minute).
Cloud password (two-step verification)
If two-step verification is enabled on the account, a Cloud password field appears. Enter your Telegram two-step verification password - this is not the SMS code.
How replies should refer to you
The last step is choosing a grammatical form: Masculine, Feminine or Prefer not to say. It decides the word endings in generated replies - the equivalent of "he wrote" versus "she wrote" in gendered languages. The step is optional.
After that you will see Account connected - it can now be picked as a source in a campaign.
Account statuses
| Status | What it means |
|---|---|
| Connected | Everything works |
| Paused by Telegram | Telegram has temporarily limited the account. It will resume by itself, no need to reconnect - Telegrin shows the approximate wait |
| Needs reconnecting | Telegram ended the session. Press Reconnect so campaigns read chats again |
How many accounts can be connected
The limit depends on your plan, and Telegram and Threads count together: Trial - 2, Starter - 2, Growth - 6, Scale - 20.
Disconnecting
In the account menu, choose Disconnect. Campaigns that were listening to chats through this account will pause; the leads and conversations you already have stay where they are.
Common problems
The code does not arrive
The most common reason is that you already have an active Telegram session, so the code went inside the app rather than to SMS. Open Telegram on a device where you are signed in and look for the message from the "Telegram" account. If you have no access to Telegram right now, use the QR code sign-in.
"This number is already connected in another workspace"
One Telegram account can be connected to only one workspace. Disconnect it there first, then connect it here.
"Paused by Telegram"
Telegram has temporarily limited the number of requests from the account - this is standard platform protection, not an error. Wait: anything from a few minutes to a few hours, and the limit lifts by itself. You can set the campaign up right now; monitoring starts automatically.
Monitoring suddenly stopped
Check in Telegram: Settings → Devices. If the Telegrin session was ended manually, the account has to be connected again.