Настройка клиента

Сервис позволяет использовать Telegram как софтфон. Для подключения понадобится только аккаунт SIP-провайдера и аккаунт в Telegram. Для каждого провайдера возможны и входящие, и исходящие звонки.

Добавление нового оператора
New Operator

Заполните поля Логин и Пароль, и выберите Сервер из шаблона.

Выберите SIP-клиент в меню бота, а затем нажмите Новый.

Чтобы настроить клиента, заполните поля Логин,Пароль и выберитеСервер из шаблона. Сервис сохранит настройки и автоматически подключится к оператору.

Если вы не нашли подходящий сервер из шаблона, вы можете указать свой. Для этого выберите пункт Сервер — это адрес SIP-сервера, к которому будут подключаться сервера sip.tg. Domain — это часть адреса после @, которая передается на сервер при исходящих запросах. Обычно указывать её не требуется: она нужна для некоторых операторов и может отличаться от значения Сервер (например, у оператора МультиФон).

Если ваш SIP-сервер работает на нестандартном порту, укажите его через двоеточие — domain.com:5555.

Вы можете добавить до 20 SIP-аккаунтов.

Если при подключении возникла ошибка, то сервис отобразит код и название ошибки.

Изменение настроек

Логин аккаунта оператора

Пароль аккаунта оператора

Выбор параметров подключения к серверу оператора из шаблонов

Сервер регистрации оператора

Значение домена в поле From в исходящих к оператору запросах

Изменение состава и приоритета используемых аудио кодеков

Аудио кодеки

Изменение состава и приоритета используемых методов DTMF

DTMF методы

Правила преобразования номера телефона перед передачей его оператору

Преобразование номера

Отображаемое имя оператора

Отключение аккаунта оператора и удаление связанных с ним данных

Передать данный аккаунт оператора другому пользователю

Передать аккаунт

Выберите клавиши ниже,
чтобы увидеть описание

После внесения изменений, нажмите Применить. Если вы не нажали кнопку, настройки будут применены автоматически через 5 минут.

Аудио кодеки

DTMF методы

Коды ошибок

О правилах преобразования номеров

Удаление аккаунта

Чтобы удалить аккаунт, нажмите Удалить в меню с настройками аккаунта. Сервис запросит подтверждение в виде кнопок Да и Нет.

Состояние операторов

Добавленные аккаунты будут сохранены в меню SIP-клиент. Вы можете видеть два статуса у операторов:

Оператор отключен. Появляется, если введен неверный логин или пароль или не заполнены параметры подключения.

Оператор подключен.

Как звонить

Входящие

Звонки проходят через отдельный аккаунт @siptg. При входящем номер и имя звонящего абонента берутся из SIP-заголовков и приходят в виде отдельного сообщения. Вместе с сообщением также приходит DTMF-клавиатура.

Когда вы разговариваете, новый звонящий абонент услышит сигнал «Занято», а у Вас в списке сообщений появится пропущенный звонок с номером абонента.

Исходящие

Чтобы позвонить на произвольный номер, отправьте сервису — @siptg_bot или @siptg — номер телефона одним из способов:

Picture

Прикрепите карточку контакта с номером

Picture

Напишите телефон текстом

Если вы настроили несколько аккаунтов, то сервис предложит выбрать оператора перед началом звонка. После отправки сообщения вам поступит входящий звонок, который соединит вас с набранным номером.

Если попытка соединения завершается ошибкой, связанной с флудом, пользователю предлагается сделать исходящий звонок на аккаунт @siptg. Исходящий звонок необходимо сделать в течение 60 секунд.

Если произойдет ошибка, сервис напишет причину сбоя в сообщении под набранным номером.

Telegram позволяет отправлять несколько телефонов из одного контакта, что создает проблему: какой номер телефона использовать для звонка. Чтобы избежать неоднозначность, установлено требование присылать строго один номер телефона из карточки контакта.

Перезвонить

При исходящем звонке после разговора DTMF-клавиатура удаляется, и сервис присылает кнопку Перезвонить. Также в сообщении может содержаться код статуса завершения звонка.

Коды ошибок

Поделиться SIP-настройками

В режиме диалога

Вы можете подготовить SIP-настройки и отправить их другу. Другу будет нужно только нажать кнопку Принять.

В режиме чата с пользователем начните сообщение с имени нашего бота @siptg_bot, а потом укажите параметры SIP-подключения:

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

login — логин учетной записи;

pass — пароль учетной записи;

template — префикс имени шаблона настроек оператора;

registrar — сервер регистрации учетной записи; указывается, если не используется шаблон;

ОПЦИОНАЛЬНО

domain — значение параметра from domain, указывается только в паре с полем registrar;

codecs — список аудио кодеков в порядке их приоритета, разделенные запятой;

dtmf — список способов отправки DTMF-кодов в порядке их приоритета, разделённые запятой;

rules — список правил преобразования номера перед набором; правила друг от друга разделяются пробелом.

Например, для подключения к Мультифону с логином user и паролем pass достаточно ввести: @siptg_bot user pass муль

Picture

Всплывающая подсказка поможет убедиться, что вы ввели настройки правильно.

У функции есть ограничения и она не предназначена для долговременного хранения SIP-настроек. Кнопка работает 5 минут, нажать кнопку можно один раз, SIP-настройки добавляются в режим SIP-клиента того пользователя, который нажимает на кнопку.

Если Вам нужно сохранить настройки на длительный срок, можно воспользоваться ссылкой с SIP-настройками.

Данная возможность окажется особенно полезной операторам связи. Можно сформировать Telegram-ссылку с настройками, которую разместить в Личном кабенете пользователя. При переходе по данной ссылке у пользователя откроется приложение Telegram с уже добавленным SIP-аккаунтом, без необходимости дополнительных действий со стороны пользователя.

Ссылка может содержать данные пользователя как в открытом, так и в base64-кодированном виде. В первом случае разделителем значений служит знак =, а Логин и Пароль может содержать только символы A-Z, a-z, 0-9, _ и -. В случае base64-кодированной строки значения разделяются пробелом, после чего сформированная строка параметров кодируется через url-безопасный base64.

Формат URL в открытом виде должен иметь вид:

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

{login} — логин учетной записи;

{pass} — пароль учетной записи;

{code} — код SIP-шаблона, его можно уточнить в поддержке.

В base64-кодированном виде ссылка будет похожа на следующую:

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

В случае, если используется base64-кодированная строка, также можно передавать настройки без SIP-шаблона, при этом параметры формируются аналогично способу передачи SIP-настроек в режиме даилога.

Также имеется возможность формировать фейковые логины/пароли, которые будут преобразовываться в реальные на Вашем Worker'е по Вашей логике.

Настройки в режиме диалога

Конфиденциальность SIP-настроек

Передать и вернуть SIP-аккаунт

Вы можете передать другу ваш SIP-аккаунт временно или навсегда. В любой момент его можно вернуть без разрешения временного владельца.

Picture

Нажмите для передачи аккаунта другу

Передача аккаунта

Чтобы отправить аккаунт, нажмите в его настройках кнопку Передать аккаунт. Выберите пользователя и подтвердите отправку специального сообщения. Получателю нужно нажать кнопку Получить, после чего он станет владельцем.

Новый владелец может самостоятельно вернуть аккаунт. Для этого попросите его нажать кнопку Передать обратно и подтвердить отправку специального сообщения.

У функции есть ограничения: срок действия кнопки подтверждения — не более 5 минут, нажать кнопку можно только один раз, SIP-настройки добавляются в режим SIP-клиента того пользователя, который нажимает на кнопку Получить.

Забрать SIP-аккаунт

После передачи SIP-аккаунта в истории сообщений появится кнопка Передать обратно. Если Вы знаете пароль от этого аккаунта, достаточно указать его через пробел после числового ID, который появится в черновике при нажатии на кнопку Передать обратно. После этого вы увидите предложение забрать аккаунт обратно.

Передача не произойдет, если текущий владелец удалил аккаунт или Вы ввели неверный пароль.

Поделиться SIP-настройками