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