> ## 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. # Настройка Софтфона export const bot = { ACTIVATE_TARIFF_PLAN: "Активировать подписку", ADDRESS: "Адрес", ADDRESS_PORT: "Адрес:порт", ADMIN_ASSIGN: "Назначить администратора", APPLY: "Применить", ARBITRARY_CHECK: "Обработка сообщений", AUTORENEW: "Автопродление", AUTOREPLY: "Автоответ", BACK: "Назад", BACK_TO_PAYMENT: "Вернуться к оплате", BALANCE_TRANSFER: "Перевести", BILLING: "Реквизиты", BTN_CHARGE_REDIRECT: "Подтвердить списание", BTN_EMPTY_BOT: "Inline бот", BTN_TARIFF_NEW: "Подключить", CALLBACK_CHECK: "Callback", CALLBACK_SWITCH_OFF: "Отключить режим Callback", CALLBACK_SWITCH_ON: "Включить режим Callback", CALLER_NAME: "Имя звонящего", CALLER_PHONE: "Номер звонящего", CANCEL: "Отмена", COMMENT: "Комментарий", CONFIGURE_ACCOUNT_ALLOW_EVERYBODY: "Разрешить звонки ото всех пользователей", CONFIGURE_ACCOUNT_ALLOW_P2P: "Разрешить P2P звонки ото всех", CONFIGURE_ACCOUNT_DISALLOW_GROUPS: "Запретить добавление в группы", CONFIGURE_ACCOUNT_OFF_OTHER_SESSIONS_CALLS: "Отключить звонки на других устройствах", COUNTRY: "Страна", DELETE: "Удалить", DESCRIPTION: "Описание", DIAL_RULES: "Правила набора", DOC_BTN_PROVIDE: "Предоставить документацию", DOMAIN: "Домен", DTMF_METHODS: "DTMF методы", FIELD_VALUE: "Поле:Значение", FORMATS: "Аудио кодеки", FW_ADD: "Добавить номер телефона", FW_ADD_OTHER: "Другой номер", FW_ADD_SELF: "Номер Telegram", FW_ANTISPAM: "Анти-спам", FW_BACK: "Назад", FW_BONUS_PROGRAM: "Реферальная программа", FW_CANCEL: "Отмена", FW_DELETE: "Удалить", FW_NAME: "Имя", FW_NO: "Нет", FW_PHONE_FORWARDING: "Напомнить номер", FW_RECORDER_CHAT: "Чат для записей", FW_RECORDER_CHECKBOX: "Запись звонков", FW_SELECT_COUNTRY: "Выбрать страну (регион)", FW_SHARE_PHONE: "Отправить номер телефона", FW_TELL_FRIENDS: "Рассказать друзьям", FW_YES: "Да", GATEWAY_IN_RESET: "Сбросить пароль", GATEWAY_IN_SHOW: "Показать аккаунт", GATEWAY_OUT_NUMBER: "Номер на АТС", GENERATE_NEW: "Сгенерировать новый", GIVE_ACCESS: "Предоставить доступ", GIVE_PHONE_NUMBER: "Предоставить номер телефона", HELP: "Помощь", INLINE_QUERY: "Inline запрос", INVOICE_BANK_IGNORE_CURRENT_RATE: "Игнорировать курс валюты", KEYPAD_IN: "DTMF вх.", KEYPAD_OUT: "DTMF исх.", KEYS_GET: "Получить ключи", KEYS_RESET: "Сбросить ключи", LEARN_ABOUT: "Узнать о SIP.TG", LINES: "Линии", LINES_CHECK: "Линии", LOGIN: "Логин", MANUAL: "Вручную", MODE_GATEWAY: "Режим Шлюз", MODE_SOFTPHONE: "Режим Софтфон", NAME: "Имя", NEW: "Новый", NEW_IN: "🆕 PBX→SIP․TG", NEW_IP: "🆕 IP⇿IP", NEW_OUT: "🆕 SIP․TG→PBX", NO: "Нет", PARALLEL_DECLINE: "Отклонить", PARALLEL_END: "Завершить", PARALLEL_SWITCH: "Переключить", PARALLEL_TRANSFER: "Перевести", PASSWORD: "Пароль", PAYER: "Плательщик", PAYSYSTEM_BTN_VERIFY: "Указать страну проживания", PAYSYSTEM_DOCS_PROVIDE: "Предоставить документы", PAYSYSTEM_METHOD: "Способ оплаты", PAY_TARIFF: "Оплатить", PROLONG: "Продлить", PROMO_BUTTON_EMPTY: "Код скидки", RECONNECT: "🔄 Переподключить", RECORDER_ACTIVATE: "🔴 Начать запись", RECORDER_ACTIVATE_FAILED: "⚠️ Начать запись", RECORDER_CHAT: "Чат для записей", RECORDER_CHECKBOX: "Запись звонков", RECORDER_DEACTIVATE: "🟥 Остановить запись", RECORDER_DEACTIVATE_RECONNECTING: "⌛ Остановить запись", RECORDER_LOCKED: "🔒 Запись ограничена", REDIAL: "Перезвонить", REDIAL_CHECK: "Перезвонить", REGISTRAR: "Прокси", REPEAT: "Повторить", SELECT_BOT: "Выбрать бота", SELECT_CHANNEL: "Выбрать канал", SELECT_CHAT: "Выбрать чат", SELECT_USER: "Выбрать пользователя", SERVER_FROM_TEMPLATE: "Шаблоны настроек", SESSION_BILLER_CHECK: "Использовать общую подписку", SESSION_CONFIGURE_ACCOUNT: "Настроить аккаунт Telegram", SESSION_LOGIN: "Подключить", SESSION_LOGOUT: "Отключить", SETTINGS: "Настройки", START_CALLING: "Перейти к звонкам", SUPPORT: "Поддержка", SWITCH_OFF: "Отключить", SWITCH_ON: "Включить", TAKE: "Получить", TARIFF_ACTIVATE_CHANGE_USER: "Изменить заказчика", TARIFF_ACTIVATE_USER: "Активировать заказчику", TARIFF_ACTIVATE_YOURSELF: "Активировать себе", TAX_ADDRESS: "Адрес", TAX_BUSINESS: "Бизнес", TAX_NAME: "Покупатель", TAX_NUMBER: "Налоговый номер", TERMINATE_SESSION: "Завершить сессию", TERMS_AGREE: "Соглашаюсь с Правилами и Условиями", TG_STORAGE_OFFICIAL: "✅ Хранилище сессий SIP․TG", TRANSFER: "Передать", TRANSFER_BACK: "Передать обратно", TRUSTED_IPS: "Доверенные IP", UNLINK: "Отвязать", USER: "Пользователь", VERIFY_ROUTE_BAD: "👎 Нет, это спам", VERIFY_ROUTE_GOOD: "👍 Да, всё хорошо", VERIFY_ROUTE_RECOVER: "Восстановить входящие звонки", WORKER_AUTO: "Автоматически", YES: "Да" }; ## Роли владельца и пользователя SIP-аккаунта **Владелец SIP-аккаунта** — пользователь Telegram, создающий SIP-аккаунт в боте [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs). Владелец имеет полный контроль над созданием, удалением и изменением настроек SIP-аккаунтов, а также может назначать аккаунты другим пользователям. **Пользователь SIP-аккаунта** — человек, которому владелец назначил SIP-аккаунт. Он может использовать аккаунт для совершения и приёма звонков, но не может изменять настройки самого аккаунта. Подписка для софтфона должна подключаться на Telegram-аккаунт **Владельца**. Подписка пользователя SIP-аккаунта не имеет действия на SIP-аккаунты, которые принадлежат другим владельцам! ## Принцип взаимодействия с кнопками настроек Большинство настроек отображаются прямо на кнопках в виде текущих значений. Чтобы изменить эти настройки, достаточно нажать соответствующую кнопку и ввести новое значение по запросу бота. Однако некоторые кнопки работают по-другому: * **Worker**: при нажатии появляется список доступных Worker-серверов. Выберите нужный сервер из списка, чтобы его назначить. * **Кнопки с флажками**: такие как «Запись разговоров», работают как переключатели. Одно нажатие активирует или деактивирует опцию. * **{bot.RECORDER_CHAT}**: при первом нажатии появится дополнительная кнопка для выбора чата. Нажав на эту кнопку, вы увидите список чатов и каналов, доступных для выбора. Выберите подходящий чат, чтобы записи разговоров сохранялись именно там. * **{bot.USER}**: при первом нажатии появится дополнительная кнопка для выбора пользователя. Нажав на эту кнопку, вы сможете выбрать другого пользователя Telegram, которому будет назначен этот SIP-аккаунт. * **Протокол соединения (UDP/TCP/TLS)**: при каждом нажатии происходит переключение на следующий доступный протокол. ## Пошаговая настройка * Запустите бота [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs). * Перейдите в раздел `/softphone`. * Нажмите кнопку **{bot.NEW}** для создания нового SIP-аккаунта. * Введите логин и пароль, полученные от вашего оператора IP-телефонии или SIP-АТС. Не используйте свой логин и пароль одновременно в нескольких программах (виджетах, других софтфонах, телефонных аппаратах). Это может привести к потере входящих звонков и связано с особенностью SIP-протокола. Для каждой программы (устройства) нужно создать отдельный SIP-аккаунт в вашей АТС. * Укажите домен (адрес SIP-сервера). * При необходимости укажите отдельный Registrar Proxy (сервер регистрации). * Заготовленные настройки оператора IP-телефонии также можно выбрать из каталога, доступ к которому возможен по кнопке **{bot.SERVER_FROM_TEMPLATE}**. * Выберите транспортный протокол: UDP, TCP или TLS. * Выберите и настройте аудиокодеки, поддерживаемые вашим провайдером. * Настройте метод передачи DTMF-сигналов (RFC2833, INFO, inband). * Задайте правила преобразования номеров для исходящих звонков. * Проверьте в кабинете SIP-провайдера/АТС, что аккаунт зарегистрирован. * Попробуйте исходящий звонок (отправьте номер в чат [@siptg](https://t.me/siptg)). * Если всё в порядке, попробуйте входящий (на номер SIP-аккаунта). * При ошибках авторизации или проблемах см. [Вопросы и решение проблем](/ru/docs/softphone/problems). * При необходимости, чтобы звонки шли не вам, а другому сотруднику, назначьте пользователя Telegram на этот SIP-аккаунт (кнопка **{bot.USER}**). * Теперь все вызовы будут поступать сотруднику, а вы будете получать уведомления, если возникнет какая-то проблема с SIP аккаунтом. * **{bot.RECORDER_CHECKBOX}**: включите опцию и выберите чат для хранения записей. * **{bot.DIAL_RULES}**: для изменения формата набираемого номера (например, +7 → 8). Некоторые настройки вступают в силу после нажатия кнопки **{bot.APPLY}**, либо по истечение 5 минут. После выполнения шагов аккаунт станет активным и готовым к работе. ## Доступные настройки Выбор кодеков влияет на качество и совместимость голосовой связи. Поддерживаются кодеки Opus, alaw, mulaw, GSM и другие. DTMF необходим для взаимодействия с голосовым меню. Доступны методы RFC2833 (рекомендуется), INFO и inband. Можно активировать или деактивировать автоматическую запись звонков, а также выбрать отдельный чат или канал для сохранения аудиозаписей. Позволяет назначать SIP-аккаунты другим пользователям Telegram, предоставляя им возможность использовать аккаунты для звонков без доступа к настройкам. Позволяет выбрать сервер, который будет соединяться с АТС или провайдером телефонии. Предусмотрено 4 типа серверов: | Тип сервера | Описание | Обозначение | | --------------------------------------- | ------------------------------------------------------------------------------ | ----------- | | Публичные сервера SIP.TG | Основные сервера, поддерживаемые SIP.TG | ✅ | | Публичные сервера других пользователей | Общедоступные сервера, размещённые другими пользователями | 🌐 | | Публичные сервера провайдеров телефонии | Доступны с некоторыми Шаблонами настроек, предоставлены сторонними операторами | 📡 | | Приватные сервера | Ваши собственные сервера, доступные только для ваших SIP-аккаунтов | 🔑 | На бесплатной подписке доступны только некоторые из публичных серверов SIP.TG. Позволяют преобразовать номер для исходящего вызова перед его отправкой SIP-провайдеру или в АТС, а также убрать из запроса о выборе линии для звонка неподходящие SIP-аккаунты (например, если звонки в разные страны вы предпочитаете делать через разные SIP-аккаунты). Подробное описание см. в разделе [Преобразование исходящих номеров](#dialing-rules). ## Преобразование исходящих номеров Иногда при исходящих вызовах нужно автоматически изменить набираемый номер, чтобы соответствовать требованиям SIP-провайдера или АТС (например, заменить первую «8» на «+7» или удалить пробелы и скобки). В SIP.TG это настраивается с помощью **Правил преобразования** в настройках SIP-аккаунта. Если ваш оператор принимает номера в любом формате или вы используете готовый **Шаблон настроек**, скорее всего правила набора не нужны. Прежде чем вносить изменения, уточните требования к формату номеров у своего SIP-провайдера или внутри АТС. Существует 2 типа правил: * **Правила с «=»** — замена части номера.\ Если левая часть правила (регулярное выражение) найдена, то она заменяется на правую часть. * **Правила без «=»** — фильтр (маска).\ Если номер не соответствует регулярному выражению, правило прерывает обработку, и вызов не совершается. Все правила разделяются пробелами и применяются в порядке следования. Как только номер перестаёт соответствовать хотя бы одному правилу-фильтру (без «=»), использование SIP-аккаунта для вызова номера не допускается. Каждое правило замены (со знаком «=») изменяет номер перед его проверкой следующими правилами-фильтрами. ### Редактирование правил в боте 1. Перейдите в боте [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) в раздел `/softphone`. 2. Выберите нужный SIP-аккаунт, нажмите кнопку **{bot.DIAL_RULES}**. 3. Введите одно или несколько правил, разделяя их пробелами. 4. Подтвердите изменения. 5. Проверьте тестовым звонком, что номера преобразуются корректно. Все правила работают по принципу «слева направо». Обратите внимание, что добавление слишком многих фильтров или неоднозначных замен может привести к неожиданным результатам. При сложных сценариях тестируйте на паре реальных номеров. ### Примеры Рассмотрим задачу: мы набираем номера вида «8 (926) 123-45-67», но оператор требует «7XXXXXXXXXX». Предположим, нам нужно удалить все нецифровые символы и превратить начальную 8 в 7. Вот два правила (записаны через пробел): ```text theme={null} [^+*#\w]= ^8=7 ``` **Первое** убирает все символы кроме цифр, букв, плюса и некоторых спецсимволов (\*, #, \_).\ **Второе** заменяет первую цифру 8 на 7. Теперь если пользователь введёт `8 (926) 123-45-67`, после первого правила строка станет `89261234567`, а после второго — `79261234567`. Если нужно разрешить исходящие звонки только на российские мобильные номера (начинаются на 79 и далее 9 цифр), используем правило-фильтр: ```text theme={null} ^79\d{9}$ ``` Без знака «=». Если номер не соответствует `^79\d{9}$`, SIP-аккаунт использоваться не будет. Иногда нужно отбросить всё, если пользователь случайно ввёл невалидный номер. Можно использовать правило-замену на пустоту: ```text theme={null} .*= ``` Это приведёт к тому, что любой номер заменится на пустую строку. Если пустая строка не подходит оператору, вызов не состоится. Если возникли проблемы или ошибки, см. [Вопросы и решение проблем](/ru/docs/softphone/problems).