Skip to main content
PBX tizimlari bilan integratsiya SIP ulanishlari orqali amalga oshiriladi, ular PBX va SIP.TG tomonida birgalikda sozlanadi. SIP.TG tomonida SIP ulanishini yaratish uchun:
  1. @siptg_bot’ni ishga tushiring va /gateway bo‘limiga o‘ting.
  2. PBX’ga ulamoqchi bo‘lgan Telegram sessiyasini tanlang yoki “Ulanish” tugmasidan foydalanib yangisini yarating (batafsil ma’lumot uchun qarang: Sessiyani ulash bo‘yicha bosqichma-bosqich ko‘rsatma).
  3. Yangi SIP ulanishini yaratish uchun ulanish turiga mos keluvchi tugmalardan birini bosing: “🆕 PBX→SIP․TG”, “🆕 SIP․TG→PBX” yoki “🆕 IP⇿IP”.

​
PBX’ga SIP ulanishini sozlash

Aksariyat sozlamalar tugmalarda joriy qiymatlar sifatida ko‘rsatiladi. Ushbu sozlamalarni o‘zgartirish uchun tegishli tugmani bosib, bot so‘raganida yangi qiymatni kiritish kifoya. Biroq, ba’zi tugmalar boshqacha ishlaydi:
  • Worker: bosilganda mavjud Worker serverlar ro‘yxati paydo bo‘ladi. Ro‘yxatdan kerakli serverni tanlang, uning batafsil tavsifini ko‘ring va tayinlang.
  • Belgilovchi tugmalar, masalan, “DTMF kirish”, “DTMF chiqish”, “Qayta qo‘ng‘iroq”, “Liniyalar”, “Xabarlar bilan ishlash”, “Callback” va “Obunani ulashish”, o‘tish rejimida ishlaydi. Bir marta bosish opsiyani yoqadi yoki o‘chiradi.
  • Ulanish protokoli (UDP/TCP/TLS): har bir bosishda keyingi mavjud protokolga o‘tadi.
  • Hisobni ko‘rsatish va Parolni tiklash: PBX tomonida ko‘rsatilishi kerak bo‘lgan SIP.TG’ga ulanish parametrlarini ko‘rsatadi.
PBX yoki telefoniya provayderiga ulanadigan serverni tanlash imkonini beradi.3 turdagi serverlar mavjud:
Server turiTavsifBelgisi
SIP.TG’ning umumiy serverlariSIP.TG tomonidan qo‘llab-quvvatlanadigan asosiy serverlar✅
Boshqa foydalanuvchilarning umumiy serverlariBoshqa foydalanuvchilar tomonidan joylashtirilgan umumiy serverlar🌐
Xususiy serverlarFaqat sizning SIP hisoblaringiz uchun mavjud bo‘lgan serverlar🔑
Bepul obunada faqat ba’zi umumiy SIP.TG serverlari mavjud.
Kodeklarni tanlash ovoz aloqasining sifati va mosligiga ta’sir qiladi. Opus, alaw, mulaw, GSM va boshqa kodeklar qo‘llab-quvvatlanadi.
DTMF ovozli menyular bilan ishlash uchun kerak. Mavjud usullar: RFC2833 (tavsiya etiladi), INFO va inband.
PBX bilan moslik uchun raqam terish formatini belgilash imkonini beradi. Batafsil ma’lumot uchun qarang: Raqamlarni o‘zgartirish qoidalari.
Telegram → SIP qo‘ng‘irog‘ida SIP hisoblarini chaqirish tartibini belgilashga imkon beradi.Quyidagi qoidalar qo‘llaniladi:
  1. Bir xil ustuvorlikdagi hisoblar bir vaqtda chaqiriladi.
  2. Ustuvorlik qanchalik past bo‘lsa, SIP hisoblari shuncha erta chaqiriladi.
  3. Keyingi ustuvorlikka o‘tish oldingi ustuvorlikdagi barcha SIP hisoblariga muvaffaqiyatsiz terishdan so‘ng amalga oshiriladi.
Qo‘ng‘iroq paytida abonentning identifikatori (Caller ID) va ko‘rsatiladigan ismining (Caller Name) shakllantirish qoidalari, bu ikkala yo‘nalishga nisbatan qo‘llaniladi.Batafsil ma’lumot uchun qarang: Abonent identifikatorlari turlari.
Quyida har bir SIP ulanish turi uchun maxsus sozlamalar keltirilgan.

​
PBX → SIP.TG

Bu rejimda sizning PBX’ingiz SIP.TG’da SIP mijoz sifatida ro‘yxatdan o‘tadi. Siz botdan SIP login va parolni olasiz va ularni PBX’ingizda ko‘rsatasiz.
Bu eng oddiy ulanish usuli bo‘lib, ko‘pgina tizimlar uchun mos keladi (Asterisk, 3CX, FreePBX va boshqalar).

PBX→SIP.TG ulanish sozlamalari bilan skrinshot

Joriy SIP liniyasining login, parol va ulanish manzilini ko‘rsatadi, ularni PBX tomonida ro‘yxatdan o‘tkazish kerak.“Parolni tiklash” ushbu liniya uchun yangi SIP parolini oldindan yaratadi. Tiklashdan so‘ng uni PBX tomonida yangilash kerak bo‘ladi.
Ushbu hisobga ulanishga ruxsat berilgan IP manzillar va tarmoqlar ro‘yxati.

​
SIP.TG → PBX

Bu yerda SIP.TG Worker serveri sizning PBX’ingizda ro‘yxatdan o‘tadi. Botda siz PBX’ingizning parametrlarini kiritasiz: login, parol va manzil.
PBX’ingizda SIP.TG IP manzillarini oq ro‘yxatga qo‘shishni unutmang. Joriy ro‘yxat: files.sip.tg/fw.txt.

SIP.TG→PBX ulanish sozlamalari bilan skrinshot

PBX’ingizga ulanishni amalga oshirish uchun to‘ldirilishi kerak bo‘lgan asosiy ulanish parametrlari.“Proksi” faqat “Domen”dan farq qilsa to‘ldirilishi kerak.
Foydalanuvchi Telegram ilovasida 📞 qo‘ng‘iroq tugmasini hech qanday xabar yubormasdan bosganda — bu raqam PBX’ga yuboriladigan sukut bo‘yicha raqam sifatida ishlatiladi.

​
IP ⇿ IP

Ikkala tomon ham bir-birining IP manzilini biladi. Ro‘yxatdan o‘tish imkonsiz yoki kerak bo‘lmagan hollarda qo‘llaniladi (masalan, statik marshrutlash).
Tajribali foydalanuvchilar uchun mos. PBX tomonida marshrutlarni sozlashni talab qiladi.

IP⇿IP ulanish sozlamalari bilan skrinshot

Qarshi tomonning (sizning PBX’ingizning) IP manzili va porti.Ulanish o‘rnatilishi uchun PBX tomonida ham SIP.TG serverining aniq IP manzili bilan ulanish yaratilishi kerak. Buning uchun SIP ulanishiga tayinlangan Worker serverining IP manzili ishlatiladi.Ishlatilayotgan Worker serverining joriy IP manzili ushbu parametrni o‘zgartirishni so‘raganda xabarda ko‘rsatiladi.
Agar bir xil IP manzillar o‘rtasida bir nechta SIP ulanishlaridan foydalanmoqchi bo‘lsangiz, bu maydon ulanishni to‘g‘ri aniqlash uchun qo‘shimcha SIP sarlavhasini o‘rnatishga imkon beradi.Parametr {SIP maydon nomi}:{SIP maydon qiymati} juftligi sifatida, ikki nuqta : bilan ajratilgan holda kiritiladi.
Foydalanuvchi Telegram ilovasida 📞 qo‘ng‘iroq tugmasini hech qanday xabar yubormasdan bosganda — bu raqam PBX’ga yuboriladigan sukut bo‘yicha raqam sifatida ishlatiladi.

​
Abonent identifikatorlari turlari

Har bir Telegram foydalanuvchisi uchta turdagi identifikatorga ega bo‘lishi mumkin:
  • Telefon raqami, hisob ro‘yxatdan o‘tgan raqam. U har doim mavjud, lekin maxfiylik sozlamalari bo‘yicha odatda boshqa foydalanuvchilar uchun yashiriladi. Katta cheklovlar bilan telefon raqami orqali foydalanuvchi bilan aloqa o‘rnatish mumkin.
  • Foydalanuvchi nomi (Username) — bu noyob harfli nom. Sukut bo‘yicha u mavjud emas, ko‘plab foydalanuvchilar uni o‘rnatadi, lekin u bo‘lmasligi ham mumkin. Aksincha, foydalanuvchida bir nechta to‘plam Username bo‘lishi mumkin. Username orqali foydalanuvchi bilan aloqa o‘rnatish mumkin, cheklovlar telefon raqamiga nisbatan ancha yumshoqroq, lekin bulutli PBX’lar ko‘pincha raqamli bo‘lmagan identifikatorlarni qo‘llab-quvvatlamaydi.
  • User ID — ichki raqamli identifikator. Har doim mavjud, hech qachon o‘zgarmaydi, lekin faqat User ID orqali foydalanuvchi bilan aloqa o‘rnatib bo‘lmaydi — uni faqat boshqa usullar orqali aloqa o‘rnatilgandan so‘ng ishlatish mumkin.
Identifikator turiFormatAloqa imkoniyatiMajburiyO‘zgartiriladimiPBX qo‘llab-quvvatlashi
Telefon raqamiraqamlicheklanganhahaha
Usernameharflihayo‘qhacheklangan
User IDraqamliyo‘qhayo‘qha
Jadvaldan ko‘rinib turibdiki, har bir identifikator barcha stsenariylarda ishlatishga imkon bermaydigan jiddiy cheklovlarga ega. SIP.TG barcha identifikator turlarini va ularning kombinatsiyalarini qo‘llab-quvvatlaydi, shuningdek, ularning ishlatilish ustuvorligini ehtiyojlaringizga qarab sozlash imkonini beradi.

​
Telegram → PBX

Har bir SIP ulanishi uchun Telegram → PBX qo‘ng‘iroqlari uchun INVITE xabaridagi From maydonida uzatiladigan Caller ID’ni shakllantirish qoidalarini o‘rnatish mumkin. Caller ID’ni shakllantirish qoidalari bir nechta satrlardan iborat bo‘lib, har bir satrda bitta qoida beriladi. Har bir qoida {phone}, {username} va {userid} shablon parametrlari sifatida qabul qilinadigan shablon satridir. Yakuniy Caller ID’ni shakllantirishda qo‘ng‘iroq qiluvchi Telegram foydalanuvchisi haqidagi ma’lumotlarni o‘z ichiga olgan barcha shablon parametrlari bo‘lgan birinchi qoida ishlatiladi.
  • Misol 1
  • Misol 2
  • Misol 3
{phone}
{username}
0userid
Bunday Caller ID turli vaziyatlarda foydalanuvchida mavjud bo‘lgan identifikatorlarning uchala turini ham qabul qilishi mumkin:
  • Agar telefon raqami yashirilmagan bo‘lsa — u ishlatiladi.
  • Aks holda, agar Username o‘rnatilgan bo‘lsa — tizim uni tanlaydi.
  • Faqat eng istisno holatda 0 prefiksi bilan User ID ishlatiladi — bu belgi identifikator turini talqin qilishda noaniqlikni bartaraf qilishga yordam beradi.
Caller ID’dan tashqari, From maydoni qo‘ng‘iroq qiluvchining ismini (Caller Name) ham o‘z ichiga olishi mumkin, uni shakllantirishni xuddi shunday qoidalar yordamida boshqarish mumkin, lekin yuqorida sanab o‘tilgan parametrlardan tashqari yana ikkita parametr mavjud:
  • {name} — UTF-8 formatidagi ko‘rsatiladigan nom (PBX tomonida emojilar tufayli muammolar keltirib chiqarishi mumkin);
  • {name_ascii} — ASCII’ga aylantirilgan ko‘rsatiladigan nom (xavfsiz variant).
+{phone} ({name_ascii})
@{username} ({name_ascii})
{name_ascii}
Foydalanuvchida telefon raqami va Username mavjudligiga qarab quyidagilardan biri ishlatiladi:
  • yoki + prefiksi bilan telefon raqami, undan keyin qavs ichida yozilgan ko‘rsatiladigan nom,
  • yoki @ prefiksi bilan Username, undan keyin qavs ichida yozilgan ko‘rsatiladigan nom,
  • yoki eng ekstremal holatda — faqat ortiqcha belgilarsiz ko‘rsatiladigan nom.

​
PBX → Telegram

PBX tomonidan INVITE so‘rovi qabul qilinganda, chaqirilgan identifikator yuqorida tasvirlangan Caller ID parametri bilan to‘liq mos ravishda talqin qilinadi. Biroq, identifikator turini aniqlash va undagi prefikslar va ortiqcha belgilarni kesish algoritmi unchalik aniq ko‘rinmaydi.
Telegram → PBX qo‘ng‘iroqlari kabi, qoidalar ketma-ket tekshiriladi va tanlov birinchi qoida bilan to‘xtaydi, u o‘zgartirishlardan so‘ng berilgan mezonlarga javob beradi:
  1. Qoidadagi barcha shablon parametrlari ularning mos regulyar ifodalariga almashtiriladi:
    • {phone} → +?[1-9]\d*: 0 bilan boshlanmaydigan va ixtiyoriy ravishda + belgisi bilan boshlanishi mumkin bo‘lgan raqam;
    • {username} → @?[a-zA-Z]\w*: faqat harf bilan boshlanishi mumkin bo‘lgan harfli-raqamli satr va ixtiyoriy ravishda @ prefiksi bilan;
    • {userid} → [1-9]\d*: 0 bilan boshlanmaydigan va prefikslar bo‘lmagan raqam.
  2. 1-band natijasida olingan murakkab regulyar ifoda olinadi, unga INVITE URI’dan olingan identifikator mosligi tekshiriladi.
  3. Regulyar ifodaga mos kelish natijasida, garchi bu faqat nazariy ma’noda bo‘lsa ham, identifikatorda bir vaqtning o‘zida bir nechta identifikator turlari aniqlanishi mumkin. Bunday holda, berilgan tartibda birinchi qiymat tanlanadi: {userid}, {username}, {phone}.
Bu Caller ID shakllantirish qoidalarining ikki tomonlama bo‘lishini va qo‘ng‘iroqning ikkala yo‘nalishi uchun identifikator formatlarining izchilligini ta’minlaydi.

​
CRM bilan integratsiya

CRM bilan integratsiya odatda SIP.TG bilan to‘g‘ridan-to‘g‘ri emas, balki SIP.TG standart SIP-trunk sifatida ulanadigan PBX orqali amalga oshiriladi. CRM o‘zi PBX imkoniyatlari tufayli qo‘ng‘iroqlar va kontaktlarni “ko‘radi”. CRM’da SIP.TG uchun alohida modullar yoki plaginlar o‘rnatish odatda talab qilinmaydi.
Ko‘pincha o‘zaro ta’sir quyidagicha tashkil etiladi:
  1. Telegram qo‘ng‘irog‘i SIP.TG Shlyuziga (Telegram hisobiga) keladi.
  2. SIP.TG Shlyuzi qo‘ng‘iroqni SIP’ga aylantiradi va uni PBX’ga uzatadi (SIP-trunk orqali).
  3. PBX, CRM integratsiyasi uchun kerakli modul yoki plagin’ga ega bo‘lib, kiruvchi qo‘ng‘iroqni aniqlaydi, mijoz kartasini ko‘rsatadi, qo‘ng‘iroqni ro‘yxatga oladi yoki boshqa harakatlarni bajaradi.
  4. Suhbat tugagandan so‘ng, qo‘ng‘iroq haqidagi ma’lumotlar (masalan, davomiyligi, natijasi) ham CRM’da saqlanadi.
Deyarli har qanday zamonaviy PBX kiruvchi yoki chiquvchi qo‘ng‘iroq paytida SIP sarlavhalaridan (CallerID, From va hokazo) foydalanib, ma’lumotlarni CRM moduliga “uzatishi” mumkin. Telegram’dan SIP.TG Shlyuzi orqali SIP-trunk’ga qo‘ng‘iroq qilganda, qo‘ng‘iroq qiluvchining identifikatori uzatiladi (ko‘pincha Telegram ID yoki username sifatida ko‘rsatiladi), va PBX’dagi mantiq ushbu identifikatorni CRM yozuvlari bilan moslashtiradi.Agar sizning PBX’ingiz chiquvchi qo‘ng‘iroqlar uchun CallerID’ni boshqarishi mumkin bo‘lsa (masalan, kerakli raqamni “qadoqlaydi”), CRM avtomatik ravishda haqiqiy telefon raqamini ham, Telegram kontaktlarini ham kartaga yozib olishi mumkin. Ammo har bir CRM va PBX uchun ko‘p tafsilotlar mavjud; umuman olganda, bu SIP.TG tomonidan to‘g‘ridan-to‘g‘ri tartibga solinmaydi.
Agar CRM qo‘ng‘iroqni boshlashni “bilsa” (masalan, raqamni bosib qo‘ng‘iroq qilish), u odatda buni PBX orqali amalga oshiradi, u yerga Call API yoki AMI buyrug‘ini yuboradi (Asterisk, 3CX va hokazo). Keyin PBX so‘rovni SIP.TG SIP-trunk’iga tarjima qiladi, va Shlyuz Telegram’ga qo‘ng‘iroq qiladi. Bularning barchasi “CRM → PBX → SIP-trunk” standart o‘zaro ta’siri bo‘lib, bu yerda SIP.TG Telegram uchun aloqa operatori rolini bajaradi.
  1. PBX’da @siptg_bot’da /gateway sozlamasida berilgan ma’lumotlar bilan hisob (SIP-trunk) yarating.
  2. CRM’da tayyor plagin yoki modulni faollashtiring (Asterisk, 3CX, FreePBX, Yate va hokazo uchun) yoki PBX API’si orqali tashqi so‘rovlarni sozlang.
  3. CRM qo‘ng‘iroqlar haqidagi voqealarni qabul qilishini tekshiring (karta ochiladi, loglar yoziladi) va agar kerak bo‘lsa, chuqurroq mantiqni ulang (qo‘ng‘iroqlarni taqsimlash, suhbat yozuvlarini bog‘lash, avtomatlashtirish).
  4. CRM’dan chiquvchi qo‘ng‘iroqlar uchun — PBX “SIP.TG” SIP-trunk’i orqali qo‘ng‘iroq shakllantirishi mumkinligini tekshiring (odatda bunday liniya uchun marshrut yoki terish qoidasi tanlanadi).

​
Qo‘shimcha sozlash zarur bo‘lganda

1

Kengaytirilgan SIP sarlavha maydonlari

Agar sizning CRM’ingiz ba’zi maxsus sarlavhalarni shakllantirsa yoki kutilsa (masalan, X-CRM-ID), bunday vaziyatlar PBX’ingiz vositalari bilan hal qilinadi (Asterisk’dagi AGI skriptlari, 3CX’dagi maxsus sozlamalar va hokazo). SIP.TG tomonida ixtiyoriy SIP sarlavhalariga to‘g‘ridan-to‘g‘ri ta’sir qilish imkoni yo‘q.
2

Yo‘naltiriladigan CallerID kerak bo‘lsa

Ba’zi hollarda CRM to‘liq asl qo‘ng‘iroq raqamini ko‘rishi kerak (masalan, muayyan mijozga “bog‘lash” uchun). Agar qo‘ng‘iroq Telegram’dan bo‘lsa, raqam har qanday bo‘lishi mumkin (yoki umuman bo‘lmasligi mumkin), va bu yerda CallerID’ni qanday qadoqlash PBX’ingiz mantig‘iga bog‘liq. Ba’zida “Telegram ID → mijoz telefoni” mosligining qo‘shimcha ma’lumotlar bazasi qo‘shiladi.
3

CRM’da qo‘ng‘iroqlarni yozib olishni yoqish

Qo‘ng‘iroqlarni yozib olish PBX’ning o‘zida yoki SIP.TG tomonida “Qo‘ng‘iroqlarni yozib olish” rejimida (Softfon’da) yoqilishi mumkin. Agar yozuvlarni aynan CRM’da saqlamoqchi bo‘lsangiz, PBX’ingiz yozuv fayllarini u yerga uzatishi mumkinligini tekshiring. SIP.TG nuqtai nazaridan, bu SIP orqali ovozning “shaffof” uzatilishi bo‘lib, yozish uchun qo‘shimcha sozlamalar yo‘q.

​
Qo‘shimcha maslahatlar

  • Yagona yondashuv: CRM bilan bog‘liq barcha sozlamalar odatda PBX interfeysida amalga oshiriladi. Siz SIP.TG’ni oddiy aloqa operatori (SIP-trunk) sifatida qabul qilasiz.
  • Odatdagi PBX’lar (Asterisk, 3CX, FreeSWITCH, Yate, Oktell, Panasonic va boshqalar) CRM integratsiyasi uchun plaginlar yoki REST interfeyslariga ega. PBX hujjatlarini o‘rganing: ehtimol, u yerda tayyor misol bor.
  • Qo‘ng‘iroqlarni qabul qilish va yo‘naltirish stsenariylari (IVR, operatorlar navbati, avtomatik yo‘naltirish) — bularning barchasi PBX’ning umumiy funksiyalari. SIP.TG Shlyuzi bunday stsenariylarni cheklamaydi yoki murakkablashtirmaydi: ular boshqa SIP-trunk’lar bilan bir xil ishlaydi.
Murakkablashtirmang. CRM’ni Telegram qo‘ng‘iroqlari bilan “do‘stlashtirish” uchun SIP.TG Shlyuzini PBX’ingizga ulash va PBX’da mavjud bo‘lgan standart CRM integratsiya vositalaridan foydalanish kifoya.Agar muammolar yoki xatolar yuzaga kelsa, Muammolarni bartaraf qilish bo‘limidan foydalaning.
⌘I