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.

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

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

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

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.

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).

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.

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.

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.