Питання та вирішення проблем
Нижче описано можливі помилки, які можуть виникати під час роботи Шлюзу (режим PBX→Telegram) — як на етапі реєстрації (PBX→SIP.TG), так і в момент установлення дзвінка (SIP→Telegram або Telegram→SIP). Деякі з них з’являються в логах АТС, деякі — як відображуваний код при спробі викликати акаунт Telegram. При цьому не всі помилки часто зустрічаються в реальній експлуатації, але знати про них корисно для діагностики.
Для довідки:
- Manager — керуючий компонент SIP.TG, відповідальний за підключення до Worker-серверів і Сховищ сесій.
- Worker — робочий компонент, який обробляє дзвінки, RTP-трафік і виконує SIP-сигналізацію.
- Взаємодія з Telegram — як авторизувати акаунт Telegram для дзвінків.
- Взаємодія з АТС — детальний опис опцій SIP-підключення.
- Огляд підписок — щоб переконатися, що ваша підписка «Шлюз» покриває потрібну кількість ліній.
Часті питання (FAQ)
Що буде, якщо хтось подзвонить на цей акаунт напряму?
Що буде, якщо хтось подзвонить на цей акаунт напряму?
Акаунт Telegram під час налаштування Шлюзу передає вхідні виклики до АТС.
Якщо людина в списку дозволених викликаючих, дзвінок буде спрямований до АТС, а на пристрої, де відкрито цей акаунт, можна вручну також прийняти дзвінок.
Зазвичай рекомендується вимкнути прийом дзвінків на інших пристроях, щоб усе йшло через АТС.
Якщо людина в списку дозволених викликаючих, дзвінок буде спрямований до АТС, а на пристрої, де відкрито цей акаунт, можна вручну також прийняти дзвінок.
Зазвичай рекомендується вимкнути прийом дзвінків на інших пристроях, щоб усе йшло через АТС.
Чи можна працювати одразу з кількома акаунтами Telegram?
Чи можна працювати одразу з кількома акаунтами Telegram?
Так, у підписці «Шлюз» можна оплачувати кілька акаунтів Telegram. Перший акаунт коштує 15 EUR/міс, кожен додатковий — 150 EUR/міс.
Як бути, якщо треба обробляти й текстові повідомлення?
Як бути, якщо треба обробляти й текстові повідомлення?
Шлюз може обробляти вхідні повідомлення, якщо ввімкнути опцію «Обробка повідомлень» у налаштуваннях шлюзу. Вона вмикає автовідповідь, режим Callback і обробку повідомлень зовнішнім ботом.
Докладніше див. Налаштування сесії SIP.TG.
Докладніше див. Налаштування сесії SIP.TG.
Наскільки це надійно?
Наскільки це надійно?
Уся інфраструктура SIP.TG розподілена по кількох дата-центрах. Проте для критично важливих систем можна розглянути власні Worker-сервери.
Який акаунт Telegram краще використовувати як Шлюз?
Який акаунт Telegram краще використовувати як Шлюз?
Рекомендується завести окремий робочий акаунт для компанії — щоб особистий Telegram не змішувався з бізнес-дзвінками. Важливо, щоб цей акаунт був завжди онлайн (або зберігайте сесію в хмарному Сховищі SIP.TG).
Чи можна один акаунт Telegram розділити між кількома співробітниками?
Чи можна один акаунт Telegram розділити між кількома співробітниками?
Так, але це означає, що всі користуватимуться одним обліковим записом Telegram, а вхідні дзвінки надходитимуть на всі пристрої одночасно. Щойно один відповість, у решти виклик скинеться.
Чому дзвінок скидається в інших, коли одна людина відповіла?
Чому дзвінок скидається в інших, коли одна людина відповіла?
Це нормальна поведінка Шлюзу: АТС бачить, що виклик уже прийнято. Іншим клієнтам надсилається CANCEL. Якщо потрібно, щоб кожен співробітник мав свій акаунт Telegram, використовуйте кілька підписок шлюзу.
Чи потрібна SIM-карта?
Чи потрібна SIM-карта?
Акаунт Telegram створюється на основі номера телефону. Зазвичай беруть будь-яку SIM-карту, реєструють у Telegram, а далі номер може не використовуватися для голосових викликів класичного оператора. Головне — не втрачати доступ до цього номера для відновлення Telegram.
Проблеми загального характеру
Вхідний виклик не надходить на шлюз Telegram
Вхідний виклик не надходить на шлюз Telegram
- Перевірте, що акаунт Telegram активний, не заблокований месенджером.
- Переконайтеся, що в налаштуваннях конфіденційності Telegram дозволено дзвінки від усіх.
Одностороння чутність при використанні Шлюзу
Одностороння чутність при використанні Шлюзу
Як і у випадку з Софтфоном, найчастіше це питання кодеків або мережевих обмежень.
- Спробуйте вказати конкретний кодек (
alawабоmulaw). - Переконайтеся, що UDP-трафік дозволено.
DTMF не розпізнається в голосовому меню
DTMF не розпізнається в голосовому меню
- Переконайтеся, що в налаштуваннях SIP-акаунта (Шлюзу) обрано метод RFC2833 або INFO, сумісний із вашою АТС.
- Спробуйте перемкнути кодек, іноді inband DTMF і високе стиснення не дружать.
Загальні SIP-помилки
Такі відповіді можуть з’являтися як під час дзвінків, так і при простій реєстрації SIP-транка. Зазначений нижче код відповідає сервер SIP.TG вашій АТС.401 Unauthorized
401 Unauthorized
402 …
402 …
Суть: Обмеження підписки «Шлюз». Це означає, що в акаунта Telegram немає оплачених ліній для режиму Шлюз, підписка закінчилася або обсяг ресурсів перевищено.Що робити:
- У боті @siptg_bot командою
/subscriptionsперевірте, чи активний тариф «Шлюз» і чи достатньо ліній. - Якщо термін підписки минув або потрібні додаткові лінії, оформіть продовження / розширення підписки (див. Огляд підписок).
- Переконайтеся, що конкретний акаунт Telegram дійсно прив’язаний до потрібної підписки (при оплаті кількох акаунтів).
500 Database error
500 Database error
Суть: Внутрішня помилка на стороні SIP.TG, пов’язана з базою даних. Такі випадки вкрай рідкісні.Що робити:
- Зазвичай носить тимчасовий характер і усувається автоматично.
- Повторіть спробу, при регулярному повторенні помилки зверніться по допомогу. Докладніше див. Як отримати допомогу.
503 No response from Manager
503 No response from Manager
Суть: Worker не може зв’язатися з Manager-сервером SIP.TG через внутрішню мережеву проблему. Ваша АТС побачить це як відповідь
503.Що робити:- Як правило, це короткочасні збої. Спробуйте зачекати 1–2 хвилини і повторити виклик.
- Якщо проблема не вирішується, можна перемкнути SIP-транк на інший Worker-сервер (див. Взаємодія з АТС).
Помилки при реєстрації PBX → SIP.TG
Тут зібрано відповіді, які можуть надійти, коли ваша АТС намагається зареєструватися на Worker-сервері SIP.TG (підключення типу PBX→SIP.TG). Усі зазначені нижче помилки зазвичай мають код 403 або 404.403 Wrong password
403 Wrong password
Суть: АТС коректно намагається авторизуватися, але вказаний пароль не збігається з тим, що очікує SIP.TG.Що робити:
- Перевірте пароль у розділі
/gatewayбота @siptg_bot і порівняйте з тим, що введено на АТС. - За потреби змініть пароль у боті (кнопка «Змінити пароль») і введіть новий на стороні АТС.
- Переконайтеся, що логін (username) також не містить помилок.
403 Untrusted IP address
403 Untrusted IP address
Суть: Пароль правильний, але ваша IP-адреса не входить до списку дозволених для цього SIP-підключення.Що робити:
- У боті @siptg_bot, розділ
/gateway, відкрийте налаштування відповідного SIP-підключення і:- Додайте вашу IP-адресу до списку довірених.
- Або очистіть список, щоб дозволити підключення з будь-якої IP (але дотримуйтесь заходів безпеки).
- Якщо у вашій мережі змінюється зовнішня IP, враховуйте це під час налаштування (можливо, варто повністю відключити ACL).
403 Telegram session is inactive
403 Telegram session is inactive
Суть: Акаунт Telegram, до якого здійснюється прив’язка, неактивний (втрачено авторизацію). У результаті SIP.TG відмовляється реєструвати транк, оскільки реального з’єднання Telegram немає.Що робити:
- У боті @siptg_bot у розділі
/gatewayперепідключіть акаунт Telegram (проведіть авторизацію номера телефону). - Якщо акаунт Telegram було видалено, доведеться призначити інший номер телефону для Шлюзу.
- Докладніше див. Взаємодія з Telegram.
403 Session storage is inactive
403 Session storage is inactive
Суть: Сховище, де збережена сесія Telegram (хмарне або ваше власне Сховище сесій), наразі відключене або недоступне. Відповідно, немає можливості працювати з сесією Telegram.Що робити:
- Якщо використовуєте хмарне сховище SIP.TG, перевірте статус у
/gateway. Зазвичай такі збої короткочасні. - Якщо у вас власне Сховище сесій, переконайтеся, що воно запущене і доступне. За потреби перемкніться на хмару SIP.TG.
403 Worker is inactive
403 Worker is inactive
Суть: Обраний Worker-сервер відключений на стороні SIP.TG або перебуває в процесі оновлення/перезавантаження. Сервер не може прийняти реєстрацію PBX→SIP.TG.Що робити:
- У розділі
/gatewayбота перевірте налаштування Worker. Якщо сервер відключений, оберіть інший або зачекайте, поки він знову стане активним. - Якщо це ваш власний Worker, запустіть/перезавантажте його.
403 Worker address is not set
403 Worker address is not set
Суть: Конфігурація Worker-сервера не передбачає, що до нього підключатимуться з типом «PBX→SIP.TG». Наприклад, сервер налаштований лише під «SIP.TG→PBX» або «IP⇿IP».Що робити:
- У боті @siptg_bot перевірте тип підключення (PBX→SIP.TG) і оберіть відповідний Worker.
- Створіть SIP-підключення іншого типу («SIP.TG→PBX» або «IP⇿IP»).
403 Route is not permitted
403 Route is not permitted
Суть: Доступ до використаної сесії Telegram відкликано або вона більше не належить вам. Наприклад, адміністратор, який створив сесію, позбавлений прав, і ви не можете використовувати цю сесію.Що робити:
- Створіть власну сесію Шлюзу. У розділі
/gatewayбота підключіть номер Telegram, який ви контролюєте. - Переконайтеся, що адміністратор, який раніше створював сесію, не забрав у вас доступ.
404 Route not found
404 Route not found
Суть: Зазначений у SIP-запиті логін не існує або вже видалений. Сервер SIP.TG не знаходить такого «облікового запису».Що робити:
- Перевірте логін/username, який ви отримали в розділі
/gateway. - Якщо раніше цей запис було видалено, створіть новий.
- Переконайтеся, що в вашій АТС прописано саме той логін, що виданий ботом (без зайвих символів або пробілів).
Помилки при дзвінку SIP → Telegram
Ці помилки виникають, коли ваша АТС уже зареєстрована (або IP-to-IP), і при вихідному виклику в Telegram сервер SIP.TG повертає код, якщо не може коректно додзвонитися до акаунта Telegram.403 USER_PRIVACY_RESTRICTED
403 USER_PRIVACY_RESTRICTED
Суть: Користувач Telegram обмежив коло осіб, які можуть йому дзвонити (наприклад, лише контакти), а ваш акаунт шлюзу не потрапив до цього списку.Що робити:
- Попросіть користувача, якого викликають, налаштувати дозвіл дзвінків: «Налаштування → Конфіденційність → Голосові дзвінки» → «Усі користувачі» або додати ваш акаунт шлюзу до «Завжди дозволяти».
- Або використовуйте акаунт, який дійсно є в контактах цільового користувача.
404 Not Found / 404 Chat not found / 404 USERNAME_NOT_OCCUPIED
404 Not Found / 404 Chat not found / 404 USERNAME_NOT_OCCUPIED
Суть: SIP.TG не зміг знайти акаунт Telegram за переданим ідентифікатором (номер, user_id, username). Telegram може повернути таку відповідь, якщо:
- Номер дійсно не зареєстрований у Telegram.
- Username не існує або звільнений.
- Профіль недоступний через обмеження.
- Ваш акаунт шлюзу занадто часто виконує пошук за номером телефону.
- Переконатися, що ви використовуєте правильний ідентифікатор (якщо використовуєте телефон — це має бути реальний номер Telegram).
- Якщо виникає часто, перевірте, чи не помилилися у форматі. Можливо, краще використовувати внутрішній user_id.
405 REGISTER is required first
405 REGISTER is required first
Суть: Ви надсилаєте INVITE без попередньої реєстрації PBX→SIP.TG, тоді як Worker вимагає повноцінний REGISTER.Що робити:
- На стороні вашої АТС увімкнути режим «Registration» (зареєструвати транк PBX→SIP.TG). Докладніше див. Взаємодія з АТС.
408 Timeout of waiting RPC result
408 Timeout of waiting RPC result
Суть: Сервер Telegram не відповів вчасно, або запит SIP.TG завис при зверненні до Telegram. Це буває при перевантаженні або антиспам-фільтрі Telegram, коли є багато вихідних викликів за короткий час.Що робити:
- Знизити інтенсивність вихідних дзвінків.
- Зачекати і повторити спробу, якщо був тимчасовий збій.
470 Anonymous user
470 Anonymous user
Суть: SIP.TG намагається зателефонувати користувачу за його внутрішнім user_id, з яким немає явного підтвердженого контакту. Telegram відхиляє такі «анонімні» виклики.Що робити:
- Зазвичай потрібно або зателефонувати за підтвердженим номером чи username, або щоб користувач сам додав вас до контактів чи написав вам спочатку.
500 (інші)
500 (інші)
Суть: Будь-яка інша внутрішня помилка на стороні Telegram. Іноді так позначаються несподівані збої при обробці аудіоканалу, при внутрішньому перевантаженні тощо.Що робити:
- Перевірити стабільність мережі, повторити виклик.
- Якщо помилка з’являється регулярно на одному й тому ж номері, зверніться по допомогу. Докладніше див. Як отримати допомогу.
503 Account is not running
503 Account is not running
Суть: Worker-сервер SIP.TG отримав INVITE, але фактично немає активної сесії для потрібного акаунта. Тобто PBX могла надіслати INVITE, не дочекавшись відповіді на REGISTER.Що робити:
- Переконатися, що транк PBX→SIP.TG успішно зареєстрований і Worker бачить активний обліковий запис.
- Іноді допомагає перезавантажити транк на АТС. За потреби див. Взаємодія з АТС.
503 Session is not running
503 Session is not running
Суть: Сесія Telegram фактично відключена. Можливий випадок, коли в боті @siptg_bot сесія відображається, але реально вона не авторизована.Що робити:
- Перевірити статус сесії в
/gateway, за потреби заново авторизувати номер Telegram. - Якщо помилка виникає часто, спробуйте перемкнутися на інший Worker або перезавантажити акаунт.
503 Telegram storage is unavailable
503 Telegram storage is unavailable
503 Too Many Requests: retry after … / 503 PEER_FLOOD
503 Too Many Requests: retry after … / 503 PEER_FLOOD
Суть: Це захист від спаму Telegram, коли за короткий проміжок відбувається забагато вихідних дзвінків, особливо на незнайомі номери.Що робити:
- Знизити швидкість обдзвону (на стороні АТС або вашого скрипта).
- Використовувати кілька різних акаунтів Telegram, щоб розподілити навантаження.
- Дочекатися зазначеного часу «retry after N», потім повторити.
503 Worker is not ready
503 Worker is not ready
Суть: Worker нещодавно перезавантажений або оновлюється, і ще не завершив ініціалізацію. У результаті виклики відхиляються на рівні SIP.Що робити:
- Зачекати 1–2 хвилини і повторити виклик.
- Або в боті @siptg_bot оберіть інший Worker-сервер для вашого підключення.
Помилки при дзвінку Telegram → SIP
Тут розглядаються ситуації, коли реальний користувач намагається зателефонувати на акаунт Шлюзу з додатка Telegram, а Worker намагається перевести виклик у вашу АТС. Якщо АТС поверне помилку, або якщо помилка виникне на стороні SIP.TG, користувач може побачити помилку в чаті з акаунтом Шлюзу. У цьому розділі ми наводимо лише ті помилки, які можуть виникнути на стороні SIP.TG.482 Caller has active gateway accounts
482 Caller has active gateway accounts
Суть: На акаунті того, хто викликає, також активовано Шлюз SIP.TG. Сервіс блокує таку спробу (Telegram→SIP), щоб не виникало зациклення або непередбачених петель викликів.Що робити:
- Якщо дійсно потрібно приймати дзвінки від акаунта, який також є шлюзовим, краще використовуйте для нього інший режим (наприклад, Софтфон) або інший акаунт Telegram без Шлюзу.
503 SIP account is unavailable
503 SIP account is unavailable
503 Worker is unavailable
503 Worker is unavailable
Якщо жодне з перелічених рішень не допомагає, звертайтеся по допомогу. Докладніше див. Як отримати допомогу.