A Telegram account is optional: a campaign's All of Telegram mode works without one - we read the public chats. You need an account to:
- watch your own chats - groups and channels you are a member of;
- reply to leads on Telegram on your behalf - in the chat or in a DM;
- publish your own posts and see who responded to them.
Open Settings → Accounts and in the Telegram block press Connect. You can also connect an account right from the campaign wizard: once connected, press Back to the campaign and you are returned to the same step.
The connect panel has a What we do with this account block: we read only the chats you added to a campaign yourself, we do not read or export your private conversations, and you can disconnect in one click.
Option 1. QR code (fastest)
The panel opens straight on the QR code (Scan this code in Telegram).
- 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 expired, just wait for a new one.
Option 2. A code from Telegram
Under the QR code press Sign in with a Telegram code.
- Enter the Phone number in international format:
+380XXXXXXXXX. It must be the number your Telegram runs on. - Press Send the code.
- Enter the code you got in Code from Telegram and press Confirm.
ℹ️ 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 where exactly it was sent.
No code - press Send it again once the countdown ends.
Cloud password
If two-step verification is on for the account, a Cloud password field appears. Enter your Telegram two-step verification password (not the SMS code) and press Sign in.
How replies should refer to you
The last step is How replies should refer to you: Masculine, Feminine or Prefer not to say. It decides the grammatical forms in generated replies - in Ukrainian and Russian, for example, word endings depend on it. Press Done.
You will see Account connected - now you can pick it in a campaign.
Account statuses
| Status | What it means |
|---|---|
| Connected | Everything works |
| Paused by Telegram | Telegram temporarily limited the account. It comes back by itself, no need to reconnect. The remaining wait is shown next to it |
| Needs reconnecting | Telegram ended the session - for example, it was closed from another device. Press Reconnect: your campaign settings and leads are untouched |
| Disconnected | The account is disconnected from monitoring. Reconnect it so campaigns read the chats again |
How many accounts you can connect
The limit depends on the plan, and Telegram and Threads are counted together: Trial - 2, Starter - 2, Growth - 6, Scale - 20.
Disconnecting
In the account menu choose Disconnect. Campaigns listening to chats through this account go quiet; the leads and conversations you already have stay.
Common problems
The code does not arrive
Most often the code went inside the app, not to SMS. Open Telegram on a device where you are signed in and find the message from the "Telegram" account. No access to Telegram right now - sign in with the QR code.
"This number is already connected in another workspace"
One Telegram account can work in only one workspace. Disconnect it there, then connect it here.
"This number already used its free trial in another workspace"
A trial is given to a number only once. To connect this number you need a paid plan - the Go to the plan button.
"Paused by Telegram"
Telegram temporarily limited the number of requests from the account - this is the platform's protection, not an error. Wait: the limit lifts by itself. You can set up the campaign already, and monitoring starts automatically.
Monitoring suddenly stopped
Check in Telegram: Settings → Devices. If the Telegrin session was ended by hand, the account in Telegrin shows Needs reconnecting - press Reconnect.