> ## 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: "Так"
};
Для коректної роботи Софтфона в Telegram необхідно:
* Мати активну підписку **Софтфон** у боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs).
* Переконатися, що в налаштуваннях конфіденційності Telegram дозволено голосові дзвінки від «Усіх» або щонайменше від **@siptg**.
* Правильно вказати в боті адресу SIP-сервера (з потрібним портом, якщо він нестандартний), логін і пароль.
* За потреби налаштувати аудіокодеки та «Правила набору» так, щоб вони відповідали вимогам вашої АТС або SIP-провайдера.
## Часті питання (FAQ)
**Софтфон** — це коли ви використовуєте Telegram у ролі SIP-клієнта (прив’язка до будь-якого оператора SIP).
**Шлюз** — це коли ви підключаєте Telegram-акаунт до АТС, щоб обробка Telegram-дзвінків відбувалася засобами АТС.
Так. Голосовий потік через Telegram — це інтернет-канал, він не заважає вашим GSM-дзвінкам.
Під час створення акаунта активуйте прапорець **{bot.RECORDER_CHECKBOX}**. Доступно на платній підписці (5 EUR/міс. за акаунт). За потреби можна вибрати окремий канал/чат, куди зберігати аудіофайли.
Так. У розділі `/softphone` у боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) відкрийте SIP-акаунт і натисніть **{bot.SWITCH_OFF}**.
У боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) відкрийте налаштування потрібного акаунта, натисніть **{bot.USER}** і виберіть профіль Telegram колеги. Тепер усі вхідні виклики надходитимуть йому, а ви залишитеся Власником.
Так, якщо ваша підписка «Софтфон» дозволяє потрібну кількість акаунтів. Можна створити кілька SIP-акаунтів. Під час вихідних викликів з’являтиметься запит на вибір акаунта перед кожним дзвінком.
Якщо у вас нестандартний порт на стороні оператора або АТС, пропишіть його в полі **{bot.DOMAIN}** або **{bot.REGISTRAR}** через двокрапку (наприклад: `sip.example.com:5062`). Для стандартного 5060 вказувати не обов’язково.
## Проблеми та налагодження
Нижче наведено розширений список проблем, з якими стикалися наші користувачі.
**Симптоми**
* У Telegram не з’являється жодної інформації про вхідний виклик.
**Можливі причини**
* Заборонено голосові дзвінки на рівні вашого акаунта Telegram.
* SIP-акаунт паралельно використовується на іншому пристрої (в іншому Софтфоні, у віджеті для дзвінків через браузер тощо).
* Втрачено зв’язок між вашим акаунтом Telegram і нашим **@siptg**.
**Рішення**
1. Перевірте налаштування в Telegram: переконайтеся, що в розділі «Конфіденційність і безпека → «Голосові дзвінки» обрано опцію «Усі».
2. Оновіть пароль SIP-акаунта на стороні SIP-провайдера або АТС і вкажіть новий пароль до акаунта в розділі `/softphone` бота [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs).
3. Відкрийте чат [@siptg](https://t.me/siptg?text=👋) і надішліть будь-яке повідомлення.
**Симптоми**
* Коли надходить вхідний (або Callback) дзвінок, користувач не встигає на нього відповісти, і в чаті **@siptg** він відображається зі статусом «Відхилений дзвінок».
* Унаслідок цього всі вхідні дзвінки автоматично відхиляються на всіх пристроях, прив’язаних до акаунта Telegram.
* У SIP-логах видно помилку `486 User declined the call`.
**Можливі причини**
* На одному з пристроїв додаток Telegram «завис» у стані активного дзвінка, хоча жодних ознак активного дзвінка немає.
* Під час вхідного дзвінка ви розмовляєте через інший додаток або по мобільному зв’язку, і в Telegram немає доступу до мікрофона пристрою.
* Ви намагаєтеся зробити тестовий дзвінок самому собі. Наприклад, під час дозвону по мобільному зв’язку (тим самим блокуючи мікрофон), виклик надходить у Telegram, і через інший активний дзвінок новий Telegram-дзвінок відхиляється.
**Рішення**
1. Визначте проблемний пристрій: кожен із ваших пристроїв по черзі потрібно відключати від інтернету, доки вхідні дзвінки не перестануть скидатися. Після цього проблемний пристрій потрібно перезавантажити або на ньому повністю вивантажити з пам’яті додаток Telegram.
2. Зробіть тестовий дзвінок, у якому беруть участь два різні пристрої, причому на другому пристрої ваш акаунт Telegram не використовується.
3. У разі повторення проблеми зберіть логи з проблемного пристрою для подальшого аналізу та усунення несправності. Докладніше див. [Отримання лог-файлів із Telegram](https://telegra.ph/Telegram-App-Logs-11-02).
Коли ви надсилаєте номер у чат, бот намагається зателефонувати вам (callback). Якщо ви не прийняли вхідний виклик у Telegram, вихідний не відбудеться.
**Що робити**:
* Увімкніть сповіщення про дзвінки в Telegram.
* Перевірте, що дзвінки дозволені від **@siptg**.
* Підтверджуйте вхідний виклик протягом 60 секунд.
Найчастіше це пов’язано з несумісністю кодеків або блокуванням UDP-трафіку.
**Рішення**
1. У боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) у розділі `/softphone` виберіть SIP-акаунт, натисніть **{bot.FORMATS}** і встановіть короткий список, наприклад: `opus,alaw,mulaw`.
За потреби вкажіть конкретний аудіокодек (наприклад, лише `alaw` або `mulaw`).
2. Якщо дзвінок здійснюється з-за кордону або через мобільний інтернет, спробуйте інший Worker-сервер.
Це пов'язано з безкоштовною підпискою. Щоб зняти обмеження — підключіть підписку «Софтфон». Докладніше див. [Огляд підписок](/uk/docs/subscriptions/pricing).
Це найчастіше пов'язано з нестабільним інтернет-з'єднанням між користувачем Telegram і нашим сервером.
**Рішення**
1. У налаштуваннях Telegram дозвольте peer-to-peer дзвінки:
☰ → Налаштування → Конфіденційність → Голосові дзвінки → Peer-to-peer → Завжди дозволяти → Додати → **@siptg**
2. Змініть тип з'єднання та пристрій; спробуйте зателефонувати з комп'ютера через Wi-Fi.
3. У боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) у розділі `/softphone` виберіть SIP-акаунт, натисніть **Worker** і виберіть інший сервер, який територіально розташований ближче.
**Симптоми**
* Під час вихідного або вхідного виклику абонента не чути, або звук різко зникає.
* Дзвінок скидається протягом 5–10 секунд.
**Можливі причини**
* Непідходящий або конфліктуючий аудіокодек.
* Провайдер або АТС не приймає поточний набір кодеків, або Telegram не встигає узгодити параметри аудіопотоку.
* Неправильне налаштування RTP або помилки в передачі голосових пакетів.
**Рішення**
1. У боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) у розділі `/softphone` виберіть SIP-акаунт, натисніть **{bot.FORMATS}** і встановіть короткий список, наприклад: `opus,alaw,mulaw`.
За потреби вкажіть конкретний аудіокодек (наприклад, лише `alaw` або `mulaw`).
2. Перевірте налаштування Worker-сервера та брандмауера.
**Симптоми**
* Під час спроби здійснити вихідний дзвінок бот повідомляє, що немає доступних ліній.
* Можливо, у логах з’являється помилка з кодом, що вказує на недоступність лінії.
**Можливі причини**
* Неправильно налаштовані «Правила набору», які виключають коректні номери.
* Перевищено кількість активних SIP-акаунтів, дозволених підпискою.
* Помилки в параметрах SIP-акаунта (неправильний логін, сервер або пароль).
**Рішення**
1. Перевірте поточні правила: у розділі `/softphone` бота [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) виберіть SIP-акаунт. Щоб скинути правила набору, натисніть **{bot.DIAL_RULES}** і введіть значення `=`.
2. Переконайтеся, що загальна кількість SIP-акаунтів відповідає оплаченій підписці.
3. Спробуйте перезапустити SIP-акаунт: у розділі `/softphone` бота [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) натисніть **{bot.SWITCH_OFF}**, а потім **{bot.SWITCH_ON}**.
**Симптоми**
* Бот повідомляє, що перевищено ліміти невдалих дзвінків або що поточний SIP-акаунт не дозволений тарифом.
* Дзвінки не проходять через перевищення встановлених лімітів.
**Можливі причини**
* Користувач самостійно активував SIP-акаунт без прив’язки до адміністрованої підписки.
* Перевищено внутрішні обмеження тарифного плану (наприклад, за кількістю невдалих спроб).
* Неправильно розподілені або активовані SIP-акаунти.
**Рішення**
1. Перевірте, що SIP-акаунт увімкнено та прив’язано в розділі `/softphone` бота.
2. Звірте кількість активних акаунтів із даними в розділі `/subscriptions`.
3. Якщо акаунт активовано самостійно, зверніться до підтримки для його перенастроювання під адміністрування.
**Симптоми**
* При спробі зателефонувати з'являється помилка, що акаунт не запущено і дзвінок не починається.
* У розділі `/softphone` акаунт позначено значком ⚠️, а в налаштуваннях такий значок біля полів Домен / Проксі / Шаблон.
**Можливі причини**
* Тимчасові перебої в інфраструктурі SIP.TG: немає зв'язку між серверами Manager і Worker.
* Тимчасові перебої на стороні провайдера телефонії або АТС: немає зв'язку між серверами Worker і АТС/провайдера.
**Рішення**
1. Змініть Worker-сервер на інший у розділі `/softphone` бота.
2. Дочекайтеся відновлення зв'язку.
Зазвичай помилки цього типу відновлюються автоматично через нетривалий час.
**Симптоми**
* Під час увімкнення SIP-акаунта з’являється помилка «Неправильні параметри (params)». Акаунт залишається не підключеним.
**Можливі причини**
* Не вказано обов’язкові параметри для підключення: **{bot.LOGIN}**, **{bot.PASSWORD}** і **{bot.DOMAIN}**.
* Вибраний **Шаблон налаштувань** не містить попередньо встановленого значення **{bot.DOMAIN}** і **{bot.REGISTRAR}** для підключення.
**Рішення**
1. Встановіть коректне значення для параметрів **{bot.DOMAIN}** і **{bot.REGISTRAR}** (якщо він відрізняється), і повторно увімкніть SIP-акаунт.
**Симптоми**
* Під час увімкнення SIP-акаунта після деякого очікування з'являється помилка «Час очікування вичерпано (timeout)». Акаунт залишається не підключеним.
**Можливі причини**
* Вказано неправильну адресу SIP-сервера.
* На SIP-сервері активний Firewall.
* SIP-сервер приймає запити на нестандартному порту.
* DNS-ім'я сервера повертає неправильну IP-адресу або кілька IP-адрес.
* DNS-ім'я сервера повертає IPv6 адресу, але SIP-сервер запущено тільки на IPv4.
**Рішення**
1. Встановіть коректне значення для параметрів **{bot.DOMAIN}** і **{bot.REGISTRAR}** (якщо він відрізняється), і повторно увімкніть SIP-акаунт.
2. У якості **{bot.REGISTRAR}** вкажіть IP-адресу в явному вигляді, залишивши **{bot.DOMAIN}** таким, що вказує на DNS-ім'я.
3. Перевірте отримання SIP-пакетів за допомогою утиліт `sngrep` або `tcpdump`.
4. Перевірте правила Firewall. Встановіть автоматичне оновлення списку білих IP-адрес з файлу `https://files.sip.tg/fw.txt`.
**Симптоми**
* Запис дзвінків працює лише якщо його вмикати вручну під час кожного дзвінка.
* Запис дзвінка переривається через 15 секунд.
**Можливі причини**
* У налаштуваннях SIP-акаунта не увімкнено налаштування **{bot.RECORDER_CHECKBOX}**.
* Під час оплати підписки «Софтфон» не було додано опцію «Запис розмов».
**Рішення**
1. Перевірте стан налаштувань SIP-акаунта. Докладніше див. [Налаштування Софтфона](/uk/docs/softphone/settings).
2. Підключіть опцію «Запис розмов» у налаштуваннях підписки. Докладніше див. [Підписка «Софтфон»](/uk/docs/subscriptions/pricing#softphone).
**Симптоми**
* У розділі `/softphone` у боті немає кнопок з налаштуваннями акаунта ({bot.LOGIN}, {bot.PASSWORD}, {bot.DOMAIN}, {bot.REGISTRAR}, Worker, {bot.DIAL_RULES}, {bot.DTMF_METHODS}, {bot.FORMATS}). Є лише кнопки **{bot.SWITCH_OFF}** та **{bot.DELETE}**.
**Можливі причини**
* Ви є Користувачем SIP-акаунта, але не Власником.
**Рішення**
1. Зверніться до власника SIP-акаунта з проханням змінити ваші налаштування.
Докладніше див. [Ролі власника та користувача SIP-акаунта](/uk/docs/softphone/settings#roles).
* **403 Forbidden**: неправильний пароль/логін, або оператор вас заблокував.
* **404 Not Found**: неправильний домен SIP або номер абонента не знайдено.
* **408 Request Timeout**: провайдер не відповідає, спробуйте інший Worker або перевірте брандмауер.
* **503 Service Unavailable**: у оператора тимчасові проблеми або перевищено ліміти Telegram (Too Many Requests).
* **603 Declined**: дзвінок відхилено оператором або абонентом, якому телефонують.
* **Обмеження Telegram при масових викликах**:\
При великій кількості вихідних дзвінків система може видавати помилки `503 Too Many Requests` або `408 Timeout of waiting RPC result`. Рішення — знизьте швидкість обдзвону.
* **Проблеми з DTMF**:\
Якщо під час взаємодії з голосовим меню (IVR) не розпізнаються натискання, змініть метод передачі DTMF у налаштуваннях (наприклад, перейдіть із `inband` на `RFC2833` або `INFO`).
* **Проблеми з реєстрацією на Worker-сервері**:\
Іноді SIP-реєстрація не відбувається через те, що Worker-сервер не відповідає або IP-адреса не внесено до «білого списку». Рішення — перевірте налаштування мережі та додайте необхідні IP до білого списку.
* **Конфлікти при самостійному оновленні налаштувань**:\
Якщо користувачі самостійно змінюють параметри SIP-акаунта (наприклад, аудіокодеки, правила набору), це може призвести до помилок при масовому управлінні. Рекомендується централізоване адміністрування через спільний «адмінський» акаунт.
Якщо описані дії не допомогли, зверніться за допомогою. Докладніше див. [Як отримати допомогу](/uk/docs#help).