Contents
- Getting started
- Installing
- First setup and pairing the apps
- Lines and card readers
- Messages and calls
- Routing
- eSIM
- Compatibility list
- Network exits and proxy engines
- Hotspot and Wi-Fi
- Telegram bot remote control
- Status light (LED)
- Updates and backups
- Troubleshooting
- Users in the UK
- Comparison with other tools
Docs / 11
Telegram bot remote control
With your own Telegram bot, you get texts and call alerts in Telegram, and you can check the status, read and send texts, place calls, start or stop lines, and switch and download eSIMs. Remote control and calling need the Full plan.
Creating the bot and setting it up
- In Telegram, create a bot with
@BotFatherand note the token it gives you. - Get the ID of the chat you want to use (a private chat or a group).
- Under Phones & notificationsPhones & channels, turn on Telegram and fill in “Bot token” and “Chat / Channel ID”.
- Turn on “Remote control from Telegram (/esim, /status, /dial …), off by default” and save. When “Remote control status” says it is receiving commands, you are done.
If the gateway cannot reach Telegram, choose a proxy or country exit in “Telegram connection”. Tick “Send the voicemail recording too” to get voicemail in Telegram as well.
Commands
| Command | What it does |
|---|---|
/status | The version, how long the gateway has run, the plan in force, each line’s state and country exit, and host alerts. |
/lines | The lines and their numbers, each with a Start or Stop button. Stopping asks first and is refused during a call. |
/messages <line> [n] | The line’s latest texts, 5 by default, with a button to send a text at the end. |
/sms [line [number [text]]] | Sends a text. The bot asks for whatever is missing, one at a time, then shows the line, number and whole text for you to confirm. |
/dial <+number> [line] | Places a call; the sound goes through a Telegram voice call. |
/hangup [line] | Hangs up. |
/esim | Switch eSIM, rotate now, pause or resume rotation. Its card panel renames, disables and deletes profiles and sends notifications. With several cards it asks which one first. |
/info | Card information: the chip, EID, free space, number of profiles and the ICCID in use. |
/download <code> [confirmation code] | Downloads an eSIM; see below. |
/cc <confirmation code> | Answers a download that asks for a confirmation code. |
/rotate <minutes> | Sets the rotation interval. |
/hotspot [status | on [usb] | off] | Checks, turns on or turns off the hotspot (on machines that have one); see Hotspot and Wi-Fi. |
/help | The command list. The bot’s command menu lists them in your interface language too. |
Switching eSIM, rotating, dialling, sending a text, stopping a line, deleting a profile and turning on the hotspot ask you to confirm first. Numbers show only their last four digits; in a private chat, /info shows the whole EID and ICCID.
Downloading an eSIM from Telegram
- In the bound chat, paste an activation code starting with
LPA:, use/download, or send a picture of the eSIM’s QR code. - The bot deletes the message holding the code as soon as it has read it, and shows only the SM-DP+ address and the last four characters.
- Pick the card to download onto and choose “Confirm download”. Progress updates in the same message, and you can cancel at any time.
- If a confirmation code is needed, reply to the bot’s question or send
/cc <code>. When it is done, you can enable the profile straight away.
The download is the same as “Download eSIM” on the web, and the web eSIM page shows its progress too. One download runs at a time.
Who can give commands
- The bot listens only to the chat in “Chat / Channel ID”.
- In a group, list the Telegram user IDs of the people who may control it in “Users allowed to control from a group”. With no one listed, the group can only read; switching, dialling, texting and downloading are refused.
- Do not use the same bot in another program at the same time, or remote control stops.
Making and taking calls through Telegram
A bot cannot make calls, so the gateway needs a Telegram account of its own. Sign it in under “Telegram voice calls” in SettingsLines & callsCalls & voicemail, then:
- Turn on “Allow /dial from the Telegram bot” to call with
/dial. - Turn on “Ring my Telegram for incoming calls” to have calls ring your Telegram.
Use a Telegram account you can afford to have restricted, not your main one.