Connect a Telegram account

Settings → Accounts → Connect Account

Before you connect Telegram

You need a free account slot. Your slot count is shown as “{used} of {count} slots”. Slots are capacity, how many accounts you may connect, not live connections. Trials include 2 slots; paid plans 5 per seat, extendable with add-ons.
Entergram’s servers connect to Telegram on your behalf. There is nothing to install and no passphrase to manage; you just sign in with Telegram’s own login. The connection Telegram sees is a new logged-in device, listed under Settings → Devices like any other.

During onboarding, Entergram first shows what it accesses (basic account information, chat list and metadata, and group membership and activity timestamps) and asks you to accept the Terms of Service and Privacy Policy. Messages are fetched live from Telegram when you open a chat and are not kept as history in our database. See What Entergram accesses for the full breakdown.

The dialog asks “Choose how you want to authorize this Telegram account.”

QR code (recommended)

Open Telegram on your phone.
Go to Settings → Devices → Link Desktop Device.
Scan the code shown in Entergram.

The dialog shows “Waiting for scan from Telegram” and the QR’s expiry time. If it expires, a new one is generated.

Phone number

Enter your number with the country code, e.g. +1 234 567 890.
Click Connect.
The dialog title says where Telegram sent the login code: the Telegram app, SMS, a phone call, Fragment or email. Most often it goes to the Telegram app on your other logged-in devices, as a message from “Telegram”, not by SMS.
Enter the code and click Verify. For a call that hangs up at once, the dialog asks for the number that called you (flash call) or its last digits (missed call).

Didn’t get the code?

The code step has a Didn’t get the code? box:

Open Telegram on a phone or computer already signed in to this account and look for a chat named “Telegram”.
Resend code becomes available after a 60-second countdown. The wait protects you from tripping Telegram’s login rate limit. A resend is a new request, so Telegram picks the delivery channel again.
Use another sign-in method cancels this sign-in and goes back to the method choice, for example to scan a QR code instead.
Entergram can’t sign in with a Telegram passkey. Use the login code or a QR code.

Step 2, Telegram cloud password

If the account has Telegram two-step verification on, the dialog asks for your Telegram cloud password. This is the password you set in Telegram → Settings → Privacy and Security → Two-Step Verification. It is not your Entergram password or your Entergram authenticator code. Enter it and click Verify.

Entergram uses this only to complete the Telegram login.

Never share a login code or cloud password with anyone, including Entergram support. The dialog repeats this on the code and password steps.

Step 3, Wait for the first sync

Your chats begin loading. The first chat sync can take up to about five minutes depending on the size of the account. It runs on Entergram’s servers, so you don’t need to keep the tab open.

Reconnecting an account

Each account card in Settings → Accounts carries a status badge. A healthy account shows Live Sync Ready. When something needs your attention you’ll see:

Badge	Meaning	Action
Session expired	The Telegram session ended - usually terminated from Telegram’s Devices menu, or invalidated after a password change	Reconnect Live Sync
Reconnect Required	The account lost its live connection	Reconnect Live Sync
Needs Migration	The account was connected under the old flow and needs one fresh sign-in	Connect Live Sync

The button opens the same sign-in dialog. You must reconnect with the same Telegram account, signing in with a different one is rejected: “Cannot reconnect: You must use the same Telegram account.” Reconnecting doesn’t use up an extra slot.

Disconnecting

Settings → Accounts → Disconnect. The account stops syncing. Your CRM data for its chats stays in the workspace unless you delete it separately.

To also end the Telegram session itself, terminate it from Telegram → Settings → Devices in the Telegram app.

To let a teammate work the same inbox, sign that same Telegram login into their seat. Nothing is copied or forwarded - it’s simply the same account, connected twice.

Two ways:

They connect it from their own seat, or
You connect it for them, click the key icon next to their name in Settings → Accounts → Seats & Team Members. The dialog reads “Connect Telegram for {name}”.

Delegated connection requires:

the workspace setting Hide Telegram login codes from members to be on, and
a free account slot on that member’s seat.

Only the owner can connect an account for an admin; owners and admins can do it for regular members.

Common Telegram connection errors

If the Telegram connect step stops with a message, find it below.

Message	What to do
Too many attempts. Try again in …	Telegram rate-limited the login. Wait out the timer.
That code is not correct	Enter the latest code from Telegram. An older code stops working after a resend.
This code has expired	Click Resend code, or use another sign-in method.
Wrong Telegram cloud password	Enter your Telegram two-step verification password, not your Entergram password.
Telegram didn’t accept the cloud password	After a QR scan. Check the password, wait a minute, then try again.
Telegram limited sign-in attempts for this number	Wait a few minutes, or sign in with a QR code.
This account is already connected to another user	Disconnect it from the other Entergram user, or contact support.
QR authentication session expired	Start the QR flow again, the sign-in has a 5-minute window.
You can connect up to `{n}` Telegram accounts	You’re out of slots. Raise the limit or free one up.

Sign-in errors end with (Support reference: abcd1234). If you contact support, send that reference. It identifies the attempt without any code or password.