Ссылка скопирована
Мы используем cookie и Яндекс.Метрику, чтобы сайт работал лучше
Qidiruv

Integratsiya haqida ma'lumot

Tarkib:

Marketing pochta xabarlari-bu Medflex API bo'lib, u sheriklik xizmatlariga bemorlaringizning segmentlarini turli xil sharoitlarda shakllantirishga imkon beradi — masalan «мужчины 35+, не были у стоматолога полгода»— va ularga moslashtirilgan xabarlarni yuborish: aktsiyalar, profilaktika eslatmalari, tug'ilgan kun tabriklari.

Funktsionallik odatdagi tetik xabarnomalaridan farq qiladi:

  • Trigger pochta xabarlari-muayyan voqealar uchun avtomatik eslatmalar: yozib olish, qabul qilish, bekor qilish.
  • Marketing jo'natmalari-bemorlarning segmentlari bo'yicha maqsadli reklama kampaniyalari: aktsiyalar, ketganlarni qaytarish, oldini olish, oldindan sotish.
Hozircha funksionallik faqat mis Medlokdagi klinikalar uchun mavjud. Qolgan misni ulash keyingi bosqichda rejalashtirilgan, aniq muddatlar hali aniqlanmagan.

Bu qanday ishlaydi

Klinikadan faqat Medfleksning shaxsiy kabinetidagi integratsiyani, medlokdagi marketing byulletenlarini almashtirishni yoqish va xizmat bilan shartnoma tuzish talab qilinadi. Shundan so'ng, xizmat belgilangan parametrlar bo'yicha bemorlarning segmentlarini yaratish uchun Medfleksga so'rov yuborishi mumkin. Keyinchalik kerak:

  1. Hamkor xizmatining interfeysida auditoriya segmentini yarating. Masalan,«пациенты, отменившие запись за последние 7 дней и не записавшиеся повторно».
  2. Medflex segmentni yig'adi. Biz sizning mis ma'lumotlariga murojaat qilamiz va bemorlarni API sherigi tomonidan berilgan shartlarga moslashtiramiz, shu bilan birga mijozlar bazasini himoya qiladigan cheklovlarni qo'llaymiz (quyida keltirilgan bo'limda).
  3. Hamkor vaqtinchalik bemor identifikatorlarini oladi. Ular shaxsiy ma'lumotlarni o'z ichiga olmaydi va 24 soat davom etadi.
  4. Hamkor yuborishdan oldin kontaktlarni so'raydi. Biz ism, otasining ismi, telefon, elektron pochta va yosh guruhini topshiramiz-va faqat shu bosqichda. Ushbu ma'lumotlarni sherikga shartnomada saqlash taqiqlanadi-ular faqat xabar yuborilgan paytda ishlatiladi.
  5. Hamkor bizga axborot byulletenini kimga yuborganini aytadi. Bu bemorlarga tez orada bir xil xabarni qayta yubormaslik uchun kerak.

Marketing xabarlari orqali qanday vazifalarni yopish mumkin

Quyida pochta orqali mavjud bo'lgan stsenariylarga misollar keltirilgan. Mumkin bo'lgan holatlar ro'yxati siz ulagan xizmat tomonidagi texnik dasturga bog'liq.

  • Yozishni bekor qilgandan keyin qaytish. Tashrifni bekor qilgan va yana ro'yxatdan o'tmagan bemorga qaytish taklifi yuborilishi mumkin.
  • Rejalashtirilgan profilaktika haqida eslatma. Uzoq vaqt davomida muntazam tekshiruvdan o'tmagan bemorlarga ro'yxatdan o'tish haqida eslatma yuborilishi mumkin.
  • Tug'ilgan kuningiz bilan tabriklayman. O'tgan yili kamida bir marta klinikada bo'lgan tug'ilgan kun odamlari-sovg'a bilan shaxsiy tabriklar.
  • Davolash kursini tugatgandan so'ng eskort. Jarayon kursidan o'tgan bemorlar-qo'llab-quvvatlovchi tashriflarni tavsiya qilish.
  • «брошенного»Davolash kursini qaytarish. Kursni boshlagan va kelishni to'xtatgan bemorlar davom etish muhimligini eslatadilar.
  • «дорогих»Bemorlarning qaytishi. Uzoq vaqt davomida kelmagan yuqori chekli bemorlar-bu shaxsiy taklif.
  • VIP xizmati. O'rtacha cheklari yuqori bo'lgan bemorlar — maxsus shartlar bo'yicha takliflar.
  • Birlamchi va ikkilamchi bemorlar uchun turli xil xabarlar. Birlamchi-klinikaning manzili va hujjatlar ro'yxati, ikkilamchi — qisqa eslatma.
  • Yangi shifokor yoki xizmat haqida ma'lumot berish. Hali yangi xizmatdan foydalanmagan tegishli mutaxassisliklarga ega bemorlar.
  • «спящей»Bazani reanimatsiya qilish. Klinikada 1-3 yil bo'lmagan bemorlar xarajatlar tarixini hisobga olgan holda shaxsiy takliflardir.

Mavjud auditoriya parametrlari

Medflex API-da bemorlar segmentini qanday parametrlar bo'yicha shakllantirish mumkin:

  • Bemor: jinsi, yosh guruhi, tug'ilgan sanasi (bugundan ±7 kun oralig'i), mis bazasida ro'yxatdan o'tish davri (5 yil oldin)
  • Qabul: sog'liqni saqlash muassasasi, tashrif davri (3 yil oldin), qabul holati, shifokor, mutaxassislik, xizmat, blok shartlariga muvofiq qabul soni
  • Barcha vaqt statistikasi: tashriflar soni, xaridlar miqdori, o'rtacha chek
  • Istisnolar: so'nggi N kun ichida ma'lum bir pochta jo'natmasi yuborilgan bemorlar (45 tagacha); ommaviy import paytida bazaga tushgan bemorlar
Muhim: hamkor o'z interfeysidagi klinikalarga segment yaratish uchun barcha parametrlarni taklif qila olmaydi-bu uning tomonidagi dasturga bog'liq.

Segment cheklovlari

17.08 da tegishli (kelajakda qayta ko'rib chiqilishi mumkin):

  • segmentdagi minimal bemorlar - 1
  • segmentdagi bemorlarning maksimal darajasi klinikaning umumiy bazasining 5% ni tashkil qiladi
  • 1 kalendar oy davomida barcha segmentlarda bemorlarning maksimal darajasi klinikaning umumiy bazasining 30% ni tashkil qiladi
  • maksimal tayyor segmentlar (siz fors tilini so'rashingiz mumkin. yuborish uchun bemor ma'lumotlari) sherikda-10
  • hamkorning maksimal faol segmentlari (arxivlanmagan) - 100
  • klinikaning maksimal faol segmentlari (barcha sheriklar uchun) - 100
  • bemorning ID "hayoti" vaqti-24 soat

Cheklovga erishilganda, sherik Medflex API-da tegishli xatoga yo'l qo'yadi.

Qaysi bemorlar segmentlarda o'tkazilmaydi (Medlok sozlamalari):

  • Bemor shaxsiy ma'lumotlarni qayta ishlashdan bosh tortdi
  • Bemor bildirishnomalarni yuborish (yoki «Отказ от рекламных рассылок»ovqatlanish) uchun ruxsat bermadi.
  • Bemorni qabul qilish anonim
  • Bemor qayd etilgan shifokor ma'lumotlarni yuborishni taqiqlaydi.

API usullari

Havola orqali mavjud https://developer.medflex.ru/marketing/

O'zaro ta'sir sxemasi va qo'ng'iroqlar tartibi

  1. Ma'lumotlar bazalari ro'yxatini oling - get / marketing/databases/.
  2. Agar kerak bo'lsa, tanlov shartlari uchun ma'lumotnomalarni oling — shifokorlar, mutaxassisliklar, xizmatlar (GET /models/doctor/, GET /models/speciality/, get /services/prices/).
  3. Segment so'rovini yarating-POST / marketing/segmentlar/, bunga javoban segment_uuid keladi
  4. Segment ready yoki failed — Get /marketing/segments/{segment_uuid}/bo'lgunga qadar holatni so'rang. Callback ta'minlanmagan - faqat polling.
  5. Muayyan yuborish uchun shaxsiy ma'lumotlarni so'rang-POST / marketing/segmentlar/{segment_uuid}/natijalar/.
  6. Muvaffaqiyatli pochta xabarlarini ro'yxatdan o'tkazing-POST / marketing/mailings/.

Segmentlar ro'yxati-GET/marketing/ segmentlar/, segmentni o'chirish — DELETE/marketing/segmentlar/{segment_uuid}/.

Segment holatlari

pending va in_progress segmentlari-har xil ma'nodagi holatlar:

  • pending so'rov qabul qilinganligini va hisoblash uchun navbatga qo'yilganligini anglatadi
  • in_progress-hisoblash allaqachon davom etmoqda.

muvaffaqiyatsiz segment sharoitidagi xatoni ham, vaqtinchalik nosozlikni ham anglatishi mumkin — javobga ko'ra, bu ikki holatni ajratib bo'lmaydi. Agar segment muvaffaqiyatsiz tugagan bo'lsa, bir muncha vaqt o'tgach, xuddi shu so'rovni qayta tiklash va uni tuzatib bo'lmaydigan deb hisoblamaslik mantiqan to'g'ri keladi.

Segmentni hisoblash vaqti klinika bazasining hajmiga va filtrlash shartlari soniga bog'liq: odatdagi vaqt taxminan 5 soniya, eng yomoni 5 daqiqagacha. Bir zumda javob berishni kutishdan ko'ra, ushbu tarqalishni hisobga olgan holda pollingni rejalashtiring.

Trigger va marketing API bemor identifikatorlari

patient_id va patient uuid ikki xil identifikatordir. Marketing segmentidagi bemorni ushbu sohalarda qabul qilingan bemor bilan taqqoslash mumkin emas.

Marketing API-dagi bemor identifikatori klinikaning bemor bazasini himoya qilish uchun randomizatsiyalangan va bitta bemor uchun atigi 24 soat yashaydi.

TTL segmenti va axborot byulletenining muddati

Segment va uning patient_ids bemor identifikatori bilan bir xil yashaydi — segment yaratilganidan beri 24 soat. Pochta jo'natmasini yuboring va uni POST /marketing/mailings orqali ro'yxatdan o'tkazing/ ushbu intervalda bo'lishi kerak, chunki 24 soatdan keyin POST /marketing/mailings/ 404-ni qaytaradi.

Agar siz 24 soatdan keyin segmentni qayta hisoblashni talab qilsangiz, unda birinchi hisob-kitobga qaraganda boshqa bemorlar to'plami bo'lishi mumkin.

Idempotentlik va pochta xabarlarini qayta ro'yxatdan o'tkazish

POST / marketing / mailings / Idempotency-Key sarlavhasidan foydalanmaydi. Medflex sherikni pochta jo'natmalari sonini cheklamaydi-bir xil success_mailing_name bilan bir nechta yozuvlarni ro'yxatdan o'tkazishingiz mumkin.

exclude_patients-dagi days_from_mailing birinchi emas, balki shu nomdagi oxirgi pochta ro'yxatidan hisoblanadi.

Success_mailing_names tomonidan bemorlarni istisno qilish (exclude_patients-da) patient_id rotatsiyasini boshdan kechiradi: Medfleks ichida patient_id Medfleks bazasida doimiy ichki bemor identifikatoriga bog'langan.

Success_mailing_name qiymatlari qanday qabul qilinadi

Maydonning o'zini tasdiqlash qoidalari doirasidagi har qanday qiymat (50 tagacha belgi, faqat lotin harflari, raqamlar, defis va pastki chiziq). Pochta jo'natmalari turlarining qat'iy ma'lumotnomasi yo'q-bu nom sherik tomonidan ixtiro qilingan.

Bemorlarni tushirish chegarasi

Cheklov-kalendar oyidagi noyob bemorlarning 30%.

  • Ma'lumotlar bazasi bo'yicha hisoblanadi (get /marketing/databases/ dan database_id) va ushbu bazaga kiradigan barcha lpu_idlarni qamrab oladi.
  • Agar bitta sherikda bir nechta ma'lumotlar bazasi bo'lsa (kamdan — kam uchraydigan, ammo mumkin bo'lgan holat) - sherik uchun umumiy Shift yo'q, har bir bazaning o'ziga xos hisoblagichi bor.
  • Har bir kalendar oyining 1-kuni soat 00:00 da qayta tiklanadi.
  • 30% davr boshida qayd etilgan hajmdan emas, balki ma'lum bir segmentni hisoblash paytida bazaning kattaligidan hisoblanadi.

Olingan ma'lumotlarni saqlash va qayta ishlash

API orqali olingan ma'lumotlarni saqlash qoidalari va muddatlari Medroket va unga qo'shimchalar bilan tuzilgan shartnomada belgilanadi-ular har qanday API usuli (qabullar, xizmatlar, shifokor, bemorlarning shaxsiy ma'lumotlari) orqali olingan barcha ma'lumotlarga taalluqlidir, nafaqat tavsifida aytib o'tilgan ma'lum bir endpointga.

Shartnomaga havola - https://medflex.ru/static/dms/pdf/contracts/standard-license-contract-service-ru.pdf

Nima uchun pochta xabarlarini ro'yxatdan o'tkazish kerak

Ushbu qo'ng'iroq orqali ro'yxatdan o'tgan bemorlar exclude_patients-da hisobga olinadi.success_mailing_names va xuddi shu success_mailing_name bilan kelajakdagi segmentlardan chiqarib tashlanadi. Ushbu ma'lumotlardan foydalanishning boshqa usullari mavjud emas.

Sinov muhiti

Alohida qum qutisi ta'minlanmagan. Sinov uchun Medflex test klinikalari ma'lumotlarini taqdim etadi (haqiqiy emas). Xost nomi, URL manzili va boshqa parametrlar mahsulotdagi kabi. Farq faqat tokenda: sinov tokenida faqat sinov klinikalari ma'lumotlari mavjud. Ushbu belgi sherikda qoladi va rivojlanish tugagandan so'ng-yaxshilanishlarni sinab ko'rishda foydali bo'ladi. Prod uchun alohida token beriladi, unga ko'ra Medfleksning shaxsiy kabinetiga integratsiyani ulagan haqiqiy klinikalar ma'lumotlari mavjud bo'ladi.

Sinov klinikalariga kirish huquqiga ega bo'lgan token sherikning shaxsiy menejeri tomonidan uzatiladi.

Asosiy URL va versiya

Yo'lda versiyasiz asosiy URL-dan foydalaning — https://api.medflex.ru. postfiks / v1/
eskirgan va u holda bir xil URL manziliga yo'naltiring.

Medflex menejeri API-dagi kamdan-kam o'zgarishlar haqida suhbatdan kamida 2 hafta oldin xabar beradi.

So'rovlar chegaralari, muddatlar va takroriy qo'ng'iroqlar

Sekundiga so'rovlar chegarasi (RPS) har bir sherik uchun individualdir va ulangan klinikalar soniga bog'liq. Hisoblash formulasi Medroket bilan tuzilgan shartnomada qayd etilgan - https://medflex.ru/static/dms/pdf/contracts/standard-license-contract-service-ru.pdf

Bundan tashqari, birinchisidan keyin 30 soniya davomida takrorlangan mutlaqo bir xil so'rovlarga (bir xil usul va bir xil tana — bir xil shifokor, bemor, slot, filial, qabul va boshqalar) Medflex 429 ga javob beradi. Boshqa jism bilan so'rovlar odatdagidek ko'rib chiqiladi-cheklash umumiy oqimga emas, balki bir xil so'rovni takrorlashga ta'sir qiladi. Bunday holda, Retry-after sarlavhasi soniyalarda qiymat bilan beriladi (asl qiymati — 30).