> ## 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: "🆕 АТС→SIP․TG", NEW_IP: "🆕 IP⇿IP", NEW_OUT: "🆕 SIP․TG→АТС", 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](/uk/docs/additional/modules#storage). Укажіть номер телефону обраного акаунта Telegram. На нього надійде код від офіційного акаунта Telegram, який потрібно ввести в бота для авторизації. Якщо на акаунті ввімкнено двофакторну автентифікацію (2FA), буде запущено безпечний процес відновлення: Telegram надішле лист на пов’язану електронну пошту для скидання пароля. Це робиться, щоб не передавати ваш пароль у відкритому вигляді. ## Застосування налаштувань 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) і [Додаткові сесії](/uk/docs/subscriptions/pricing#gateway)). * **{bot.SESSION_LOGOUT}** — повністю видалити віртуальний пристрій, скинути сесію та опціонально очистити параметри SIP-підключень. ### Inline-бот Ви можете підключити власного inline-бота, який використовуватиметься для обробки вхідних повідомлень. Це особливо корисно в випадках, коли повідомлення не може бути зіставлене з номером телефону або дзвінок не потрібен. Inline-бот може: * відповідати за шаблоном; * збирати заявки; * інтегруватися із зовнішніми системами, такими як Helpdesk, CRM тощо. Додатково можна задати формат inline-запиту, який передаватиметься боту. Це дозволяє структурувати звернення користувача для точнішої обробки.