OneTrace.pro Yordam markazi

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 kanallar bilan «Integratsiyalar» sahifasi

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
Email 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 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

  1. Integratsiya qoʻshish tugmasini bosing va xizmatni tanlang, masalan, Email. Oynaning chap tomonida — izohli integratsiya turlari, yuqorida — nomi boʻyicha qidiruv.
  2. Nomini belgilang — uni shablonlar, zanjirlar va eksportlarda koʻrasiz, masalan, «Marketing pochtasi».
  3. Sozlamalarni toʻldiring. Maydonlar ostidagi maslahatlar token yoki kalitni xizmat kabinetining qayeridan olish kerakligini tushuntiradi.
  4. Saqlash tugmasini bosing. Boshqa xizmatni tanlash uchun Orqaga tugmasini bosing.
  5. Integratsiya kartasida Tekshirish tugmasini bosing.

«Yangi integratsiya» oynasi: integratsiya turlari, qidiruv va xizmatlar

Email integratsiyasini ulash oynasi

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

  1. business.max.ru da bot yarating — botni Rossiya yuridik shaxsi, YaTT yoki oʻzini oʻzi band qilgan shaxs joylashtirishi mumkin — va tokenni nusxalang: «Чат-боты» → ⋮ → «Настройки».
  2. 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.
  3. Xohlasangiz, Salomlashuv va «Raqamni ulashish» tugmasi matnini belgilang: xaridor botni ishga tushirganda bot ularni yuboradi.

MAX botini ulash oynasi

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

  1. Hamjamiyatda Manage community → Messages boʻlimini oching va hamjamiyat xabarlarini yoqing.
  2. 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.
  3. 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.
  4. Xohlasangiz, Salomlashuvni belgilang: uni hamjamiyat xabarlariga ruxsat bergan odam oladi.

VK hamjamiyatini ulash oynasi

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.

  1. Meta for Developers da ilova yarating, Instagram mahsulotini qoʻshing va Instagram orqali kirish bilan API sozlamasi boʻlimida biznes akkauntni ulang.
  2. «Kirish tokenlarini yaratish» tugmasini bosing va tokenni nusxalang. instagram_business_basic, instagram_business_manage_messages huquqlari va izohlarga javob uchun instagram_business_manage_comments kerak. Shu yerda Instagram ilovasining maxfiy kalitini ham nusxalang.
  3. 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.
  4. Manzil va tokenni ilovaning vebhuk sozlamalarida (Instagram boʻlimi) koʻrsating. Akkauntni hodisalarga OneTrace.pro oʻzi obuna qila oladi.

Instagram Direct ni ulash oynasi

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.

  1. Meta for Developers da ilova yarating va Messenger mahsulotini qoʻshing.
  2. Messenger → API sozlamalari boʻlimida Facebook sahifasini ulang va pages_messaging huquqi bilan sahifa tokenini yarating. Muddatsiz token kerak: OneTrace.pro uni uzaytirmaydi. Ilova sozlamalari → Asosiy boʻlimida ilova sirini nusxalang.
  3. 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.
  4. 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.