> ## 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: "Да"
};

Используя **Софтфон**, вы превращаете Telegram в полноценный SIP-клиент. После того как вы добавили и настроили SIP-аккаунт через [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs), вы можете сразу начинать звонить через него, используя Telegram.

<Info>
  Для использования Софтфона необходимо подключить подписку с меткой ☎️ «Софтфон» — либо использовать **Бесплатную подписку**, которая включает ограниченное количество звонков. Подробнее см. [Подписки](/ru/docs/subscriptions/pricing).
</Info>

<a id="outgoing" />

## Совершение звонков

<Frame caption="Интерфейс чата с @siptg и кнопкой вызова">
  <img src="https://mintcdn.com/siptg/tkFN5QCwmPmK87TJ/images/softphone/chat.jpg?fit=max&auto=format&n=tkFN5QCwmPmK87TJ&q=85&s=96ba4f109e302881e6419993d5e8c35a" style={{ maxHeight:"760px" }} width="1080" height="2280" data-path="images/softphone/chat.jpg" />
</Frame>

После настройки SIP-аккаунта, достаточно отправить номер, на который вы хотите позвонить, в чат с аккаунтом [@siptg](https://t.me/siptg).

Номер может содержать не только цифры, но и буквы, если это поддерживается вашей АТС. К номеру применяются настраиваемые правила преобразования, которые позволяют очистить его от лишних символов, задать префиксы и прочее. Подробнее см. [Преобразование исходящих номеров](/ru/docs/softphone/settings#dialing-rules).

Если у вас активен режим **Callback**, то сразу после отправки номера вы получите входящий звонок от аккаунта **@siptg**. Ответив на него, начнётся соединение с набранным номером. Если Callback отключён — необходимо вручную нажать 📞 в чате с **@siptg**.

<Steps>
  <Step title="Отправка номера">
    Отправьте в чат с **@siptg** номер телефона или SIP-адрес, на который хотите позвонить.
  </Step>

  <Step title="Выбор линии (если их несколько)">
    Если у вас несколько подключённых SIP-аккаунтов, будет предложено выбрать линию для звонка.
  </Step>

  <Step title="Ожидание соединения">
    Если используется режим Callback, вы получите входящий звонок от **@siptg**. Ответьте на него — и произойдёт соединение.

    Если Callback отключён — после отправки номера нажмите 📞 в чате с **@siptg**, чтобы начать вызов.
  </Step>
</Steps>

<Tip>
  При первом звонке Telegram может запросить разрешение на приём звонков от аккаунта **@siptg**. Разрешите звонки всем или добавьте **@siptg** в исключения.
</Tip>

<a id="incoming" />

## Входящие звонки

<Frame caption="Уведомление Telegram о входящем звонке от @siptg">
  <img src="https://mintcdn.com/siptg/tkFN5QCwmPmK87TJ/images/softphone/call.jpg?fit=max&auto=format&n=tkFN5QCwmPmK87TJ&q=85&s=162b0890b2c48e98a62782490b8f2c9b" style={{ maxHeight:"760px" }} width="1080" height="2280" data-path="images/softphone/call.jpg" />
</Frame>

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

Имя и номер звонящего (если они передаются от вашей АТС) приходят в виде отдельного текстового сообщения в чат с @siptg **в момент входящего вызова**. Можно потянуть шторку уведомлений чтобы увидеть информацию перед поднятием трубки.

<Tip>
  Чтобы видеть дополнительную информацию о звонящем в момент входящего вызова, включите уведомления Telegram для чата с **@siptg**.
</Tip>

<a id="recording" />

## Запись звонков

Если вы оплатили запись разговоров в рамках подписки, то для каждого SIP-аккаунта можно отдельно включить автоматическую запись всех вызовов. Это настраивается при редактировании SIP-аккаунта в боте. Там же вы можете выбрать, куда отправлять записи: в личный чат, канал или группу. Подробнее на странице [Настройка Софтфона](/ru/docs/softphone/settings).

<Warning>
  Подписка с записью разговоров активирует возможность записи **для всех аккаунтов**, но включение автоматической записи выполняется **отдельно для каждого аккаунта**.
</Warning>

<a id="recording-manual" />

### Ручная запись во время звонка

<Frame caption="Кнопка записи под DTMF-клавиатурой во время звонка">
  <img src="https://mintcdn.com/siptg/VTwdAsKEZa8bGhO8/images/softphone/dtmf.jpg?fit=max&auto=format&n=VTwdAsKEZa8bGhO8&q=85&s=5d2f2fc2b5e72f899a89da94c6aa28b8" style={{ maxHeight:"760px" }} width="1080" height="2280" data-path="images/softphone/dtmf.jpg" />
</Frame>

Если подписка не включает запись, то можно вручную записать **фрагмент звонка длительностью до 15 секунд** — кнопка записи доступна во время разговора.

Если запись оплачена, но **автоматическая запись отключена**, вы можете вручную запускать и останавливать запись в любое время — **без ограничений по длительности**. Файлы с записями приходят в чат сразу после завершения записи.

<Note>
  Кнопка управления записью находится под DTMF-клавиатурой. Чтобы увидеть её, во время звонка смахните экран вверх или влево и откройте чат с **@siptg**.
</Note>

<Warning>
  Если вы — **пользователь SIP-аккаунта**, а владелец аккаунта включил автоматическую запись и указал отдельный чат для сохранения, то вы будете видеть, что разговор записывается, но **не сможете остановить запись**.
</Warning>

<a id="reconnecting" />

## Переподключение к звонку

Ниже под DTMF-клавиатурой есть ещё одна кнопка — **{bot.RECONNECT}**. Она позволяет, не прерывая звонок, переподключиться к нему с другого вашего устройства (например, разговаривая с ноутбука, вы можете продолжить разговор с телефона).

Она работает следующим образом:

1. При нажатии на кнопку ваш звонок завершается, а собеседник переводится на удержание.
2. Собеседник слышит повторяющиеся сигналы переподключения, а вам поступает входящий звонок (при включенном режиме Callback), либо предлагается сделать исходящий звонок в **@siptg**.
3. Если вы в течение 60 секунд поднимаете трубку или перезваниваете, разговор продолжается. В противном случае разговор завершается.

<a id="recovering" />

### Восстановление соединения

Если во время разговора у вас внезапно пропала связь (например, разрядился телефон), звонок также перейдёт в режим переподключения автоматически. Ваш собеседник будет слышать повторяющиеся сигналы переподключения, а вы сможете продолжить разговор с другого устройства в течение 60 секунд.

<Note>
  Если во время переподключения был активен [второй параллельный звонок](#second-call), то он будет сброшен. На удержание переводится только активный собеседник, с которым вы разговаривали в момент прерывания звонка.
</Note>

<a id="dtmf" />

## DTMF-клавиатура

Во время разговора для взаимодействия с голосовым меню (IVR) или ввода добавочного номера можно использовать DTMF-клавиатуру. Она отображается в чате с **@siptg** во время звонка и исчезает после его завершения.

Методы передачи DTMF (RFC2833, INFO, inband) выбираются в настройках SIP-аккаунта. Подробнее см. [Настройка Софтфона](/ru/docs/softphone/settings).

<a id="second-call" />

## Второй параллельный звонок

Во время активного разговора можно принять второй входящий звонок или сделать второй исходящий:

* Если во время разговора поступит ещё один **входящий**, вы услышите периодические гудки.
* Чтобы сделать второй **исходящий**, не завершая текущий, непосредственно в чате **@siptg** нужно отправить номер для второго звонка обычным сообщением.

В обоих случаях в чате **@siptg** появится новое сообщение с кнопками действий:

* **{bot.PARALLEL_TRANSFER}** — завершает ваш текущий разговор, а ваших собеседников соединяет друг с другом;
* **{bot.PARALLEL_SWITCH}** — текущий разговор ставится на удержание, а вы соединяетесь с новым звонком;
* **{bot.PARALLEL_DECLINE}** — отклоняет второй входящий звонок.

Когда у вас активно два разговора, вы можете продолжать переключаться между собеседниками несколько раз при помощи кнопки **{bot.PARALLEL_SWITCH}**, или нажать кнопку **{bot.PARALLEL_TRANSFER}** чтобы соединить собеседников друг с другом, а самому отключиться.

Также появится ещё одна кнопка **{bot.PARALLEL_END}** — она разрывает текущий разговор и возвращает вас ко второму собеседнику, который это время был на удержании звонка.

<a id="android-phonebook" />

## Телефонная книга для Android

<Frame caption="Процесс отображения имени звонящего скриптом Automate">
  <video controls src="https://mintcdn.com/siptg/tkFN5QCwmPmK87TJ/images/softphone/phonebook.mp4?fit=max&auto=format&n=tkFN5QCwmPmK87TJ&q=85&s=016897b0a9817d39ac1496d288464d91" style={{ maxHeight:"760px" }} data-path="images/softphone/phonebook.mp4" />
</Frame>

Для отображения имени звонящего из вашей локальной адресной книги Android мы разработали интеграцию на базе Automate:

<Steps>
  <Step title="Установка приложения Automate">
    Установите [приложение Automate](https://play.google.com/store/apps/details?id=com.llamalab.automate) на своё устройство Android.
  </Step>

  <Step title="Установка скрипта SIP.TG">
    Откройте ссылку на [наш скрипт](https://llamalab.com/automate/community/flows/45201) и установите его в приложение Automate.
  </Step>

  <Step title="Предоставление разрешений">
    Примите все запрошенные разрешения, включая доступ к звонкам и контактам.
  </Step>

  <Step title="Запуск">
    Нажмите кнопку START в приложении. После этого входящие звонки будут отображаться с именем из вашей телефонной книги.
  </Step>
</Steps>

<Tip>
  Делитесь опытом в публичной группе [@siptg\_public](https://t.me/siptg_public) и оставляйте отзывы в [каталоге Automate](https://llamalab.com/automate/community/flows/45201)!
</Tip>
