Telegram
Telegram connects your own Telegram account to Pinlyx, the same way Telegram Desktop logs in on a new computer. Once it is connected, the people who write to that number appear in Contacts, and you can reply, run campaigns and post to your groups from Pinlyx. It is the one channel included on the Free plan.
How it works
Section titled “How it works”You log in with your phone number and the code Telegram sends you. Pinlyx keeps the resulting login session encrypted and uses it to send and receive messages for that number. Your Telegram password is never shared with Pinlyx: if the account has two-step verification, you type the cloud password once to finish the login.
Each connected number:
- brings its conversations into Contacts, where you read and reply;
- sends at a controlled pace of up to 20 messages an hour, so it stays clear of Telegram’s spam limits;
- takes one slot from your plan’s account pool (see Channels).
Connect a Telegram account
Section titled “Connect a Telegram account”-
Open Customers & messaging › Accounts and select Connect account.
-
Under Messaging, choose Telegram.
-
Enter the Phone number in international format, with the country code, for example
+905551234567.Display name is optional and only helps you tell accounts apart in Pinlyx.
-
Optionally open Proxy (optional) to route this number through your own proxy. Pick the Protocol (HTTP or SOCKS5) and enter Host and Port, plus Username and Password if the proxy needs them. Leave it closed to connect directly.
-
Select Next. Telegram sends a 5-digit login code to your Telegram app, in the chat named “Telegram”.
-
Enter the code and select Verify code. If the code does not arrive, wait for the countdown and select Resend code.
-
If the account uses two-step verification, enter its Cloud password and select Confirm 2FA password.
-
The dialog confirms the account is connected and it appears in the list as Connected.
Account status
Section titled “Account status”The Status column on Accounts tells you whether a number can send right now. Accounts that need attention are listed first.
| Status | What it means | What to do |
|---|---|---|
| Connected | Logged in and sending normally. | Nothing. |
| Limited | The number used its hourly budget. The row says when it resumes. | Wait. Queued messages continue on their own. |
| Code needed | The login started but the code was never entered. | Select Enter code on the row. |
| Needs login | The session is gone. The reason line says why: the login was not finished, Telegram ended the session, Telegram asked to wait after too many tries, or Telegram blocked the number. | Select Log in again on the row. |
| Paused | You switched sending off. | Open the row menu and select Resume sending. |
Log in again
Section titled “Log in again”When Telegram ends a session (for example after it is terminated from Telegram’s list of active devices), the number stops sending until you log in again. Nothing else in Pinlyx is lost: contacts and conversation history stay.
-
On Accounts, select Log in again (or Enter code) on the account row. For a healthy account, the same screen opens from the row menu with Re-verify session.
-
On Log in to Telegram, select Send code.
-
Enter the code from your Telegram app and select Verify code.
-
If asked, enter your cloud password and select Verify password.
Manage an account
Section titled “Manage an account”Open the row menu on Accounts for these actions:
- View details: the sending budget for this hour, phone number, Telegram username, proxy and login session.
- Edit account: change the Account name, add a Note, or set or clear the proxy.
- Pause sending / Resume sending: stop the number from sending without disconnecting it.
- Delete account: removes the number and its login session from Pinlyx. This cannot be undone.
Message customers
Section titled “Message customers”Telegram conversations appear in Contacts together with your other channels. Open a contact to read the chat and reply from the number that holds the conversation. You can send text, photos and files, and insert your saved templates.
To message many people, use the sending queue or a campaign instead of one chat at a time. Both respect the same per-account pacing. See Campaigns and Safe sending.
If you want to send messages from your own code, see Send a Telegram message.
Groups and channels
Section titled “Groups and channels”A connected number can also work with Telegram groups and channels:
- Post to them: in the Social scheduler, Add Telegram groups lists every group and channel the account is allowed to post in. Pick the ones you want and schedule posts to them like any other network. The Social scheduler is part of Pro and Business.
- Find people in them: Lead discovery can collect members from public groups and channels with one of your Telegram accounts. See Lead discovery.
Good to know
Section titled “Good to know”- The Free plan includes one Telegram account. More numbers need a plan with more slots.
- Each phone number can be connected once. Connecting it again shows “An account with this phone number already exists”.
- A paused account does not use a slot from your pool.
- The Telegram sends this hour card at the top of Accounts adds up what all your numbers have sent this hour.
Troubleshooting
Section titled “Troubleshooting””Too many requests” when sending the code
Section titled “”Too many requests” when sending the code”Telegram limits how often a number can ask for login codes. The Send code button shows a countdown: wait until it ends. Requesting again too early makes the wait longer.
The account keeps going back to Needs login
Section titled “The account keeps going back to Needs login”Check the reason line on the row. “Telegram ended this login session” means the session was closed on Telegram’s side: log in again. “Telegram has blocked this number” means Telegram banned it, and logging in again will not help. For more, see Troubleshooting.