> ## 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. # Взаимодействие с Telegram 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-аккаунт, через который будут проходить звонки. В этом процессе участвуют **две роли**: сессия и администратор. ## Роли аккаунтов сессии и администратора * **Аккаунт сессии** — Telegram-аккаунт, который будет использоваться в качестве источника и получателя звонков. Подключается как **виртуальное устройство** к SIP.TG. * **Аккаунт администратора** — Telegram-аккаунт, который взаимодействует с [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) и управляет сессией: подключает сессию, может изменять настройки, подключать SIP-АТС и получать уведомления об ошибках. Один и тот же Telegram-аккаунт может использоваться в обеих ролях. Однако в корпоративной среде рекомендуется разделять их. ## Пошаговое подключение сессии Выберите Telegram-аккаунт, который будет использоваться как шлюз. Убедитесь, что он не используется для личных звонков или переписок. Перейдите в [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) и выполните команду `/gateway`. Нажмите кнопку **{bot.SESSION_LOGIN}**. Укажите, где будет храниться сессия: * **{bot.TG_STORAGE_OFFICIAL}** — просто, быстро и безопасно. * **Собственное хранилище** — для компаний с повышенными требованиями к приватности. Подробнее см. [Хранилище сессий Telegram](/ru/docs/additional/modules#storage). Укажите номер телефона выбранного Telegram-аккаунта. На него поступит код от официального аккаунта Telegram, который нужно ввести в бота для авторизации. Если на аккаунте включена двухфакторная аутентификация (2FA), будет запущен безопасный процесс восстановления: Telegram отправит письмо на связанный email для сброса пароля. Это делается, чтобы не передавать ваш пароль в открытом виде. ## Применение Telegram-настроек к аккаунту Сразу после подключения сессии бот предложит применить рекомендуемые настройки. Они повышают надёжность и удобство приёма звонков: * **{bot.CONFIGURE_ACCOUNT_OFF_OTHER_SESSIONS_CALLS}** — исключает конфликты, когда вызов поступает одновременно в несколько мест. Позволяет использовать Telegram сессии как канал только для звонков, а остальные устройства — для переписки. * **{bot.CONFIGURE_ACCOUNT_ALLOW_EVERYBODY}** — важно, так как по умолчанию звонки от неизвестных номеров блокируются настройками Telegram и не будут доходить до АТС. * **{bot.CONFIGURE_ACCOUNT_ALLOW_P2P}** — если поддерживается, позволяет Telegram передавать аудио напрямую, без пересылки через серверы, улучшая качество связи и снижая задержки. * **{bot.CONFIGURE_ACCOUNT_DISALLOW_GROUPS}** — снижает риск получения лишних уведомлений, не связанных с задачами звонков. Некоторые параметры Telegram можно изменить только спустя **24 часа** после подключения аккаунта. Если получите ошибку — попробуйте позже. ## Настройки сессии SIP.TG Эти параметры включают или отключают использование DTMF-клавиатуры в разных направлениях звонков: * **{bot.KEYPAD_IN}** — используется при входящем Telegram-звонке (направление Telegram → SIP); * **{bot.KEYPAD_OUT}** — используется при исходящем звонке на Telegram из вашей АТС (направление SIP → Telegram). DTMF-клавиатура позволяет: * взаимодействовать с голосовым меню АТС (IVR); * вводить внутренние номера; * отображать информацию о звонящем сотруднике при звонке Telegram-пользователю. Клавиатура активируется свайпом вверх во время разговора. Поддерживаются режимы передачи (RFC2833, inband, SIP INFO) меняются в настройках SIP подключения и должны быть согласованы с настройками АТС. Включает или отключает кнопки **{bot.REDIAL}** и **{bot.LINES}** для Telegram-пользователей, которые взаимодействуют с аккаунтом шлюза. Кнопки появляется в чате после завершения звонка. Нажатие на кнопку **{bot.REDIAL}** инициирует звонок на внутренний номер в АТС, который использовался во время предыдущего разговора, позволяя связать пользователя с конкретным сотрудником или отделом. Номер отправляется в АТС без применения правил преобразования номера. Кнопка **{bot.LINES}** работает примерно также с той лишь разницей, что перед инициированием звонка отображает подключенные линии, через которые можно сделать звонок. Номер отправляется в АТС после применения правил преобразования номера выбранного SIP-аккаунта. Включает или отключает возможность реагировать на текстовые сообщения, приходящие в Telegram-аккаунт сессии. При включении открываются дополнительные функции: * **{bot.CALLBACK_CHECK}** — после отправки любого сообщения в чат, пользователь получит входящий звонок от шлюза с последующим соединением с отправленным в сообщении номером (либо номером по умолчанию; поведение настраивается в настройках SIP линии). * **{bot.BTN_EMPTY_BOT}** — если для сообщения не найден подходящий SIP-аккаунт для звонка, его можно обработать через внешнего inline-бота. * **{bot.AUTOREPLY}** — на каждое сообщение отправляется заранее заданный шаблон, например: > Этот аккаунт предназначен только для звонков. Для переписки используйте @support\_bot. Эти функции можно включать по отдельности и настраивать поведение в зависимости от ситуации. * **{bot.UNLINK}** / **{bot.ADMIN_ASSIGN}** — позволяет снять права администратора с текущего аккаунта или назначить другого Telegram-пользователя администратором (см. [Роли аккаунтов сессии и администратора](#roles)). * **{bot.SESSION_BILLER_CHECK}** — распространить действие подписки администратора на эту сессию (см. [Роли аккаунтов сессии и администратора](#roles) и [Дополнительные сессии](/ru/docs/subscriptions/pricing#gateway)). * **{bot.SESSION_LOGOUT}** — полностью удалить виртуальное устройство, сбросить сессию и опционально очистить параметры SIP-подключений. ### Inline-бот Вы можете подключить собственного inline-бота, который будет использоваться для обработки входящих сообщений. Это особенно полезно в случаях, когда сообщение не может быть сопоставлено с номером телефона или не требуется звонок. Inline-бот может: * отвечать по шаблону; * собирать заявки; * интегрироваться с внешними системами, такими как Helpdesk, CRM и др. Дополнительно можно задать формат inline-запроса, который будет передаваться боту. Это позволяет структурировать обращение пользователя для более точной обработки.