Мундариҷа:
- Ин чӣ гуна кор мекунад
- Кадом вазифаҳоро тавассути почтаи маркетингӣ бастан мумкин аст
- Имконоти дастраси шунавандагон
- Маҳдудиятҳои сегментҳо
- Усулҳои API
- Нақшаи ҳамкорӣ ва тартиби зангҳо
- Статусҳои сегмент
- ИДЕНТИФИКАТОРҲОИ бемор API триггер ВА маркетинг
- Ttl сегмент ва мӯҳлати фиристодан
- Идемпотентӣ ва бақайдгирии такрории бюллетен
- Кадом арзишҳои success_mailing_name иҷозат дода мешаванд
- Маҳдудияти фаровардани беморон
- Нигоҳдорӣ ва коркарди маълумоти гирифташуда
- Бақайдгирии бюллетен барои чӣ аст
- Муҳити озмоишӣ
- Базl ва версияи асосӣ
- Маҳдудиятҳои дархост, вақт ва зангҳои такрорӣ
Маркетинги МАРКЕТИНГӢ API-И Медфлекс мебошад, ки ба хидматҳои шарикӣ имкон медиҳад, ки сегментҳои беморони худро дар шароити гуногун ташкил кунанд, масалан, «мужчины 35+, не были у стоматолога полгода» - ва ба онҳо паемҳои фардӣ фиристед: аксияҳо, едраскуниҳои пешгирӣ, табрикоти зодрӯз.
Функсия аз паемҳои маъмулии триггерӣ фарқ мекунад:
- Паемҳои триггерӣ - едраскуниҳои автоматӣ ба рӯйдодҳои мушаххас: сабт, қабул, бекор кардан.
- Почтаи маркетингӣ маъракаҳои мақсадноки таблиғотӣ аз рӯи сегментҳои беморон: аксияҳо, баргардонидани фавтидагон, пешгирӣ, пеш аз фурӯш.
Дар айни замон, функсия танҳо барои клиникаҳои мис МедЛок дастрас аст. Пайвастшавии ДИГАР МИСҲО дар марҳилаи навбатӣ ба нақша гирифта шудааст, мӯҳлати дақиқи он ҳанӯз муайян нашудааст.
Ин чӣ гуна кор мекунад 
Аз клиника танҳо талаб карда мешавад, ки ҳамгироӣ дар кабинети Шахсии Медфлекс, ивазкунандаи маркетинг Дар Медлок ва бастани шартнома бо хидмат. Пас аз ин, хидмат метавонад ба МедФлекс дархостҳо фиристад, то сегментҳои беморонро аз рӯи параметрҳои додашуда эҷод кунад. Минбаъд зарур аст:
- Дар интерфейси хидмати шарик сегменти аудитория эҷод кунед. Масалан, «пациенты, отменившие запись за последние 7 дней и не записавшиеся повторно».
- МедФлекс сегментро ҷамъ мекунад. Мо ба маълумоти MIS-и шумо муроҷиат мекунем ва беморонро ба шартҳои аз ҷониби ШАРИКИ API додашуда мувофиқат мекунем ва дар баробари истифодаи маҳдудиятҳое, ки пойгоҳи муштариенро муҳофизат мекунанд (бештар дар боби зер).
- Шарик идентификаторҳои муваққатии беморонро мегирад. Онҳо ягон маълумоти шахсӣ надоранд ва 24 соат давом мекунанд.
- Шарик пеш аз фиристодан тамосро мепурсад. Мо ном, номи падар, телефон, почтаи электронӣ ва гурӯҳи синну солро интиқол медиҳем-ва танҳо дар ин марҳила. Нигоҳ доштани ин маълумот ба шарик дар шартнома манъ аст-онҳо танҳо ҳангоми фиристодани паем истифода мешаванд.
- Шарик ба мо мегӯяд, ки номаро ба кӣ фиристодааст. Ин барои он аст, ки ба зудӣ ба ин беморон ҳамон як бюллетенро дубора нафиристед.
Кадом вазифаҳоро тавассути почтаи маркетингӣ бастан мумкин аст 
Дар зер намунаҳои сенарияҳое ҳастанд, ки тавассути бюллетенҳо дастрасанд. Рӯйхати парвандаҳои имконпазир аз татбиқи техникии хидмате, ки шумо пайваст мекунед, вобаста аст.
- Бозгашт пас аз бекор кардани сабт. Беморе, ки боздидро бекор кардааст ва дубора номнавис нашудааст, метавонад пешниҳоди бозгашт фиристад.
- Едрас кардани пешгирии банақшагирифташуда. Бемороне, ки муддати тӯлонӣ дар муоинаи мунтазам набуданд, метавонанд барои сабти ном едраскунӣ фиристанд.
- Зодрӯз муборак. Ба зодрӯзҳое, ки дар як соли охир ҳадди аққал як маротиба дар клиника буданд, табрикоти шахсӣ бо тӯҳфа.
- Ҳамроҳӣ пас аз ба итмом расонидани табобат. Ба бемороне, ки аз табобат гузаштаанд, тавсия додани ташрифҳои дастгирикунанда.
- Баргардонидани «брошенного» курсҳои табобат. Ба бемороне, ки курсро оғоз карданд ва омаданро бас карданд, едраскунандаи аҳамияти идома додан аст.
- Баргардонидани «дорогих» беморон. Ба беморони дорои чеки баланд, ки муддати тӯлонӣ наомадаанд — пешниҳоди шахсӣ.
- Хизматрасонии VIP. Ба беморони дорои чеки миенаи баланд-пешниҳодҳо бо шартҳои махсус.
- Паемҳои гуногун барои беморони ибтидоӣ ва дуюмдараҷа. Аввал суроғаи клиника ва рӯйхати ҳуҷҷатҳо, дуюмдараҷа едраскунии кӯтоҳ.
- Маълумот дар бораи духтур е хидмати нав. Ба беморони ихтисосҳои марбута, ки ҳанӯз аз хидмати нав истифода накардаанд.
- Реаниматсия «спящей» пойгоҳҳо. Ба бемороне, ки 1-3 сол дар клиника набуданд, пешниҳодҳои шахсӣ бо назардошти таърихи хароҷоти онҳо.
Имконоти дастраси шунавандагон 
Аз РӮИ кадом параметрҳо сегменти беморонро ДАР Api Medflex ташкил кардан мумкин аст:
- Бемор: ҷинс, гурӯҳи синну сол, санаи таваллуд (диапазони ±7 рӯз аз имрӯз), давраи бақайдгирӣ дар пойгоҳи МИС (то 5 сол пеш)
- Қабул: ЛПУ, давраи ташриф (то 3 сол пеш), мақоми қабул, духтур, ихтисос, хидмат, шумораи қабулҳо аз рӯи шартҳои блок
- Омори ҳама вақт: шумораи боздидҳо, маблағи харид, чеки миена
- Истисноҳо: бемороне, ки Дар Давоми N рӯзи охир (то 45) ба онҳо номаи муайян фиристода шуданд; бемороне, ки ҳангоми воридоти оммавӣ ба пойгоҳ ворид шуданд
Муҳим: Шарик метавонад ба клиникаҳо дар интерфейси худ на ҳама имконотро барои сохтани сегмент пешниҳод кунад-ин аз татбиқи он вобаста аст.
Маҳдудиятҳои сегментҳо 
То соати 17.08 (дар оянда метавонад аз нав дида баромада шавад):
- ҳадди ақали беморон дар сегменти 1
- ҳадди аксар беморон дар сегмент 5% аз пойгоҳи умумии клиника
- ҳадди аксар беморон дар ҳамаи сегментҳо дар 1 моҳи тақвимӣ 30% аз пойгоҳи умумии клиника
- максимум сегментҳои тайер (шумо метавонед форсиро талаб кунед. маълумоти беморон барои фиристодан) дар шарики 10
- ҳадди аксар сегментҳои фаъол (архив карда нашудаанд) дар шарики 100
- ҳадди аксар сегментҳои фаъоли клиника (аз рӯи ҳамаи шарикон) 100
- вақти" ҳает " - и бемор-24 соат
Ҳангоми расидан ба маҳдудият, шарик хатои МУВОФИҚИ Api-И Медфлексро мегирад.
Кадом беморон дар сегментҳо интиқол дода намешаванд (танзимот Дар Суст):
- Бемор аз коркарди маълумоти шахсӣ даст кашид
- Бемор барои фиристодани огоҳиномаҳо иҷозат надодааст (е вуҷуд дорад «Отказ от рекламных рассылок»).
- Қабули бемор номаълум аст
- Духтуре, ки беморро ба қайд гирифтааст, фиристодани маълумотро манъ мекунад.
Усулҳои API 
Дастрас тавассути пайванд https://developer.medflex.ru/marketing/
Нақшаи ҳамкорӣ ва тартиби зангҳо 
- Рӯйхати пойгоҳи додаҳоро гиред — GET /marketing/databases/.
- Дар ҳолати зарурӣ, барои шартҳои интихоб — табибон, ихтисосҳо, хидматҳо маълумотномаҳо гиред (GET /models/doctor/, GET /models/speciality/, GET /services/prices/).
- Дархост барои сегмент эҷод кунед — POST /marketing/segments/. дар ҷавоб меояд segment_uuid
- То он даме, ки сегмент ready е failed шавад, вазъиятро пурсед — GET /marketing/segments/{segment_uuid}/. Callback пешбинӣ нашудааст - танҳо polling.
- Маълумоти шахсиро барои фиристодани мушаххас дархост кунед — POST /marketing/segments/{segment_uuid}/results/.
- Номаи муваффақро ба қайд гиред — POST /marketing/mailings/.
Рӯйхати сегментҳо — GET /marketing/segments/, хориҷ кардани сегмент — DELETE /marketing/segments/{segment_uuid}/.
Статусҳои сегмент 
pending ва in_progress сегментҳо аз ҷиҳати маъно гуногун мебошанд:
- пендинг маънои онро дорад, ки дархост қабул ва дар навбат аст
- in_progress-ҳисоб аллакай идома дорад.
failed ин метавонад ҳам хатогиро дар шароити сегмент ва ҳам вайроншавии муваққатиро ифода кунад.аз рӯи ҷавоб ин ду ҳолатро фарқ кардан мумкин нест. Агар сегмент ба failed афтода бошад, пас аз муддате дубора эҷод кардани ҳамон дархост маъно дорад, ба ҷои он ки онро ислоҳнашаванда ҳисоб кунед.
Вақти ҳисоб кардани сегмент аз андозаи пойгоҳи клиника ва шумораи шароити филтратсия вобаста аст: вақти маъмулӣ тақрибан 5 сония, бадтарин то 5 дақиқа аст. Поллингро бо назардошти ин паҳншавӣ ба нақша гиред,на ба посухи фаврӣ.
ИДЕНТИФИКАТОРҲОИ бемор API триггер ВА маркетинг 
patient_id ва patient uuid - инҳо ду идентификатори гуногун мебошанд. Муқоисаи бемор аз сегменти маркетинг бо бемор аз таъинот дар ин соҳаҳо ғайриимкон аст.
Идентификатори бемор ДАР MARKETING API бо мақсади ҳифзи пойгоҳи беморони клиника тасодуфӣ карда шудааст ва барои як бемор танҳо 24 соат зиндагӣ мекунад.
Ttl сегмент ва мӯҳлати фиристодан 
Сегмент ва patient_ids — и он маҳз ҳамон қадар зиндагӣ мекунанд, ки идентификатори бемор зиндагӣ мекунад-24 соат пас аз таъсиси сегмент. Ирсоли бюллетен ва ба қайд гирифтани он тавассути POST /marketing/mailings/ зарур аст, ки дар ин фосила, зеро пас аз 24 соат POST/marketing/ mailings / 404-ро бармегардонад.
Агар пас аз 24 соат аз нав ҳисоб кардани сегмент талаб карда шавад, он метавонад нисбат ба ҳисобкунии аввал маҷмӯи гуногуни беморонро дошта бошад.
Идемпотентӣ ва бақайдгирии такрории бюллетен 
POST/marketing/ mailings / сарлавҳаи Idempotency-Key-ро истифода намебарад. МедФлекс шарики худро дар шумораи сабтҳои фиристодан маҳдуд намекунад шумо метавонед якчанд сабтҳоро бо ҳамон success_mailing_name сабт кунед.
days_from_mailing дар exclude_patients аз бақайдгирии охирини почта бо ин ном ҳисоб карда мешавад, на аз аввал.
Истиснои беморон (дар exclude_patients) аз рӯи success_mailing_names гардиши patient_id-ро аз сар мегузаронад: дар дохили Медфлекс patient_id ба идентификатори доимии дохилии бемор дар пойгоҳи Медфлекс пайваст карда шудааст.
Кадом арзишҳои success_mailing_name иҷозат дода мешаванд 
Ҳар гуна арзиш дар доираи қоидаҳои тасдиқи худи майдон (то 50 аломат, танҳо ҳарфҳои лотинӣ, рақамҳо, дефис ва зерхат). Дар бораи намудҳои почтаи электронӣ маълумотномаи муқарраршуда вуҷуд надорад номи онро шарики худ ихтироъ мекунад.
Маҳдудияти фаровардани беморон 
Маҳдудият-30% беморони беназир дар моҳи тақвимӣ.
- Он аз рӯи пойгоҳи додаҳо (DATABASE_ID аз GET /marketing/databases/) ҳисобида мешавад ва ҳамаи lpu_ids-ро, ки ба ин пойгоҳ дохил мешаванд, фаро мегирад.
- Агар як шарик якчанд пойгоҳи додаҳо дошта бошад (ҳолати нодир, вале имконпазир) — шифти умумӣ барои шарик вуҷуд надорад, ҳар як пойгоҳ ҳисобкунаки алоҳидаи худро дорад.
- Дар рӯзи 1-уми ҳар як моҳи тақвимӣ соати 00:00 аз нав барқарор карда мешавад.
- 30% аз андозаи пойгоҳ дар вақти ҳисоб кардани сегменти мушаххас ҳисоб карда мешавад, на аз андозаи дар аввали давра сабтшуда.
Нигоҳдорӣ ва коркарди маълумоти гирифташуда 
Қоидаҳо ва мӯҳлати нигоҳдории маълумоте, ки ТАВАССУТИ API гирифта шудаанд, бо Шартнома бо МедРокет ва замимаҳои Он муайян карда шудаанд — онҳо ба ҳамаи маълумоте, ки тавассути ҳама гуна усули API (усулҳо, хидматҳо, духтур, маълумоти шахсии беморон) гирифта шудаанд, дахл доранд, на танҳо ба эндпоинти мушаххасе, ки дар тавсифи он зикр шудааст.
Истинод ба шартнома - https://medflex.ru/static/dms/pdf/contracts/standard-license-contract-service-ru.pdf
Бақайдгирии бюллетен барои чӣ аст 
Беморони ба қайд гирифташуда тавассути ин занг ба exclude_patients ҳисоб карда мешаванд.success_mailing_names ва аз сегментҳои оянда бо ҳамон success_mailing_name хориҷ карда мешаванд. Роҳҳои дигари истифодаи ин маълумот вуҷуд надоранд.
Муҳити озмоишӣ 
Дар он ягон сангчаи алоҳида пешбинӣ нашудааст. Барои санҷиш, МедФлекс маълумоти клиникаҳои санҷиширо пешниҳод мекунад (воқеӣ нест). Хостнейм, URL ва дигар параметрҳо ҳамон тавре ки дар фурӯшанд. Тафовут танҳо дар нишона аст: танҳо маълумоти клиникаҳои санҷишӣ аз рӯи аломати санҷишӣ дастрас аст. Ин нишона дар шарики худ боқӣ мемонад ва пас аз ба итмом расидани таҳия ҳангоми санҷиши такмилҳо муфид аст. Барои фурӯш аломати алоҳида дода мешавад, ки дар он маълумоти клиникаҳои воқеӣ, ки ҳамгироиро дар ҳуҷраи Шахсии МедФлекс пайваст кардаанд, дастрас карда мешавад.
Токен бо дастрасӣ ба клиникаҳои санҷишӣ аз ҷониби менеҷери шахсии шарик интиқол дода мешавад.
Базl ва версияи асосӣ 
URL-и асосиро бидуни версия дар роҳ истифода баред — https://api.medflex.ru. Постфикс / v1/
кӯҳна ва масир дар ҲАМОН URL бе он.
Дар бораи тағироти нодир дар api, менеҷери Medflex ҳадди аққал 2 ҳафта пеш аз татбиқ дар сӯҳбат огоҳ мекунад.
Маҳдудиятҳои дархост, вақт ва зангҳои такрорӣ 
Маҳдудияти дархостҳо дар як сония (RPS) барои ҳар як шарик гуногун аст ва аз шумораи клиникаҳои пайвастшуда вобаста аст. Формулаи ҳисоб дар шартнома Бо МедРокет сабт шудааст - https://medflex.ru/static/dms/pdf/contracts/standard-license-contract-service-ru.pdf
Илова бар ин, ба дархостҳои комилан якхела (ҳамон усул ва ҳамон бадан ҳамон духтур, бемор, слот, филиал, қабул ва ғайра), ки дар давоми 30 сония пас аз аввалин такрор карда мешаванд, МедФлекс 429 ҷавоб медиҳад. Дархостҳо бо ҷисми дигар ба таври муқаррарӣ коркард карда мешаванд маҳдудият маҳз барои такрори ҳамон як дархост амал мекунад, на барои ҷараени умумӣ. Дар ин ҳолат унвони Retry-After бо арзиши сонияҳо дода мешавад (арзиши ибтидоӣ 30).