Contents
  1. Getting started
  2. Installing
  3. First setup and pairing the apps
  4. Lines and card readers
  5. Messages and calls
  6. Routing
  7. eSIM
  8. Compatibility list
  9. Network exits and proxy engines
  10. Hotspot and Wi-Fi
  11. Telegram bot remote control
  12. Status light (LED)
  13. Updates and backups
  14. Troubleshooting
  15. Users in the UK
  16. 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

  1. In Telegram, create a bot with @BotFather and note the token it gives you.
  2. Get the ID of the chat you want to use (a private chat or a group).
  3. Under Phones & notificationsPhones & channels, turn on Telegram and fill in “Bot token” and “Chat / Channel ID”.
  4. 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

CommandWhat it does
/statusThe version, how long the gateway has run, the plan in force, each line’s state and country exit, and host alerts.
/linesThe 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.
/esimSwitch 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.
/infoCard 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.
/helpThe 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

  1. In the bound chat, paste an activation code starting with LPA:, use /download, or send a picture of the eSIM’s QR code.
  2. 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.
  3. Pick the card to download onto and choose “Confirm download”. Progress updates in the same message, and you can cancel at any time.
  4. 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

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:

Account

Use a Telegram account you can afford to have restricted, not your main one.

Written for Cevix 2.0.4.