> ## 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 subsc_opts = {
  all_workers: "Платні Workers",
  api_access: "Доступ до АПІ",
  call_duration: "Тривалість виклику",
  fail_calls: "Неуспішні виклики",
  group_size: "Розмір групи",
  gw_sessions: "Додаткові сесії",
  lines: "Лінії для шлюзу",
  no_advert: "Вимкнення сповіщення",
  other_users: "Призначити SIP акаунти",
  parallel_call: "Перемикання дзвінків",
  phones: "Номери",
  recorder_allowed: "Запис дзвінків",
  recorder_call_duration: "Тривалість запису",
  sip_accounts: "SIP акаунти",
  success_calls: "Успішні дзвінки",
  sum_duration: "Загальна тривалість",
  tariff_activation: "Активація",
  template_owner: "SIP приклад власника ",
  usage: "Використання"
};

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: "Так"
};

Нижче описано можливі помилки, які можуть виникати під час роботи **Шлюзу** (режим PBX→Telegram) — як на етапі реєстрації (PBX→SIP.TG), так і в момент установлення дзвінка (SIP→Telegram або Telegram→SIP). Деякі з них з’являються в логах АТС, деякі — як відображуваний код при спробі викликати акаунт Telegram. При цьому не всі помилки часто зустрічаються в реальній експлуатації, але знати про них корисно для діагностики.

Для довідки:

* **Manager** — керуючий компонент SIP.TG, відповідальний за підключення до Worker-серверів і Сховищ сесій.
* **Worker** — робочий компонент, який обробляє дзвінки, RTP-трафік і виконує SIP-сигналізацію.

Якщо ви тільки починаєте роботу зі Шлюзом, рекомендуємо також ознайомитися зі статтями:

* [Взаємодія з Telegram](/uk/docs/gateway/telegram) — як авторизувати акаунт Telegram для дзвінків.
* [Взаємодія з АТС](/uk/docs/gateway/pbx) — детальний опис опцій SIP-підключення.
* [Огляд підписок](/uk/docs/subscriptions/pricing) — щоб переконатися, що ваша підписка «Шлюз» покриває потрібну кількість ліній.

## Часті питання (FAQ)

<AccordionGroup>
  <Accordion title="Що буде, якщо хтось подзвонить на цей акаунт напряму?">
    Акаунт Telegram під час налаштування Шлюзу передає вхідні виклики до АТС.\
    Якщо людина в списку дозволених викликаючих, дзвінок буде спрямований до АТС, а на пристрої, де відкрито цей акаунт, можна вручну також прийняти дзвінок.\
    Зазвичай рекомендується вимкнути прийом дзвінків на інших пристроях, щоб усе йшло через АТС.
  </Accordion>

  <Accordion title="Чи можна працювати одразу з кількома акаунтами Telegram?">
    Так, у підписці «Шлюз» можна оплачувати кілька акаунтів Telegram. Перший акаунт коштує 15 EUR/міс, кожен додатковий — 150 EUR/міс.
  </Accordion>

  <Accordion title="Як бути, якщо треба обробляти й текстові повідомлення?">
    Шлюз може обробляти вхідні повідомлення, якщо ввімкнути опцію **{bot.ARBITRARY_CHECK}** у налаштуваннях шлюзу. Вона вмикає автовідповідь, режим Callback і обробку повідомлень зовнішнім ботом.\
    Докладніше див. [Налаштування сесії SIP.TG](/uk/docs/gateway/telegram#session-settings).
  </Accordion>

  <Accordion title={`Як вимкнути будь-які повідомлення під час дзвінка та після нього (кнопки DTMF, ${bot.REDIAL} тощо)?`}>
    У налаштуваннях вашої Telegram-сесії вимкніть такі опції: **{bot.KEYPAD_IN}**, **{bot.KEYPAD_OUT}**, **{bot.REDIAL_CHECK}**, **{bot.LINES_CHECK}** та **{bot.ARBITRARY_CHECK}**.
    Докладніше див. [Налаштування сесії SIP.TG](/uk/docs/gateway/telegram#session-settings).
  </Accordion>

  <Accordion title="Наскільки це надійно?">
    Уся інфраструктура SIP.TG розподілена по кількох дата-центрах. Проте для критично важливих систем можна розглянути власні Worker-сервери.
  </Accordion>

  <Accordion title="Який акаунт Telegram краще використовувати як Шлюз?">
    Рекомендується завести окремий робочий акаунт для компанії — щоб особистий Telegram не змішувався з бізнес-дзвінками. Важливо, щоб цей акаунт був завжди онлайн (або зберігайте сесію в хмарному Сховищі SIP.TG).
  </Accordion>

  <Accordion title="Чи можна робити холодні дзвінки з Telegram-акаунта шлюзу? Його не заблокують?">
    Telegram може обмежити або повністю заблокувати ваш Telegram-акаунт шлюзу. Ми не рекомендуємо таку діяльність і не переносимо підписку на інший Telegram-акаунт у разі блокування.

    Водночас, якщо ви бажаєте зберегти підписку, є рішення:

    1. Підключіть підписку «Шлюз» на ім’я Адміністратора (див. [Ролі акаунтів сесії та адміністратора](/uk/docs/gateway/telegram)) з опцією **{subsc_opts.gw_sessions}** ≥ 1.
    2. Від імені адміністратора створіть нову Telegram-сесію, прив’язану до акаунта, який використовується для дзвінків.
    3. Увімкніть опцію **{bot.SESSION_BILLER_CHECK}** для створеної сесії.
    4. Якщо Telegram-акаунт для дзвінків заблокують, вимкніть сесію через її налаштування в розділі `/gateway` **із збереженням поточних налаштувань**, і підключіть там новий Telegram-акаунт.
  </Accordion>

  <Accordion title="Чи можна один акаунт Telegram розділити між кількома співробітниками?">
    Так, але це означає, що всі користуватимуться одним обліковим записом Telegram, а вхідні дзвінки надходитимуть на всі пристрої одночасно. Щойно один відповість, у решти виклик скинеться.
  </Accordion>

  <Accordion title="Чому дзвінок скидається в інших, коли одна людина відповіла?">
    Це нормальна поведінка Шлюзу: АТС бачить, що виклик уже прийнято. Іншим клієнтам надсилається CANCEL. Якщо потрібно, щоб кожен співробітник мав свій акаунт Telegram, використовуйте кілька підписок шлюзу.
  </Accordion>

  <Accordion title="Чи потрібна SIM-карта?">
    Акаунт Telegram створюється на основі номера телефону. Зазвичай беруть будь-яку SIM-карту, реєструють у Telegram, а далі номер може не використовуватися для голосових викликів класичного оператора. Головне — не втрачати доступ до цього номера для відновлення Telegram.
  </Accordion>

  <Accordion title="Який використовується діапазон портів для RTP?">
    Наш SIP-стек базується на Yate, де за замовчуванням використовується діапазон UDP-портів 16384–32768.
  </Accordion>
</AccordionGroup>

## Проблеми загального характеру

<AccordionGroup>
  <Accordion title="Вхідний виклик не надходить на шлюз Telegram">
    * Перевірте, що акаунт Telegram активний, не заблокований месенджером.
    * Переконайтеся, що в налаштуваннях конфіденційності Telegram дозволено дзвінки від усіх.
  </Accordion>

  <Accordion title="Одностороння чутність при використанні Шлюзу">
    Як і у випадку з Софтфоном, найчастіше це питання кодеків або мережевих обмежень.

    * Спробуйте вказати конкретний кодек (`alaw` або `mulaw`).
    * Переконайтеся, що UDP-трафік дозволено.
  </Accordion>

  <Accordion title="DTMF не розпізнається в голосовому меню">
    * Переконайтеся, що в налаштуваннях SIP-акаунта (Шлюзу) обрано метод RFC2833 або INFO, сумісний із вашою АТС.
    * Спробуйте перемкнути кодек, іноді inband DTMF і високе стиснення не дружать.
  </Accordion>
</AccordionGroup>

## Загальні SIP-помилки

Такі відповіді можуть з’являтися як під час дзвінків, так і при простій реєстрації SIP-транка. Зазначений нижче код відповідає сервер SIP.TG вашій АТС.

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    **Суть:** Стандартна відповідь при використанні SIP Digest Auth. АТС надсилає INVITE або REGISTER без повного набору авторизаційних даних, а сервер SIP.TG запитує авторизацію.\
    Якщо помилка 401 з’являється багато разів поспіль, це означає, що або пароль/логін невірні, або на стороні АТС відключено підтримку Digest Auth.

    **Що робити:**

    * Переконатися, що логін/пароль із бота [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) (розділ `/gateway`) введено коректно в налаштуваннях вашої АТС.
    * Перевірити, що в самій АТС увімкнено режим SIP-авторизації (Digest Auth).
    * За потреби змінити пароль у `/gateway` і ввести його заново.
  </Accordion>

  <Accordion title="402 …">
    **Суть:** Обмеження підписки «Шлюз». Це означає, що в акаунта Telegram немає оплачених ліній для режиму Шлюз, підписка закінчилася або обсяг ресурсів перевищено.

    **Що робити:**

    * У боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) командою `/subscriptions` перевірте, чи активний тариф «Шлюз» і чи достатньо ліній.
    * Якщо термін підписки минув або потрібні додаткові лінії, оформіть продовження / розширення підписки (див. [Огляд підписок](/uk/docs/subscriptions/pricing)).
    * Переконайтеся, що конкретний акаунт Telegram дійсно прив’язаний до потрібної підписки (при оплаті кількох акаунтів).
  </Accordion>

  <Accordion title="500 Database error">
    **Суть:** Внутрішня помилка на стороні SIP.TG, пов’язана з базою даних. Такі випадки вкрай рідкісні.

    **Що робити:**

    * Зазвичай носить тимчасовий характер і усувається автоматично.
    * Повторіть спробу, при регулярному повторенні помилки зверніться по допомогу. Докладніше див. [Як отримати допомогу](/uk/docs#help).
  </Accordion>

  <Accordion title="503 No response from Manager">
    **Суть:** Worker не може зв’язатися з Manager-сервером SIP.TG через внутрішню мережеву проблему. Ваша АТС побачить це як відповідь `503 No response from Manager`.

    **Що робити:**

    * Як правило, це короткочасні збої. Спробуйте зачекати 1–2 хвилини і повторити виклик.
    * Якщо проблема не вирішується, можна перемкнути SIP-транк на інший Worker-сервер (див. [Взаємодія з АТС](/uk/docs/gateway/pbx)).
  </Accordion>
</AccordionGroup>

## Помилки при реєстрації PBX → SIP.TG

Тут зібрано відповіді, які можуть надійти, коли ваша АТС намагається зареєструватися на Worker-сервері SIP.TG (підключення типу PBX→SIP.TG). Усі зазначені нижче помилки зазвичай мають код 403 або 404.

<AccordionGroup>
  <Accordion title="403 Wrong password">
    **Суть:** АТС коректно намагається авторизуватися, але вказаний пароль не збігається з тим, що очікує SIP.TG.

    **Що робити:**

    * Перевірте пароль у розділі `/gateway` бота [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) і порівняйте з тим, що введено на АТС.
    * За потреби змініть пароль у боті (кнопка «Змінити пароль») і введіть новий на стороні АТС.
    * Переконайтеся, що логін (username) також не містить помилок.
  </Accordion>

  <Accordion title="403 Untrusted IP address">
    **Суть:** Пароль правильний, але ваша IP-адреса не входить до списку дозволених для цього SIP-підключення.

    **Що робити:**

    * У боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs), розділ `/gateway`, відкрийте налаштування відповідного SIP-підключення і:
      * Додайте вашу IP-адресу до списку довірених.
      * Або очистіть список, щоб дозволити підключення з будь-якої IP (але дотримуйтесь заходів безпеки).
    * Якщо у вашій мережі змінюється зовнішня IP, враховуйте це під час налаштування (можливо, варто повністю відключити ACL).
  </Accordion>

  <Accordion title="403 Telegram session is inactive">
    **Суть:** Акаунт Telegram, до якого здійснюється прив’язка, неактивний (втрачено авторизацію). У результаті SIP.TG відмовляється реєструвати транк, оскільки реального з’єднання Telegram немає.

    **Що робити:**

    * У боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) у розділі `/gateway` перепідключіть акаунт Telegram (проведіть авторизацію номера телефону).
    * Якщо акаунт Telegram було видалено, доведеться призначити інший номер телефону для Шлюзу.
    * Докладніше див. [Взаємодія з Telegram](/uk/docs/gateway/telegram).
  </Accordion>

  <Accordion title="403 Session storage is inactive">
    **Суть:** Сховище, де збережена сесія Telegram (хмарне або ваше власне Сховище сесій), наразі відключене або недоступне. Відповідно, немає можливості працювати з сесією Telegram.

    **Що робити:**

    * Якщо використовуєте хмарне сховище SIP.TG, перевірте статус у `/gateway`. Зазвичай такі збої короткочасні.
    * Якщо у вас власне Сховище сесій, переконайтеся, що воно запущене і доступне. За потреби перемкніться на хмару SIP.TG.
  </Accordion>

  <Accordion title="403 Worker is inactive">
    **Суть:** Обраний Worker-сервер відключений на стороні SIP.TG або перебуває в процесі оновлення/перезавантаження. Сервер не може прийняти реєстрацію PBX→SIP.TG.

    **Що робити:**

    * У розділі `/gateway` бота перевірте налаштування Worker. Якщо сервер відключений, оберіть інший або зачекайте, поки він знову стане активним.
    * Якщо це ваш [власний Worker](/uk/docs/additional/modules#worker), запустіть/перезавантажте його.
  </Accordion>

  <Accordion title="403 Worker address is not set">
    **Суть:** Конфігурація Worker-сервера не передбачає, що до нього підключатимуться з типом «PBX→SIP.TG». Наприклад, сервер налаштований лише під «SIP.TG→PBX» або «IP⇿IP».

    **Що робити:**

    * У боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) перевірте тип підключення (PBX→SIP.TG) і оберіть відповідний Worker.
    * Створіть SIP-підключення іншого типу («SIP.TG→PBX» або «IP⇿IP»).
  </Accordion>

  <Accordion title="403 Route is not permitted">
    **Суть:** Доступ до використаної сесії Telegram відкликано або вона більше не належить вам. Наприклад, адміністратор, який створив сесію, позбавлений прав, і ви не можете використовувати цю сесію.

    **Що робити:**

    * Створіть власну сесію Шлюзу. У розділі `/gateway` бота підключіть номер Telegram, який ви контролюєте.
    * Переконайтеся, що адміністратор, який раніше створював сесію, не забрав у вас доступ.
  </Accordion>

  <Accordion title="404 Route not found">
    **Суть:** Зазначений у SIP-запиті логін не існує або вже видалений. Сервер SIP.TG не знаходить такого «облікового запису».

    **Що робити:**

    * Перевірте логін/username, який ви отримали в розділі `/gateway`.
    * Якщо раніше цей запис було видалено, створіть новий.
    * Переконайтеся, що в вашій АТС прописано саме той логін, що виданий ботом (без зайвих символів або пробілів).
  </Accordion>
</AccordionGroup>

## Помилки при дзвінку SIP → Telegram

Ці помилки виникають, коли ваша АТС уже зареєстрована (або IP-to-IP), і при вихідному виклику в Telegram сервер SIP.TG повертає код, якщо не може коректно додзвонитися до акаунта Telegram.

<AccordionGroup>
  <Accordion title="403 USER_PRIVACY_RESTRICTED / 403 PRIVACY_PREMIUM_REQUIRED">
    **Суть:** Користувач Telegram обмежив коло осіб, які можуть йому дзвонити (наприклад, лише контакти або користувачі з преміум-підпискою), а ваш акаунт шлюзу не потрапив до цього списку.

    **Що робити:**

    * Попросіть користувача, якого викликають, налаштувати дозвіл дзвінків: «Налаштування → Конфіденційність → Голосові дзвінки» → «Усі користувачі» або додати ваш акаунт шлюзу до «Завжди дозволяти».
    * Або використовуйте акаунт, який дійсно є в контактах цільового користувача.
  </Accordion>

  <Accordion title="404 Not Found / 404 Chat not found / 404 USERNAME_NOT_OCCUPIED">
    **Суть:** SIP.TG не зміг знайти акаунт Telegram за переданим ідентифікатором (номер, user\_id, username). Telegram може повернути таку відповідь, якщо:

    * Номер дійсно не зареєстрований у Telegram.
    * Username не існує або звільнений.
    * Профіль недоступний через обмеження.
    * Ваш акаунт шлюзу занадто часто виконує пошук за номером телефону.

    **Що робити:**

    * Переконатися, що ви використовуєте правильний ідентифікатор (якщо використовуєте телефон — це має бути реальний номер Telegram).
    * Якщо виникає часто, перевірте, чи не помилилися у форматі. Можливо, краще використовувати внутрішній user\_id.
  </Accordion>

  <Accordion title="405 REGISTER is required first">
    **Суть:** Ви надсилаєте INVITE без попередньої реєстрації PBX→SIP.TG, тоді як Worker вимагає повноцінний REGISTER.

    **Що робити:**

    * На стороні вашої АТС увімкнути режим «Registration» (зареєструвати транк PBX→SIP.TG). Докладніше див. [Взаємодія з АТС](/uk/docs/gateway/pbx).
  </Accordion>

  <Accordion title="408 Timeout of waiting RPC result">
    **Суть:** Сервер Telegram не відповів вчасно, або запит SIP.TG завис при зверненні до Telegram. Це буває при перевантаженні або антиспам-фільтрі Telegram, коли є багато вихідних викликів за короткий час.

    **Що робити:**

    * Знизити інтенсивність вихідних дзвінків.
    * Зачекати і повторити спробу, якщо був тимчасовий збій.
  </Accordion>

  <Accordion title="470 Anonymous user">
    **Суть:** SIP.TG намагається зателефонувати користувачу за його внутрішнім user\_id, з яким немає явного підтвердженого контакту. Telegram відхиляє такі «анонімні» виклики.

    **Що робити:**

    * Зазвичай потрібно або зателефонувати за підтвердженим номером чи username, або щоб користувач сам додав вас до контактів чи написав вам спочатку.
  </Accordion>

  <Accordion title="500 (інші)">
    **Суть:** Будь-яка інша внутрішня помилка на стороні Telegram. Іноді так позначаються несподівані збої при обробці аудіоканалу, при внутрішньому перевантаженні тощо.

    **Що робити:**

    * Перевірити стабільність мережі, повторити виклик.
    * Якщо помилка з’являється регулярно на одному й тому ж номері, зверніться по допомогу. Докладніше див. [Як отримати допомогу](/uk/docs#help).
  </Accordion>

  <Accordion title="503 Account is not running">
    **Суть:** Worker-сервер SIP.TG отримав INVITE, але фактично немає активної сесії для потрібного акаунта. Тобто PBX могла надіслати INVITE, не дочекавшись відповіді на REGISTER.

    **Що робити:**

    * Переконатися, що транк PBX→SIP.TG успішно зареєстрований і Worker бачить активний обліковий запис.
    * Іноді допомагає перезавантажити транк на АТС. За потреби див. [Взаємодія з АТС](/uk/docs/gateway/pbx).
  </Accordion>

  <Accordion title="503 Session is not running">
    **Суть:** Сесія Telegram фактично відключена. Можливий випадок, коли в боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) сесія відображається, але реально вона не авторизована.

    **Що робити:**

    * Перевірити статус сесії в `/gateway`, за потреби заново авторизувати номер Telegram.
    * Якщо помилка виникає часто, спробуйте перемкнутися на інший Worker або перезавантажити акаунт.
  </Accordion>

  <Accordion title="503 Telegram storage is unavailable">
    **Суть:** SIP.TG втратив з’єднання зі сховищем сесій Telegram, тому не може дізнатися поточний статус або створити дзвінок.

    **Що робити:**

    * Якщо використовуєте хмарне сховище, зачекайте відновлення (зазвичай хвилина-дві).
    * Якщо власне Сховище сесій, перевірте логи і статус модуля.
  </Accordion>

  <Accordion title="503 Too Many Requests: retry after … / 503 PEER_FLOOD">
    **Суть:** Це захист від спаму Telegram, коли за короткий проміжок відбувається забагато вихідних дзвінків, особливо на незнайомі номери.

    **Що робити:**

    * Знизити швидкість обдзвону (на стороні АТС або вашого скрипта).
    * Використовувати кілька різних акаунтів Telegram, щоб розподілити навантаження.
    * Дочекатися зазначеного часу «retry after N», потім повторити.
  </Accordion>

  <Accordion title="503 Worker is not ready">
    **Суть:** Worker нещодавно перезавантажений або оновлюється, і ще не завершив ініціалізацію. У результаті виклики відхиляються на рівні SIP.

    **Що робити:**

    * Зачекати 1–2 хвилини і повторити виклик.
    * Або в боті [@siptg\_bot](https://t.me/siptg_bot?start=utm_docs) оберіть інший Worker-сервер для вашого підключення.
  </Accordion>
</AccordionGroup>

## Помилки при дзвінку Telegram → SIP

Тут розглядаються ситуації, коли реальний користувач намагається зателефонувати на акаунт Шлюзу з додатка Telegram, а Worker намагається перевести виклик у вашу АТС. Якщо АТС поверне помилку, або якщо помилка виникне на стороні SIP.TG, користувач може побачити помилку в чаті з акаунтом Шлюзу.

У цьому розділі ми наводимо лише ті помилки, які можуть виникнути на стороні SIP.TG.

<AccordionGroup>
  <Accordion title="482 Caller has active gateway accounts">
    **Суть:** На акаунті того, хто викликає, також активовано Шлюз SIP.TG. Сервіс блокує таку спробу (Telegram→SIP), щоб не виникало зациклення або непередбачених петель викликів.

    **Що робити:**

    * Якщо дійсно потрібно приймати дзвінки від акаунта, який також є шлюзовим, краще використовуйте для нього інший режим (наприклад, [Софтфон](/uk/docs/softphone)) або інший акаунт Telegram без Шлюзу.
  </Accordion>

  <Accordion title="503 SIP account is unavailable">
    **Суть:** Під час вхідного дзвінка зі сторони Telegram Worker не зміг додзвонитися до вашої АТС. Це може статися, якщо транк PBX→SIP.TG упав, або у вас IP-to-IP, але не відповідає потрібний порт.

    **Що робити:**

    * Переконатися, що АТС зареєстрована (при PBX→SIP.TG) або що з’єднання IP-to-IP активне.
    * Перевірити, чи не блокуються SIP/UDP-пакети у вашому фаєрволі, і чи відкриті RTP-порти.
    * Докладніше див. [Взаємодія з АТС](/uk/docs/gateway/pbx).
  </Accordion>

  <Accordion title="503 Worker is unavailable">
    **Суть:** Worker-сервер наразі недоступний для передачі виклику (проблеми мережі або перезавантаження), і виклик відхиляється з кодом 503.

    **Що робити:**

    * Зачекати деякий час або перемкнути акаунт Шлюзу на інший Worker (розділ `/gateway` бота).
    * Якщо це ваш власний Worker-сервер, перевірте його логи і перезавантажте за потреби.
  </Accordion>
</AccordionGroup>

<Info>
  Якщо жодне з перелічених рішень не допомагає, звертайтеся по допомогу. Докладніше див. [Як отримати допомогу](/uk/docs#help).
</Info>
