Integratsiyalar va kanallar
Integratsiya — OneTrace.pro ni tashqi xizmatga ulash: pochta serveri, SMS shlyuzi, messenjerdagi bot, reklama kabineti yoki fayllar xotirasi. Ulangan kanallar orqali zanjirlar va kampaniyalar, platformalar orqali — auditoriyalarni eksport qilish va reklama konversiyalari, manbalar orqali esa muntazam maʼlumotlar importi ishlaydi.
Boʻlim Kommunikatsiyalar → Integratsiyalar menyusida ochiladi.

Ulangan integratsiyalar turlar boʻyicha guruhlangan. Turlar bir nechta boʻlsa, kartalar ustida hisoblagichli filtr paydo boʻladi: Hammasi, Kanallar, CRM va hokazo.
Nimalarni ulash mumkin
Yangi integratsiya Integratsiya qoʻshish tugmasi orqali ulanadi: oynada xizmatlar turlar boʻyicha ajratilgan, qidiruv esa xizmatni nomi boʻyicha topadi. Sahifadagi guruh sarlavhasi yonidagi + tugmasi oynani darhol shu turda ochadi.
Kanallar — ular orqali xabarlar yuboriladi:
| Kanal | Qanday ishlaydi |
|---|---|
| Platforma pochta xizmati — Yuborish domenlari boʻlimida ulangan domeningizdan yuborish: DKIM imzosi, qaytishlar, shikoyatlar va toʻxtatish roʻyxati avtomatik ishlaydi; yoki Oʻz SMTP serveringiz: manzil, port, shifrlash, login va parol. Ikkala holatda ham yuboruvchining manzili va ismi koʻrsatiladi, ochilishlar va oʻtishlarni kuzatishni yoqish mumkin. Oʻz SMTP serveringiz uchun yetkazilmagan xatlar manzilni avtomatik obunadan chiqarishi uchun qaytishlar domeni va qutisini koʻrsatish mumkin. Mijozlarning qoʻllab-quvvatlash manziliga yozgan xatlarini onlayn chatga qabul qilish mumkin, qarang: Chatdagi kiruvchi xatlar | |
| SMS | tanlov boʻyicha provayder: SMS.ru, SMSC.ru, Twilio yoki shlyuzning oʻz HTTP API si. Yetkazish holatlari integratsiyada koʻrsatilgan manzilga keladi |
| Telegram | BotFather da yaratilgan bot: token yetarli, kiruvchi xabarlar uchun manzilni bot oʻzi oladi |
| Viber (tarqatmalar) | agregator orqali telefon raqami boʻyicha xabarlar: SMSC.ru, Infobip yoki oʻz HTTP API ingiz |
| Viber boti | hamkor kabinetidagi token boʻyicha Viber boti, yangi obunachilar uchun salomlashish bilan |
| MAX boti | business.max.ru dagi token boʻyicha MAX messenjeri boti, salomlashish va «Raqamni ulashish» tugmasi bilan, qarang: MAX boti |
| VK hamjamiyati | kirish kaliti orqali hamjamiyat nomidan xabarlar, «Oʻsish» tarifidan boshlab, qarang: VK hamjamiyati |
| Instagram Direct | Meta dagi ilovangiz orqali Instagram biznes akkauntidan xabarlar, «Oʻsish» tarifidan boshlab, qarang: Instagram Direct |
| Facebook Messenger | Meta dagi ilovangiz orqali Facebook sahifasidan xabarlar, «Oʻsish» tarifidan boshlab, qarang: Facebook Messenger |
| WhatsApp Business Cloud API: raqam ID si, akkaunt ID si, Meta ilovasining tokeni va maxfiy kaliti | |
| Web Push | brauzerdagi bildirishnomalar; kalitlar avtomatik yaratiladi, obunalarni saytdagi kod yigʻadi, qarang: Saytni ulash |
| Mobil push | Android va iOS ilovasidagi bildirishnomalar: Firebase paketi va xizmat hisobi, bundle id va APNs kaliti, qarang: Mobil ilovalar |
| Ilova ichidagi xabarlar | ochiq ilova ichidagi oyna, banner yoki toʻliq ekran; «Oʻsish» tarifidan boshlab, qarang: Mobil ilovalar |
| Wallet kartalari | Apple Wallet va Google Wallet uchun sodiqlik kartasi: Apple Pass Type ID sertifikati, Google Issuer ID va xizmat akkaunti; «Oʻsish» tarifidan boshlab, qarang: Wallet kartalari |
| Webhook | xabar maʼlumotlari bilan serveringizga soʻrov, masalan, oʻz bildirishnomalar tizimingiz uchun |
Auditoriyalarni eksport qilish — Webhook, S3 (CSV), Meta Custom Audience, Yandex Auditoriyalar, VK Reklama va Google Ads Customer Match.
Reklama konversiyalari — Meta Conversions API, Yandex Metrica va Google Ads oflayn konversiyalari, VK Reklama oflayn hodisalari, qarang: Reklama konversiyalari.
Maʼlumot manbalari — havola orqali fayl, S3 dagi fayl va Google Sheets jadvali.
Maʼlumotlar omborlari — loyiha maʼlumotlarini eksport qilish uchun S3 (NDJSON), Google Cloud Storage, BigQuery, Snowflake, ClickHouse va PostgreSQL. Guruh «Korporativ» tarifida koʻrinadi.
CRM — amoCRM, Kommo, Bitrix24, HubSpot, Pipedrive, Zoho CRM, Odoo, Salesforce va Microsoft Dynamics 365: kontaktlar, lidlar va bitimlar profillar va hodisalarda, bitimlar va vazifalar uchun zanjir tugunlari, segmentlarni CRM ga qaytarib eksport qilish, qarang: CRM. Guruh «Oʻsish» tarifidan koʻrinadi.
Bir turdagi bir nechta integratsiyani ulash mumkin: masalan, marketing va tranzaksion xatlar uchun ikkita SMTP server. Shablonlar, zanjirlar va kampaniyalarda qaysi integratsiya orqali yuborishni tanlaysiz.
Integratsiyani qanday ulash kerak
- Integratsiya qoʻshish tugmasini bosing va xizmatni tanlang, masalan, Email. Oynaning chap tomonida — izohli integratsiya turlari, yuqorida — nomi boʻyicha qidiruv.
- Nomini belgilang — uni shablonlar, zanjirlar va eksportlarda koʻrasiz, masalan, «Marketing pochtasi».
- Sozlamalarni toʻldiring. Maydonlar ostidagi maslahatlar token yoki kalitni xizmat kabinetining qayeridan olish kerakligini tushuntiradi.
- Saqlash tugmasini bosing. Boshqa xizmatni tanlash uchun Orqaga tugmasini bosing.
- Integratsiya kartasida Tekshirish tugmasini bosing.


Baʼzi xizmatlar uchun saqlangandan soʻng sozlamalarda xizmat maydonlari paydo boʻladi — masalan, WhatsApp da Webhook manzili va Tekshiruv tokeni yoki SMS da Yetkazish holatlari uchun manzil. Ularni xizmat kabinetiga nusxalang, aks holda yetkazish holatlari va kiruvchi xabarlar kelmaydi.
Telegram, Viber boti, MAX boti va WhatsApp kiruvchi xabarlarni OneTrace.pro oʻrnatmangiz manzili orqali oladi: u internetdan HTTPS orqali ochiq boʻlishi kerak.
MAX boti
- business.max.ru da bot yarating — botni Rossiya yuridik shaxsi, YaTT yoki oʻzini oʻzi band qilgan shaxs joylashtirishi mumkin — va tokenni nusxalang: «Чат-боты» → ⋮ → «Настройки».
- Integratsiya qoʻshish tugmasini bosing, MAX botini tanlang, Bot tokenini qoʻying va saqlang. Kiruvchi xabarlar uchun manzilni bot oʻzi oladi, uning nomi esa sozlamalarda paydo boʻladi.
- Xohlasangiz, Salomlashuv va «Raqamni ulashish» tugmasi matnini belgilang: xaridor botni ishga tushirganda bot ularni yuboradi.

Bot faqat uni ishga tushirganlarga yoza oladi. Xaridor profil bilan ikki usulda bogʻlanadi:
- havola orqali — serveringiz tizimga kirgan xaridor uchun
https://max.ru/{bot}?start=…havolasini yaratadi (POST /api/v1/max/link, Telegram dagi kabi), xaridor esa botni shu havola orqali ochadi; - raqam orqali — xaridor salomlashuvdagi «Raqamni ulashish» tugmasini bosadi. Agar MAX raqam uning akkauntiga tegishli ekanini tasdiqlagan boʻlsa, bot shu telefonli profilga bogʻlanadi. Boshqa birovning uzatilgan kontakt kartasi bogʻlanmaydi.
Botni ishga tushirish — kanalga obuna, botni toʻxtatish yoki suhbatni oʻchirish — obunani bekor qilish. Xaridorlarning botga yozgan xabarlari max.message hodisasiga va «Oʻsish» tarifidan boshlab onlayn chat suhbatlariga aylanadi. MAX da yetkazish hisobotlari yoʻq: qabul qilingan xabar yetkazilgan hisoblanadi. MAX qoidalari xizmat xabarlarida reklamani taqiqlaydi.
VK hamjamiyati
- Hamjamiyatda Manage community → Messages boʻlimini oching va hamjamiyat xabarlarini yoqing.
- Manage community → API usage → Access tokens boʻlimida «Create token» tugmasini bosing va «Community management», «Community messages», «Photos» huquqlarini, agar qoidalar izohlarga javob beradigan boʻlsa, «Wall» huquqini ham belgilang.
- Integratsiya qoʻshish tugmasini bosing, VK hamjamiyatini tanlang, Hamjamiyat kirish kalitini qoʻying va saqlang. OneTrace.pro kalit huquqlarini tekshiradi, Callback API serverini hamjamiyat sozlamalariga oʻzi qoʻshadi hamda hamjamiyat nomi va manzilini koʻrsatadi.
- Xohlasangiz, Salomlashuvni belgilang: uni hamjamiyat xabarlariga ruxsat bergan odam oladi.

Hamjamiyat faqat xabarlarga ruxsat berganlarga yoza oladi: oʻzi yozgan, «Allow messages» tugmasini bosgan yoki vk.me havolasi orqali oʻtganlarga. Bu kanalga obuna hisoblanadi, xabarlarni taqiqlash esa — obunani bekor qilish. Serveringiz odamni xaridor profili bilan bogʻlashi mumkin: POST /api/v1/vk/link tizimga kirgan xaridor uchun https://vk.me/{community}?ref=… havolasini yaratadi, xuddi shu belgini esa «Allow messages» vidjetiga kalit sifatida uzatish mumkin.
Xabarda matn, rasm va havola-tugmalarni yuborish mumkin. VK rasmni havola orqali qabul qilmaydi: OneTrace.pro faylni har bir kampaniya uchun bir marta oʻzi yuklaydi. Odamlarning xabarlari vk.message hodisasiga va onlayn chat suhbatlariga, postlarga izohlar esa kalit soʻz qoidalari uchun sababga aylanadi. Integratsiya oʻchirilganda Callback API serveri ham hamjamiyat sozlamalaridan olib tashlanadi.
Instagram Direct
Instagram Meta dagi ilovangiz orqali ulanadi: oʻz akkauntingiz uchun ilovani Meta tekshiruvidan oʻtkazish shart emas.
- Meta for Developers da ilova yarating, Instagram mahsulotini qoʻshing va Instagram orqali kirish bilan API sozlamasi boʻlimida biznes akkauntni ulang.
- «Kirish tokenlarini yaratish» tugmasini bosing va tokenni nusxalang.
instagram_business_basic,instagram_business_manage_messageshuquqlari va izohlarga javob uchuninstagram_business_manage_commentskerak. Shu yerda Instagram ilovasining maxfiy kalitini ham nusxalang. - Integratsiya qoʻshish tugmasini bosing, Instagram Directni tanlang, token va maxfiy kalitni qoʻying va saqlang. Sozlamalarda Vebhuk manzili va Tasdiqlash tokeni paydo boʻladi.
- Manzil va tokenni ilovaning vebhuk sozlamalarida (Instagram boʻlimi) koʻrsating. Akkauntni hodisalarga OneTrace.pro oʻzi obuna qila oladi.

Token 60 kun amal qiladi, OneTrace.pro uni oʻzi uzaytiradi. Uzaytirib boʻlmasa, xato integratsiya kartasida paydo boʻladi: eskisining muddati tugashidan oldin yangi token yarating va integratsiyani saqlang.
Instagram odamga faqat uning xabaridan keyin 24 soat ichida yozishga ruxsat beradi. Kampaniyalar va zanjirlar avvalroq yozganlarni oʻtkazib yuboradi — xabar yuborilmaydi, obuna saqlanib qoladi. Agar ilovada Human Agent huquqi boʻlsa va integratsiyada Operator javoblari 7 kungacha yoqilgan boʻlsa, chat operatori keyinroq ham, 7 kungacha javob bera oladi.
Odamning birinchi xabari — kanalga obuna, «stop» — obunani bekor qilish. Profil bilan bogʻlash uchun belgili yozishma havolasini POST /api/v1/instagram/link yaratadi: https://ig.me/m/{account}?ref=…. Xabarlar va hikoyalarga javoblar instagram.message hodisasiga va onlayn chat suhbatlariga, izohlar esa kalit soʻz qoidalari uchun sababga aylanadi.
Facebook Messenger
Messenger xuddi Instagram kabi Meta dagi ilovangiz orqali ulanadi: oʻz sahifangiz uchun ilovani Meta tekshiruvidan oʻtkazish shart emas.
- Meta for Developers da ilova yarating va Messenger mahsulotini qoʻshing.
- Messenger → API sozlamalari boʻlimida Facebook sahifasini ulang va
pages_messaginghuquqi bilan sahifa tokenini yarating. Muddatsiz token kerak: OneTrace.pro uni uzaytirmaydi. Ilova sozlamalari → Asosiy boʻlimida ilova sirini nusxalang. - Integratsiya qoʻshish tugmasini bosing, Facebook Messengerni tanlang, token va sirni qoʻying va saqlang. OneTrace.pro sahifani topadi, uni xabarlarga obuna qiladi hamda Vebhuk manzili va Tasdiqlash tokenini koʻrsatadi.
- Manzil va tokenni ilovaning vebhuk sozlamalarida (Messenger boʻlimi) koʻrsating.
Messenger ham Instagram kabi odamga faqat uning xabaridan keyin 24 soat ichida yozishga ruxsat beradi: kampaniyalar va zanjirlar avvalroq yozganlarni oʻtkazib yuboradi. Agar ilovada Human Agent huquqi boʻlsa va integratsiyada Operator javoblari 7 kungacha yoqilgan boʻlsa, chat operatori 7 kungacha javob bera oladi.
Odamning birinchi xabari — kanalga obuna va integratsiya sozlamalaridagi Salomlashish, «stop» — obunani bekor qilish. Odam profilida facebook_psid identifikatori — aynan sizning sahifangiz bilan yozishma raqami — va, agar sahifa uni koʻrsa, Facebookdagi ismi paydo boʻladi. Xabarlar, fotolar va fayllar messenger.message hodisasiga va onlayn chat suhbatlariga aylanadi. Operatorning tezkor javob tugmalari Messengerga haqiqiy tugmalar boʻlib boradi.
Chatdagi kiruvchi xatlar
Email integratsiyasidagi Chatdagi kiruvchi xatlar guruhi mijozlarning qoʻllab-quvvatlash manziliga yozgan xatlarini onlayn chatga qabul qiladi. Operator javobi xuddi shu integratsiya orqali oʻsha yozishmaga yuboriladi. Usullar:
- IMAP qutisi — qoʻllab-quvvatlash qutisining serveri, porti, shifrlash, login, parol va jildi. Yangi xatlar daqiqada bir marta oʻqiladi va oʻqilgan deb belgilanadi.
- Vebhuk — saqlangandan keyin token bilan Vebhuk manzili paydo boʻladi. Uni pochta xizmatida kiruvchi xatlar manzili sifatida koʻrsating. Mos keladi: Postmark — Inbound webhook, SendGrid — «POST the raw, full MIME message» bilan yoki usiz Inbound Parse, Mailgun — forward amali bilan Routes, Cloudflare Email Workers — xatni toʻliq yuborish orqali. Manzildagi token maxfiy: manzilni eʼlon qilmang. Agar manzil begonalarga tushgan boʻlishi mumkin boʻlsa, Vebhuk manzilini oʻzgartirishni belgilang va saqlang: yangi manzil paydo boʻladi, eskisi xatlarni qabul qilmay qoʻyadi. Manzilni faqat integratsiyani boshqara oladiganlar koʻradi.
Qoʻllab-quvvatlash manzili ikkala usul uchun ham majburiy: mijozlar unga yozadi, u operatorlar xatlarida javob manzili ham boʻladi.
Tekshirish va holatlar
Tekshirish tugmasi xizmatga ulanadi va natijani koʻrsatadi: tafsilotlar bilan «Ulanish ishlayapti» (bot nomi, SMS provayderdagi balans, mavjud bakket) yoki xato matni bilan «Tekshiruvdan oʻtmadi». Oxirgi tekshiruv vaqti kartada koʻrsatiladi.
| Holat | Nimani anglatadi |
|---|---|
| Ishlayapti | ulanish joyida |
| Xato | oxirgi tekshiruv yoki sozlash muvaffaqiyatsiz boʻldi; xato matni — kartada. Sozlamalarni tuzating va yana tekshiring |
| Oʻchiq | integratsiya sozlamalaridagi Yoqilgan almashtirgichi bilan oʻchirilgan; xabarlar u orqali yuborilmaydi |
Oʻz HTTP API ingiz orqali SMS tekshiruvi faqat shlyuz manzili mavjudligiga ishonch hosil qiladi: haqiqiy SMS pullik, shuning uchun yuborishni shablondagi test xabari bilan tekshiring.
Oʻzgartirish va oʻchirish
- Tahrirlash sozlamalarni ochadi. Parollar, tokenlar va kalitlar saqlangandan keyin koʻrsatilmaydi: avvalgi qiymatni saqlab qolish uchun bunday maydonni boʻsh qoldiring.
- Yuborishni vaqtincha toʻxtatish uchun Yoqilgan almashtirgichini oʻchiring — sozlamalar saqlanib qoladi.
- Integratsiyani oʻchirish — xabarlar u orqali endi yuborilmaydi, ushbu ulanishdan foydalanadigan eksportlar va manbalar esa xato bilan toʻxtaydi. Telegram, Viber va MAX botlari hamda SMS.ru uchun platforma oʻz webhookini oʻzi olib tashlaydi. Xizmat mavjud boʻlmasa, ogohlantirish chiqadi — webhookni bot sozlamalarida yoki xizmatning shaxsiy kabinetida qoʻlda olib tashlang.
Integratsiyalarni kim boshqara oladi
| Amal | Rollar |
|---|---|
| Integratsiyalarni koʻrish | «Egasi», «Administrator», «Menejer» |
| Ulash, oʻzgartirish, tekshirish va oʻchirish | «Egasi», «Administrator» |
Aʼzoning rolini alohida integratsiyalar bilan cheklash mumkin, qarang: Aʼzolar va rollar. Bunday aʼzo boʻlimda faqat oʻz integratsiyalarini koʻradi va rol ruxsat bersa, faqat ularni boshqaradi. U yangi integratsiyani ulay olmaydi: buning uchun butun loyihaga ruxsat kerak. Shablonlar va zanjirlar muharrirlarida u avvalgidek loyihadagi barcha ulangan integratsiyalar orasidan tanlaydi.
Nimalarni bilish muhim
- Kanallar obunalar va chastotani oʻzi tekshirmaydi: bu qoidalar barcha kanallar uchun umumiy va Xabar yuborish qoidalari sahifasida belgilanadi.
- Oʻsha yerda keraksiz kengaytmani, masalan, WhatsApp ni oʻchirish mumkin. Oʻchirilgan kengaytma loyihaning integratsiyalari, shablonlari va zanjirlaridan yoʻqoladi.
- WhatsApp da birinchi xabar va ommaviy xabarlar faqat Meta tomonidan tasdiqlangan shablonlar bilan mumkin; erkin matn — mijoz xabaridan keyin 24 soat davomida. Meta shablonlari, mahsulot karusellari va WhatsApp shakllari haqida WhatsAppda xaridlar maqolasida oʻqing.
- Platforma pochta xizmatida DKIM, SPF va qaytishlar yozuvlarini domenni ulashda bir marta qoʻshasiz — qarang: Yuborish domenlari. Oʻz SMTP serveringiz uchun SPF, DKIM va DMARC server tomonida va domeningizda sozlanadi.