PBX bilan ishlash
PBX tizimlari bilan integratsiya SIP ulanishlari orqali amalga oshiriladi, ular PBX va SIP.TG tomonida birgalikda sozlanadi.
SIP.TG tomonida SIP ulanishini yaratish uchun:
- @siptg_bot’ni ishga tushiring va
/gateway
bo‘limiga o‘ting. - 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).
- 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.
Worker serveri
Worker serveri
PBX yoki telefoniya provayderiga ulanadigan serverni tanlash imkonini beradi.
3 turdagi serverlar mavjud:
Server turi | Tavsif | Belgisi |
---|---|---|
SIP.TG’ning umumiy serverlari | SIP.TG tomonidan qo‘llab-quvvatlanadigan asosiy serverlar | ✅ |
Boshqa foydalanuvchilarning umumiy serverlari | Boshqa foydalanuvchilar tomonidan joylashtirilgan umumiy serverlar | 🌐 |
Xususiy serverlar | Faqat sizning SIP hisoblaringiz uchun mavjud bo‘lgan serverlar | 🔑 |
Bepul obunada faqat ba’zi umumiy SIP.TG serverlari mavjud.
Audio kodeklar
Audio kodeklar
Kodeklarni tanlash ovoz aloqasining sifati va mosligiga ta’sir qiladi. Opus, alaw, mulaw, GSM va boshqa kodeklar qo‘llab-quvvatlanadi.
DTMF uzatish usullari
DTMF uzatish usullari
DTMF ovozli menyular bilan ishlash uchun kerak. Mavjud usullar: RFC2833 (tavsiya etiladi), INFO va inband.
Raqamlarni o‘zgartirish qoidalari
Raqamlarni o‘zgartirish qoidalari
PBX bilan moslik uchun raqam terish formatini belgilash imkonini beradi. Batafsil ma’lumot uchun qarang: Raqamlarni o‘zgartirish qoidalari.
Ustuvorlik
Ustuvorlik
Telegram → SIP qo‘ng‘irog‘ida SIP hisoblarini chaqirish tartibini belgilashga imkon beradi.
Quyidagi qoidalar qo‘llaniladi:
- Bir xil ustuvorlikdagi hisoblar bir vaqtda chaqiriladi.
- Ustuvorlik qanchalik past bo‘lsa, SIP hisoblari shuncha erta chaqiriladi.
- Keyingi ustuvorlikka o‘tish oldingi ustuvorlikdagi barcha SIP hisoblariga muvaffaqiyatsiz terishdan so‘ng amalga oshiriladi.
Caller ID va Caller Name
Caller ID va Caller Name
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
Hisobni ko‘rsatish va Parolni tiklash
Hisobni ko‘rsatish va Parolni tiklash
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.
Ishonchli IP’lar
Ishonchli IP’lar
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
Login, Parol, Domen va Proksi
Login, Parol, Domen va Proksi
PBX’ingizga ulanishni amalga oshirish uchun to‘ldirilishi kerak bo‘lgan asosiy ulanish parametrlari.
“Proksi” faqat “Domen”dan farq qilsa to‘ldirilishi kerak.
PBX’dagi raqam
PBX’dagi raqam
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
Manzil:port
Manzil:port
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.
Maydon:Qiymat
Maydon:Qiymat
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.
PBX’dagi raqam
PBX’dagi raqam
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 turi | Format | Aloqa imkoniyati | Majburiy | O‘zgartiriladimi | PBX qo‘llab-quvvatlashi |
---|---|---|---|---|---|
Telefon raqami | raqamli | cheklangan | ha | ha | ha |
Username | harfli | ha | yo‘q | ha | cheklangan |
User ID | raqamli | yo‘q | ha | yo‘q | ha |
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.
Caller ID shakllantirish misollari
Caller ID shakllantirish misollari
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.
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.
Bu yerda xatti-harakat Misol 1’ga o‘xshaydi, farqi shundaki, agar foydalanuvchida na telefon raqami, na Username bo‘lmasa, bunday qo‘ng‘iroq taqiqlanadi va PBX’ga yetib bormaydi.
Bu misol avvalgi ikkitadan farq qiladi, chunki agar foydalanuvchida telefon raqami va Username bo‘lmasa, qo‘ng‘iroq baribir PBX’ga yetib boradi, lekin anonymous
raqami bilan.
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).
Caller Name shakllantirish misoli
Caller Name shakllantirish misoli
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.
Qoidalarni qayta ishlashning batafsil algoritmi
Qoidalarni qayta ishlashning batafsil algoritmi
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:
- 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.
- 1-band natijasida olingan murakkab regulyar ifoda olinadi, unga INVITE URI’dan olingan identifikator mosligi tekshiriladi.
- 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:
- Telegram qo‘ng‘irog‘i SIP.TG Shlyuziga (Telegram hisobiga) keladi.
- SIP.TG Shlyuzi qo‘ng‘iroqni SIP’ga aylantiradi va uni PBX’ga uzatadi (SIP-trunk orqali).
- 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.
- Suhbat tugagandan so‘ng, qo‘ng‘iroq haqidagi ma’lumotlar (masalan, davomiyligi, natijasi) ham CRM’da saqlanadi.
PBX mijoz raqamini qanday biladi?
PBX mijoz raqamini qanday biladi?
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.
CRM’dan qo‘ng‘iroqni qanday boshlash mumkin?
CRM’dan qo‘ng‘iroqni qanday boshlash mumkin?
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.
Sozlash misoli
Sozlash misoli
- PBX’da @siptg_bot’da
/gateway
sozlamasida berilgan ma’lumotlar bilan hisob (SIP-trunk) yarating. - CRM’da tayyor plagin yoki modulni faollashtiring (Asterisk, 3CX, FreePBX, Yate va hokazo uchun) yoki PBX API’si orqali tashqi so‘rovlarni sozlang.
- 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).
- 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
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.
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.
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.