The "Office" scheme of work

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

Very convenient as an addition to the office telephony for companies of any size.
The SIP.TG Telegram Softphone is a complete business tool that can be used in teams of any size.

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

Appreciate the reliability and convenience of Telegram, battery saving, working even on unstable Internet connections anywhere in the world. Telegram voice algorithms are specially adapted for weak connection channels and mobile devices, unlike the classical SIP-telephony.

All tuning, testing, administration and payment for SIP-accounts of employees can be done from one Telegram administrator account. Employees get their SIP accounts configured and ready to work in one step.

Second line call, call transfer and call hold are supported. Telegram Softphone is compatible with many CRM systems, where a third-party softphone can be used.

See also:
Telegram Softphone Rates

Setting up Telegram softphones for the team

For the purposes of this scheme work, let's define that the Administrator is a person whose task is to configure the system PBX and Telegram accounts of employees to work as softphones.
scheme works with all popular PBX, both virtual (UIS, OnlinePBX, Sipuni, etc.) and office (Asterisk, Panasonic, Oktell, FreeSWITCH, SipXecs, Yate, FreePBX and others).
Note: A memo for employees on how to obtain and activate settings from the Administrator and then make calls via Telegram in Softphone mode is available at https://sip.tg/howtocall
The main tasks of an administrator when connecting employees under the Office scheme:
  • Create for each employee a separate SIP-account at PBX, enter their details in the text list in the format login / password
  • send special messages to employees on Telegram with SIP accounts set up to make calls

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

Method 1: By pressing the "Transfer" button from the SIP account card

The most obvious way, but not the most convenient for setting up a large number of accounts.
Setting up a SIP account to use Telegram as a Softphone
SIP account settings for using Telegram as a Softphone
1
Contact @siptg_bot from the admin account
2
Select the item /softphone and press the "New" button (to connect a new SIP account)
3
Specify the connection and settings for the SIP account to be added
Usually it is enough to specify login, password, server (optionally also domain and port) and/or select Server Template of your service provider or type of used PBX.

More information about using Server Templates
4
It is recommended to specify the name for the created SIP account (Name button), this will make it easier to distinguish the accounts in the list
5
An employee can be assigned to a configured SIP account using the "Transfer" button
After clicking on the "Transfer" button, the recipient of the account is selected from the list of contacts.

Method 2: By text message mentioning @siptg_bot and SIP account parameters

Transferring a configured SIP account to use Telegram as a Softphone
Getting a configured SIP account to use Telegram as a Softphone
The most convenient way of setting up for a large number of employees.

It is enough to compose and send in Telegram for each employee a text message mentioning @siptg_bot and SIP-account details in a simple format.

SIP-account of the employee with relevant settings in this case will be automatically created when the settings are activated by the employee and will be bound to the administrator's rate. Learn more about managing SIP accountsat

IMPORTANT: For security reasons, the button for receiving settings on the employee's side works for 5 minutes; the button may be pressed once. We recommend making sure in correspondence before sending the settings that the employee is ready to accept them.
Composing a message with settings
Message format for sending SIP account settings to an employee:

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

Key fields:
  • login - account login
  • pass - password for the account

One of the fields:
OR
  • registrar - account registration server (to be specified if no template is used)

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

For example, to connect to Multiphone (for which there is a corresponding template called Multiphone) with the username somelogin1 and the password somepass1, it is sufficient to enter:

@siptg_bot somelogin1 somepass1 mule

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

If there is no server template for your case, a message with the full set of parameters can 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: Go to @siptg_bot and SIP account settings

The essence of the method is that you can generate a Telegram link with SIP settings and place it in a user's Private Office.

This option is convenient for large companies, where each employee has Consumer office in the corporate system or for telecom operators, for example.

A SIP account of an employee with relevant settings in this case will be automatically connected to the employee's Telegram account when the settings are activated, but such SIP account is NOT bound to the administrator's tariff. Only the employee will be the owner of the SIP account.

Payments for users connected in this way must be made in accordance with the individual cooperation scheme for telecom operators.
Drawing up a link with settings
A link can contain user data in either plaintext or base64-encoded form.

In the former case, the = sign is used to separate the values, and the login and password can only contain the characters A-Z, a-z, 0-9, _ and -.

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

URL format in plaintext should have following form:

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

login - account login;
pass - account password;
code - code of SIP-template (more about server patterns).

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

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

If base64-encoded string is used, you can also transfer settings without SIP-template, with the parameters being formed similarly to the way SIP settings are transferred in dialog mode.

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

Read more about using Worker-servers

Managing SIP employee accounts

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

Read more about managing SIP accounts

Features scheme Office

Multiple outgoing SIP-accounts
If a user has several linked SIP-accounts, when making an outgoing call through @siptg account he will be offered to choose the one he wants to call.

DTMF-keypad
DTMF-keypad can be used during softphone calls, second line call 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 office phone). This can lead to unpredictable incoming calls to only one of the devices. In case of problems, if there is no possibility to create a separate SIP-account for SIP. TG, disconnect the old device.

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

Using your own infrastructure
If you have special data privacy requirements, or your virtual PBX has no access from the external Internet, you can deploy your Worker-server in your local network.
Learn more about your own Worker-servers

Firewall settings
Requests to PBX come from the IP addresses of our Worker-servers. An up-to-date list of our platform IP addresses 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 Telegram phone number through your @siptg account (mobile, landline, or linked to PBX)

scheme allows you to receive and make calls from a large number of telephone numbers (SIP accounts) from a single Telegram account

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

Administrative transfer and user assignment functions for SIP mode Softphone SIP.TG gateway accounts

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, benefits, installation and configuration of own Worker servers for SIP.TG

We explain the terminology and basic opportunities for the acquisition and connection of DID numbers (SIP-numbers) used in IP-telephony for individuals and organizations.