Work scheme "Office"

Allows employees connected to an office or virtual SIP-PBX to receive and make calls through their Telegram account.

Very convenient as an addition to office telephony for companies of any size.
Telegram softphone SIP.TG is a full-fledged business tool that can be used in teams of any size.

Our softphone will be especially convenient if employees already intensively use Telegram to interact with each other. There is no need to use third-party software, and the need to switch between applications is reduced. You can receive work calls from any of your devices, computer, tablet, mobile phone, etc. This is convenient both when working in the office and remotely.

Enjoy the reliability and convenience of Telegram, battery saving, and work even on unstable Internet connections anywhere in the world. Telegram voice transmission algorithms are specially adapted for weak communication channels and mobile devices, unlike classic SIP telephony.

All setup, testing, administration and payment for employee SIP accounts can be done from one administrator Telegram account. Employees receive configured and ready-to-use SIP accounts in one action.

Поддерживаются звонок по второй линии, перевод и удержание звонка. Телеграм-софтфон совместим со множеством CRM систем, где возможно применение стороннего софтфона.

See also:
Tariffs for using Telegram softphone

Setting up Telegram softphones for a team

Within the framework of this work scheme, we will define that the Administrator is the person whose task is to configure the PBX system and Telegram-employee accounts to work as softphones.
The scheme works with all popular PBXs, both virtual (UIS, OnlinePBX, Sipuni, etc.) and office (Asterisk, Panasonic, Oktell, FreeSWITCH, SipXecs, Yate, FreePBX and others).
Note: A reminder for employees on how to receive and activate settings from the Administrator, and then make calls through Telegram in Softphone mode is available via the link https://sip.tg/howtocall
The main tasks of the administrator when connecting employees according to the Office scheme:
  • create a separate SIP account on the PBX for each employee, enter their details into a text list in the login/password format
  • send to employees Telegram special messages with configured SIP accounts for making calls

There are 3 ways to transfer configured SIP accounts to employees:

Method 1: Using the “Transfer” button from the SIP account card

The most visual method, but not the most convenient for setting up a large number of accounts.
Setting up a SIP account to use Telegram like Softphone
SIP account parameters to use Telegram like Softphone
1
Contact @siptg_bot from your administrator account
2
Select item /softphone and click the “New” button (to connect a new SIP account)
3
Specify connection parameters and settings for the SIP account to be added
Usually it is enough to specify a login, password, server (optionally a domain with a port) and/or select the Server Template of your telecom operator or the type of PBX used.

Learn more about using Server Templates
4
We recommend that you immediately specify a name for the created SIP account (Name button), this will make it easier to distinguish between accounts in the list
5
For a configured SIP account, you can assign an employee using the “Transfer” button
After clicking the “Transfer” button, the recipient of the account is selected from the contact list.

Method 2: Text message mentioning @siptg_bot and SIP account parameters

Transferring a configured SIP account for use Telegram like Softphone
Obtaining a configured SIP account for use Telegram like Softphone
The most convenient way to set up for a large number of employees.

All you have to do is compose and send it to Telegram for each employee a text message mentioning @siptg_bot and SIP account details in a simple format.

In this case, an employee’s SIP account with the appropriate settings is created automatically when the settings are activated by the employee and is linked to the administrator’s tariff. Learn more about managing SIP accounts

IMPORTANT: For security reasons, the button for accepting settings on the employee’s side works for 5 minutes; you can press the button once. We recommend that before sending the settings, make sure in correspondence that the employee is ready to accept them.
Compose a message with settings
Format of a message to an employee for transferring SIP account settings:

@siptg_bot login pass {template|registrar [domain]} [codecs] [dtmf] [rules]

Key fields:
  • login — account login
  • pass — account password

One of the fields:
OR
  • register — account registration server (indicated if the template is not used)

Additional fields:
  • domain — the value of the from domain parameter, indicated only in conjunction with the registrar field
  • codecs — a list of audio codecs in order of priority, separated by commas (more about setting up codecs)
  • dtmf — a list of ways to send DTMF codes in order of priority, separated by commas (more about setting up DTMF)
  • rules — a list of rules for number conversion before dialing; rules are separated from each other by a space (more about the rules for number conversion)

For example, to connect to Multifon (for which there is a corresponding template called Multifon) with login somelogin1 and password somepass1, just enter:

@siptg_bot somelogin1 somepass1 mule

A tooltip will help you ensure that you have entered the settings correctly (see image above).

If there is no server template for your case, then a message with a full set of parameters may take the following form:

@siptg_bot somelogin1 somepass1 someserver.ru:1000 subdomain opus, g722/16 000,alaw, mulaw, g729 rfc2833 [^+*#\w]= ^8=7

Method 3: Follow the link to @siptg_bot and SIP account parameters

The essence of the method is that you can form Telegram- a link with SIP settings and place it in the user’s Personal Account.

This feature is convenient for large companies, where each employee has a personal account in the corporate system or, for example, for telecom operators.

In this case, the employee’s SIP account with the appropriate settings is connected to Telegram- the employee’s account is automatically assigned at the time the settings are activated, but such a SIP account is NOT linked to the administrator’s tariff. The owner of the SIP account will be only the employee himself.

Payment for users connected in this way must be made according to an individual cooperation scheme for telecom operators.
Creating a link with settings
The link can contain user data either in clear or base64-encoded form.

In the first case, the value separator is the = sign, and Login and Password can only contain the characters AZ, az, 0−9, _ and -.

In the case of a base64-encoded string, the values ​​are separated by a space, after which the generated parameter string is encoded via url-safe base64.

The URL format in clear text should be:

tg://resolve?domain=siptg_bot&start=login=pass=code

login — account login;
pass — account password;
queues — SIP template code (more about server templates).

In base64-encoded form, the link will look like the following:

tg://resolve?domain=siptg_bot&start=bG9naW4gcGFzc3dvcmQgY29kZQ==

If a base64-encoded string is used, you can also transfer settings without a SIP template, and the parameters are formed in the same way as the method of transferring SIP settings in dialog mode.

It is also possible to generate fake logins/passwords, which will be converted into real ones on your Worker server according to its own logic.

Learn more about using Worker servers

Managing employee SIP accounts

The administrator can change settings, disable, reassign a user and delete or take back the SIP account of any employee, all this is done without prior permission or any action from the employee.

Learn more about managing SIP accounts

Features of the Office scheme

Multiple outgoing SIP accounts
If the user has several linked SIP accounts, when making an outgoing call through the @siptg account, they will be prompted to select the one they need for the call.

DTMF keyboard
During calls in Softphone mode, you can use the DTMF keyboard, second line calling and call transfer are supported.
Learn more about how to receive and make calls

Same SIP accounts on different devices
Be careful when using the same SIP accounts from different devices at the same time (for example, in SIP.tg and an office phone). This may result in incoming calls arriving unpredictably on only one of the devices. In case of problems, if it is not possible to create a separate SIP account for SIP. TG, unplug your old device.

Note: this recommendation does not apply to virtual PBXs that support multiple registrations (check this feature with the PBX manufacturer).

Using your own infrastructure
If you have special requirements for data confidentiality, or your virtual PBX is not accessible from the external Internet, then it is possible to deploy your Worker server on a local network.
Learn more about your own Worker servers

Firewall Settings
Requests to the PBX come from the IP addresses of our Worker servers. The current list of IP addresses of our platform for inclusion in Firewall rules is available at: https://www.sip.tg/fw.txt

See also


Simultaneous use of different tariffs, disabling unused and identical accounts, Firewall settings

Receive and make calls from your phone number in Telegram via @siptg account (mobile, city or connected to a PBX)

The scheme allows you to receive and make calls from a large number of phone numbers (SIP accounts) from one Telegram-account

The scheme allows you to receive (forward) only incoming calls to your mobile phone for free in Telegram via @siptg account

Administrative functions of transferring and assigning users for SIP accounts of the Softphone mode of the SIP.TG gateway

How to use server templates when setting up SIP accounts for Softphone mode

Integration scenarios with products and infrastructure of telecom operators and large companies

Instructions for employees on how to receive and make calls through the @siptg bot

Purpose, advantages, procedure for installing and configuring your own Worker servers for SIP.TG

We explain the terminology and main options for purchasing and connecting DID numbers (SIP numbers) used in IP telephony for individuals and organizations.