How to Use

Documentation Index

Fetch the complete documentation index at: https://www.sip.tg/llms.txt

Use this file to discover all available pages before exploring further.

By using Softphone, you transform Telegram into a full-fledged SIP client. After you’ve added and configured a SIP account via @siptg_bot, you can immediately start making calls through it using Telegram.

​

Making Calls

After setting up a SIP account, simply send the number you want to call to the @siptg account chat. The number can contain not only digits but also letters, if supported by your PBX. The number is subject to customizable transformation rules that allow you to clean it of unnecessary characters, set prefixes, and more. For details, see Outgoing Number Transformation. If you have the Callback mode active, immediately after sending the number, you will receive an incoming call from the @siptg account. After answering it, a connection with the dialed number will begin. If Callback is disabled — you need to manually press 📞 in the chat with @siptg.

​

Incoming Calls

Incoming calls appear as regular Telegram calls from the @siptg account. You can accept the call from the notification menu or directly from Telegram. The name and number of the caller (if transmitted by your PBX) come as a separate text message in the chat with @siptg at the moment of the incoming call. You can pull down the notification shade to see the information before answering.

​

Call Recording

If you have paid for call recording as part of your subscription, you can enable automatic recording of all calls for each SIP account separately. This is configured when editing the SIP account in the bot. There, you can also choose where to send the recordings: to a personal chat, channel, or group. For more details, see the Softphone Settings page.

​

Manual Recording During a Call

If your subscription does not include recording, you can manually record a call fragment up to 15 seconds long — the recording button is available during the conversation. If recording is paid for, but automatic recording is disabled, you can manually start and stop recording at any time — without duration limitations. The recorded files are sent to the chat immediately after the recording is completed.

​

Reconnecting to call

Below the DTMF keypad, there is another button — . It lets you reconnect to the same call from your another device without interrupting the conversation (for example, you can move a call from your laptop to your phone). It works as follows:

1. When you press the button, your call is ended, and your interlocutor is put on hold.
2. The interlocutor hears repeating reconnection tones, and you receive an incoming call (if Callback mode is enabled) or are prompted to make an outgoing call to @siptg.
3. If you answer or call back within 60 seconds, the conversation is resumed. Otherwise, the call is terminated.

​

Connection recovering

If your connection is suddenly lost during a call (for example, your phone battery dies), the call will automatically switch to reconnection mode. Your interlocutor will hear repeating reconnection tones, and you will be able to continue the conversation from another device within 60 seconds.

​

DTMF Keypad

During a conversation, you can use the DTMF keypad to interact with voice menus (IVR) or enter extension numbers. It appears in the chat with @siptg during a call and disappears after it ends. DTMF transmission methods (RFC2833, INFO, inband) are selected in the SIP account settings. For more details, see Softphone Settings.

​

Second Parallel Call

During an active conversation, you can accept a second incoming call or make a second outgoing call:

• If another incoming call arrives during a conversation, you will hear periodic beeps.
• To make a second outgoing call without ending the current one, simply send the number for the second call as a regular message in the @siptg chat.

In both cases, a new message with action buttons will appear in the @siptg chat:

• — ends your current conversation and connects your interlocutors with each other;
• — puts the current conversation on hold, and connect you to the new call;
• — rejects the second incoming call.

When you have two active conversations, you can continue to switch between interlocutors several times using the button, or press the button to connect the interlocutors with each other and disconnect yourself. Another button will also appear, — it terminates the current conversation and returns you to the second interlocutor, who was on hold during this time.

​

Android Phone Book

To display the caller’s name from your local Android address book, we have developed an integration based on Automate: