SIP Client settings

The platform allows to use Telegram as a softphone. To use it's required an account of SIP provider and a Telegram account. For every SIP provider incoming and outgoing calls are available.

Add new provider

Choose SIP Client from the bot menu and push New.

Next, fill in fields: Login, Password and select Server from template. To apply settings immediately push Apply button. Otherwise settings will be applied during next 5 minutes.

New Operator

Fill in Login, Password and Server from template fields

If you haven't found the server from template, you can specify your own. For this push Server — it's an address of SIP server which will be used by sip.tg servers to connect to. Domain — it's a part of the address following after @sign in outgoing requests to the server. Usually it's not required, but some providers require it and this field can be differ from the Server field (for example, the provider МультиФон).

If your SIP server works on non-standard port, specify it following after a colon — domain.com:5555.

You can add up to 20 SIP accounts.

If the error occurs during the connection, the platform displays the code and description of the error.

Changing the settings

Login of the provider's account

Password of the provider's account

Choose the connection settings of the provider from predefined templates

Registration server of the provider

The value of domain in the From field for outgoing requests to the provider

Change the composition and priority of audio codecs which are used

Audio Codecs

Change the composition and priority of DTMF methods which are used

DTMF Methods

Rules for converting the phone number before transferring it to the provider

Number conversion

Display name of the provider

Deactivate the provider's account and delete the associated data

Transfer this provider's account to another user

Transfer account

Push the button below
to see the description

Push Apply button to apply settings immediately. Otherwise settings will be applied after 5 minutes.

Audio Codecs

DTMF Methods

Error codes

About number conversion

Delete the account

To delete the account, push Delete from the menu of the account settings. The bot will ask the confirmation with buttons Yes and No.

The providers state

Your accounts are saved in the SIP Client section. You can see only one of two states:

The provider is disabled. It means if the login or password is wrong or the connection settings are not filled in.

The provider is active.

How to call and to receive calls

Incoming calls

The calls are delivered from the service account @siptg. The Caller ID and Caller Name are taken from the SIP headers and delivers by the separate message. This message also contains DTMF keyboard which can be used during the call to navigate by the voice menu.

During the conversation new incoming calls will be rejected with «busy» signal for callers. You will see the missed call with details in the conversation with @siptg account.

Outgoing calls

To call the number, send to the service — @siptg_bot or @siptg — the phone number by one of the following ways:

Picture

Attach the contact with exactly one phone number

Picture

Type the phone number as a text of the message

If you set up multiple SIP accounts, you will see the confirmation to choose the one. After send the message you will get an incoming call, which will connect you with called number after you answer the call.

If the call is refused due to the flood error, you will get the option to make an outgoing call to account @siptg during the next 60 seconds.

If another error occur, the platform will give you the description.

Telegram allows to send multiple phone numbers of the contact which gives a problem: what exact number to use for the call. To avoid this problem it's required to attach exactly one phone number from the contact card.

Redial

After the call has finished, the DTMF keypad is removed and the message with the button Redial will be delivered. This message can contain the code of the finishing state the call.

Error codes

Share SIP settings

In dialog mode

You can prepare SIP settings and send it to your friend. Your friend has to push the button Take just.

In the chat with your friend start the message from our bot's name @siptg_bot and continue by parameters of SIP connection:

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

login — the login of the account;

pass — the password of the account;

template — the prefix of template's name for the account;

registrar — the registrar server of the account; specify if the template is not used;

OPTIONAL

domain — the value of from domain, allowed only if registrar is used;

codecs — the list of audio codecs in a sequence of their priorities, divided by comma;

dtmf — the list of DTMF methods in a sequence of their priorities, divided by comma;

rules — the list of number conversion rules for outgoing calls; the rules are divided by a space.

For example, to connect to Мультифон with login 79261234567 and password pass type:
@siptg_bot 79261234567 pass муль

Picture

The hint will help you to sure you entered the correct settings.

The feature has limitations and it is not intended for long-term storage of SIP settings. The button works only 5 minutes, can be pushed only one time, SIP settings add to SIP Client mode of the user who push the button.

If you need to save the settings for a long time, you can use the link with SIP settings.

This feature will be especially useful for telecom operators. You can create a Telegram link with settings and place it into the user's personal account. When clicking on this link, Telegram application will be opened with already added SIP account, without the need for additional actions by the user.

The link may contain user data in both forms: clear text and base64-encoded. In the first case, the separator of values is the sign =, but Login and Password may contain only symbols A-Z, a-z, 0-9, _ and -. In the case of a base64-encoded string, the values are separated by a space, after which the final string is encoded via a url-safe base64.

In clear text form the link should be:

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

{login} — login of the account;

{pass} — password of the account;

{code} — the code of SIP template, it can be asked in support.

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

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

If a base64-encoded form is used, you can also share settings without a SIP template, and the parameters are going in the same way as sharing of SIP settings in dialog mode.

It is also possible to use fake login/passwords, which will be converted to real on your Worker by your logic.

Settings in dialog mode

Confidentiality of SIP accounts

Transfer and return back the SIP account

You can transfer your SIP account temporary or forever. Moreover, you can transfer it back at any time without the permission of temporary owner.

Transfer SIP account

To transfer the account, push the button Transfer in their settings.

Transfer account

Push to transfer the account to your friend

Next, select the user from your chat to transfer the account to and confirm sending a special message. The recipient has to push the button Take, after that he will become the owner of the account.

New owner can return back the account by himself. For this ask him to push Transfer back and confirm sending a special message. After that you have to push Take.

The feature has limitations: the button Take works only 5 minutes, can be pushed only one time, SIP settings add to SIP Client mode of the user who push the button.

Take away SIP account

After transfer SIP account you will see the button Transfer back in the conversation. You can push it and, if you know the password of the account, specify it after the ID in draft message. If you see the hint with confirmation of sending a special message, you can send this message and push Take after that.

You will not see the confirmation hint if the owner has deleted the account or you specified wrong password.

Share SIP settings