SIP account Owner — a Telegram user who creates a SIP account in the @siptg_bot bot. The owner has full control over creating, deleting, and changing SIP account settings, and can also assign accounts to other users.
SIP account User — a person to whom the owner has assigned a SIP account. They can use the account to make and receive calls, but cannot change the settings of the account itself.
The subscription for the softphone must be activated to the Telegram account of the Owner. The user’s subscription has no effect on SIP accounts that belong to other owners!
Most settings are displayed directly on the buttons in the form of current values. To change these settings, simply press the corresponding button and enter a new value as requested by the bot.
However, some buttons work differently:
Getting started with the bot
/softphone
section.Entering SIP account parameters
Additional settings
Test calls
User assignment
Additional settings
Some settings take effect after pressing the “Apply” button, or after 5 minutes. After completing the steps, the account will become active and ready to work.
Screenshot with SIP account settings
Audio codecs
The choice of codecs affects the quality and compatibility of voice communication. Opus, alaw, mulaw, GSM, and other codecs are supported.
DTMF transmission methods
DTMF is necessary for interacting with voice menus. Available methods are RFC2833 (recommended), INFO, and inband.
Call recording
You can activate or deactivate automatic call recording, and also select a separate chat or channel for saving audio recordings.
User assignment
Allows assigning SIP accounts to other Telegram users, giving them the ability to use accounts for calls without access to settings.
Worker server
Allows you to select the server that will connect to the PBX or telephony provider.
There are 4 types of servers:
Server type | Description | Designation |
---|---|---|
SIP.TG public servers | Main servers supported by SIP.TG | ✅ |
Public servers of other users | Publicly available servers hosted by other users | 🌐 |
Public servers of telecom providers | Available with some Settings Templates, provided by third-party providers | 📡 |
Private servers | Your own servers, available only for your SIP accounts | 🔑 |
On a free subscription, only some of the SIP.TG public servers are available.
Dialing rules
Allow transforming the number for an outgoing call before sending it to the SIP provider or PBX, as well as removing unsuitable SIP accounts from the line selection request for a call (for example, if you prefer to make calls to different countries through different SIP accounts).
See the detailed description in the Transforming outgoing numbers section.
Sometimes for outgoing calls, it’s necessary to automatically change the dialed number to meet the requirements of the SIP provider or PBX (for example, replace the first “8” with “+7” or remove spaces and brackets). In SIP.TG, this is configured using Transformation Rules in the SIP account settings.
If your provider accepts numbers in any format or you’re using a ready-made Settings Template, dialing rules are most likely not needed. Before making changes, check the requirements for the number format with your SIP provider or within the PBX.
There are 2 types of rules:
All rules are separated by spaces and applied in sequence. As soon as the number stops matching even one filter rule (without ”=”), the use of the SIP account for calling that number is not allowed. Each replacement rule (with the ”=” sign) changes the number before it’s checked by the following filter rules.
/softphone
section.All rules work on the “left to right” principle. Note that adding too many filters or ambiguous replacements can lead to unexpected results. For complex scenarios, test with a couple of real numbers.
Let’s consider the task: we dial numbers like “8 (926) 123-45-67”, but the provider requires “7XXXXXXXXXX”.
Suppose we need to remove all non-digit symbols and turn the prefix 8 into 7.
Here are two rules (written with a space):
The first removes all characters except digits, letters, plus, and some special characters (*, #, _).
The second replaces the first digit 8 with 7.
Now if the user enters 8 (926) 123-45-67
, after the first rule the string will become 89261234567
, and after the second — 79261234567
.
Let’s consider the task: we dial numbers like “8 (926) 123-45-67”, but the provider requires “7XXXXXXXXXX”.
Suppose we need to remove all non-digit symbols and turn the prefix 8 into 7.
Here are two rules (written with a space):
The first removes all characters except digits, letters, plus, and some special characters (*, #, _).
The second replaces the first digit 8 with 7.
Now if the user enters 8 (926) 123-45-67
, after the first rule the string will become 89261234567
, and after the second — 79261234567
.
If you need to allow outgoing calls only to Russian mobile numbers (starting with 79 and then 9 digits), use a filter rule:
Without the ”=” sign. If the number doesn’t match ^79\d{9}$
, the SIP account won’t be used.
Sometimes you need to discard everything if the user accidentally entered an invalid number. You can use a replacement rule to empty:
This will cause any number to be replaced with an empty string. If an empty string doesn’t suit the operator, the call won’t happen.
If you encounter problems or errors, see Troubleshooting.