> ## 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: "🆕 АТС→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: "Так" }; ## Ролі власника та користувача 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-акаунта). * У разі помилок авторизації або проблем див. [Питання та вирішення проблем](/uk/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 (050) 123-45-67», але оператор вимагає «+38050XXXXXXX». Припустимо, нам потрібно видалити всі нецифрові символи та перетворити початкову 8 на +38. Ось два правила (записані через пробіл): ```text theme={null} [^+*#\w]= ^8=+38 ``` **Перше** прибирає всі символи, крім цифр, літер, плюса та деяких спецсимволів (\*, #, \_).\ **Друге** замінює першу цифру 8 на +38. Тепер, якщо користувач введе `8 (050) 123-45-67`, після першого правила рядок стане `80501234567`, а після другого — `+380501234567`. Якщо потрібно дозволити вихідні дзвінки лише на українські мобільні номери (починаються на +380 та ще 9 цифр), використовуємо правило-фільтр: ```text theme={null} ^\+380\d{9}$ ``` Без знака «=». Якщо номер не відповідає `^\+380\d{9}$`, SIP-акаунт не використовуватиметься. Іноді потрібно відкинути все, якщо користувач випадково ввів невалідний номер. Можна використовувати правило-заміну на порожнечу: ```text theme={null} .*= ``` Це призведе до того, що будь-який номер заміниться на порожній рядок. Якщо порожній рядок не підходить оператору, виклик не відбудеться. Якщо виникли проблеми або помилки, див. [Питання та вирішення проблем](/uk/docs/softphone/problems).