Medevio Connect pro partnery
Otevíráme vám cestu k lékařům a pacientům
Medevio je aplikace, přes kterou kliniky komunikují se svými pacienty. Napojte na ni svůj produkt a kliniky si ho zapnou přímo v Medevio, které používají každý den.
- 4 000+lékařů a sester
- 1 500 000+pacientů
Proč Medevio Connect
Dostaňte své rozšíření snáz k lékařům
Klinika si vás zapne sama
Kliniky vaše rozšíření najdou v Obchodě Medevio. Nemusíte je oslovovat jednu po druhé ani s nimi řešit složitou integraci.
Jedním kliknutím z Medevio
Tlačítko je přímo v té části Medevio, se kterou rozšíření pracuje.
Přístup k datům
Rozšíření si data z Medevio načte a výsledek do něj zase uloží.
Lékaři i pacienti
Medevio Connect umožňuje integrace nejen pro ordinace, ale i do pacientské aplikace.
Dva způsoby, jak se napojit
Liší se tím, pro koho je váš produkt určen.
Nástroj, který lékař spustí přímo z Medevio
Jaké nástroje můžete přidat
- Diktovací a přepisové nástroje
- Asistenční pomocníci lékaře
- Specializovaná vyšetření
- Klinické kalkulačky a skóre
- Posudky a formuláře
- a další
- Ovládací prvky — dostupné přímo v rozhraní aplikace Medevio
- Datový kontext — Medevio vaší aplikaci předá, na které klinice lékař právě pracuje a u kterého pacienta a požadavku
- Pro celý tým — po zapnutí je rozšíření k dispozici všem lékařům a dalším členům kliniky
S čím může rozšíření pracovat
- Požadavky
- Karta pacienta
- Kalendář
- Přílohy a dokumenty
- Zdravotní záznam
- Léčebné plány
Služba v aplikaci, kterou pacient už používá
Jaké nástroje můžete přidat
- Cvičení a rehabilitace
- Prevence a screening
- Edukace a podpora léčby
- a další
- Místo v pacientské aplikaci — dlaždice na úvodní obrazovce; po kliknutí se otevře vaše rozšíření
- Cesta k pacientům — rozšíření pacientům nabídneme přímo v aplikaci Medevio, samostatně nebo prostřednictvím jejich kliniky
- Web i mobil — pacientská aplikace běží na počítači i v telefonu
- Snadné přihlášení — rozšíření ví, který pacient je přihlášený, takže nepotřebuje vlastní registraci
S čím může rozšíření pracovat
- Profil přihlášeného pacienta
- Pacienti v jeho účtu, např. děti
Tělesná mapa
Zubní křížJak probíhá integrace
-
Řeknete nám, co stavíte
Projdeme si spolu, co váš produkt dělá, zda je vhodný pro integraci do Medevio a co k tomu potřebuje.
Vyplnit formulář → -
Založíte si testovací kliniku
Zdarma a skrytou před pacienty. API klíč pro testování si vytvoříte v nastavení kliniky v sekci Propojky.
Založit kliniku → -
Postavíte a otestujete rozšíření
Rozšíření postavíte podle veřejné dokumentace API. Než ho zpřístupníme klinikám, společně ho otestujeme ve vývojovém prostředí.
Otevřít dokumentaci → -
Zařadíme vás do nabídky Obchodu
Rozšíření založíme nejdřív ve vývojovém prostředí, pak v produkci. Od té chvíle si ho kliniky můžou zapnout samy.
Stát se partnerem →
Co k zařazení do obchodu potřebujeme
Povinné
- Název rozšíření — viditelný název, identifikuje rozšíření v celém Medevio
- Popis — delší text o rozšíření s možností formátování (Markdown); první řádek pište krátce, protože dlaždice ukáže jen zhruba 3 řádky (zobrazí se na detailu rozšíření v Obchodě)
- Krátký popis — krátký text do zhruba 75 znaků (zobrazí se na dlaždici rozšíření v Obchodě)
- Identifikátor — neveřejný technický identifikátor rozšíření; malými písmeny s pomlčkami, například example-scribe; po zveřejnění se už nemění
- Ikona — obrázek PNG nebo SVG, čtverec 256 × 256 px (zobrazí se na dlaždici rozšíření)
- Ikona tlačítka — obrázek, čtverec 60 × 60 px, PNG s průhledným pozadím, ideálně jednobarevný nebo kontrastní (zobrazí se na tlačítku rozšíření v Medevio)
- Úvodní obrázek — obrázek PNG nebo JPG v poměru 16 : 9, například 1200 × 630 px (zobrazí se na detailu rozšíření v Obchodě)
- Vydavatel — název vaší firmy a odkaz na váš web (zobrazí se u rozšíření jako vydavatel)
- Adresa pro spuštění — odkaz (URL) na vaši aplikaci, který Medevio otevře po kliknutí na tlačítko rozšíření
Volitelné
- Obchodní podmínky — odkaz (URL) na vaše podmínky (zobrazí se při zapínání rozšíření)
- Informační box — nadpis, text a volitelně tlačítko s odkazem (zobrazí se zvýrazněně na detailu rozšíření; hodí se třeba pro návod k prvnímu nastavení)
- Verze — text s verzí vaší aplikace (zobrazí se na detailu rozšíření)
Obrázky posílejte jako soubory, ideálně do 300 kB — hostujeme je u nás.
Přesný seznam polí v dokumentaci →
Technologie
Na čem napojení stojí
Jak se rozšíření v Medevio spustí
V nové záložce
Tlačítko v Medevio otevře vaši webovou aplikaci v nové záložce prohlížeče. V adrese jí předá kliniku a pacienta. Když lékař klikne v detailu požadavku, předá i požadavek.
HTTPS odkazkontext v URLUvnitř Medevio
Vaše aplikace běží v rámu přímo v Medevio — u lékaře v rozhraní kliniky, u pacienta jako dlaždice na úvodní obrazovce i na vlastní stránce. Pacientům na webu i v mobilních aplikacích pro iOS a Android.
iframeWebView iOS / AndroidpostMessageAkce na pozadí
Tlačítko nic neotevírá. Medevio zavolá váš server a lékaři ukáže vaši odpověď. Klíč, kterým vás Medevio volá, zůstává mezi servery a do prohlížeče se nedostane.
HTTPS POSTJSONCo rozšíření umí
Chytrá tlačítka
- Víc tlačítek, každé na svém místě — tlačítka můžou být na různých místech v Medevio a každé má vlastní podobu
- Aktivní, až když to dává smysl — tlačítko může zůstat neaktivní, dokud není splněná podmínka, například pokud pacient nemá uvedený e-mail. Lékaři pak ukáže vaše vysvětlení, proč ho zatím nejde použít
- Vaše hláška po akci — po akci na pozadí lékař uvidí váš text, např. „Pozvánka odeslána“
- Nové tlačítko bez čekání na novou verzi Medevio — stačí, když ho přidáme do nastavení vašeho rozšíření
Bohatší data
- Celý požadavek najednou — včetně příloh ke stažení a souhrnu konverzace s pacientem
- Zápis zpět do Medevio — výsledek uložíte jako přílohu nebo do zdravotního záznamu u požadavku
- Odkaz zpět do Medevio — u pacienta, požadavku i rezervace dostanete odkaz, kterým se lékař vrátí do Medevio
Podporované technologie
| Vaše aplikace | libovolný jazyk a framework | Webová aplikace nebo server dostupný přes HTTPS. |
|---|---|---|
| Data kliniky | REST APIJSONOpenAPI 3 | Běží na api.medevio.cz/external/v1. Umí číst i zapisovat pacienty, požadavky, přílohy, zdravotní záznam a kalendář. |
| Přístup k API | Bearer token | API klíč vystaví uživatel kliniky v nastavení kliniky v sekci Propojky a zvolí rozsah oprávnění. Platí jen pro jeho kliniky. |
| Data pacienta | GraphQL | Rozšíření pro pacienty dostane při spuštění token přihlášeného uživatele a s ním čte data. |
| Zobrazení v Medevio | iframeWebViewpostMessage | Rám se sandboxem. Aplikace si s Medevio vyměňuje zprávy — přihlášení, jazyk, motiv, velikost, navigace. Popis protokolu dostanete od nás. |
| Akce na pozadí | HTTPS POSTJSON | Medevio pošle kontext v těle požadavku a váš klíč pro danou kliniku v hlavičce. Váš server musí odpovědět do 10 sekund. Při úspěchu se lékaři zobrazí váš text. |
| Události | webhookyHMAC-SHA256 | Nastavuje si je klinika ve svém Medevio. Volitelný podpis v hlavičce X-Medevio-Signature. |
Přihlášení přes Medevio, bez kopírování API klíčů
Dnes musí klinika vaší aplikaci vystavit API klíč a lékař se do ní přihlašuje zvlášť. Připravujeme spuštění, při kterém Medevio vaší aplikaci samo předá přihlášeného lékaře i přístup k datům. Týká se rozšíření pro lékaře. Termín upřesníme partnerům, kteří se nám ozvou. Dnešní způsob s API klíčem bude fungovat dál.
- Jednou si vyměníme klíče. Vygenerujete si pár klíčů a veřejný klíč nám pošlete. Zapíšeme ho k vašemu rozšíření spolu s oprávněními, která potřebujete. Soukromý klíč zůstává jen na vašem serveru.
- Klinika rozšíření zapne a tím odsouhlasí oprávnění, o která žádáte. API klíč už vystavovat nemusí.
- Lékař klikne. Medevio otevře vaši aplikaci s jednorázovým launch tokenem. Váš server ho vymění za krátkodobý přístupový token a žádost o výměnu podepíše svým soukromým klíčem. Přístupový token jedná jménem lékaře, platí pro jeho kliniku a jen pro odsouhlasená oprávnění.
Pro vývojáře
Všechno technické najdete v dokumentaci
Veřejná a bez registrace. Popis API vzniká přímo z kódu, takže odpovídá tomu, co Medevio skutečně umí.
Časté otázky
Musíme mít smlouvu, než začneme zkoušet?
Na zkoušení ne. Dokumentace je veřejná a testovací kliniku si založíte sami. Než začnete pracovat s daty skutečných klinik, dořešíme spolu smluvní stránku a potřebné náležitosti.
Kdo se může stát partnerem?
Obchod s rozšířeními spravuje Medevio, takže každé rozšíření prochází přes nás. Ozvěte se a projdeme si, co váš produkt dělá.
Co se stane, když si nás klinika zapne?
Jejím lékařům se v Medevio objeví vaše tlačítka. K datům kliniky se vaše aplikace dostane přes API klíč, který vám klinika vystaví.
Jak dlouho trvá napojení?
Určuje to hlavně rozsah: kolik dat z Medevio potřebujete, na kolika místech v aplikaci se má rozšíření objevit a jestli data jen zobrazuje, nebo je i zapisuje. Podle toho si spolu na začátku řekneme, co vás čeká.
Musí uživatel opustit Medevio?
Nemusí. Rozšíření může běžet přímo uvnitř Medevio, u lékaře i u pacienta, nebo se otevřít v nové záložce. U lékaře může proběhnout i jako akce na pozadí.
Ke kterým datům se dostaneme?
Jen k datům kliniky, která vám vystavila přístup, a jen v rozsahu, který vám nastavila. Samotné zapnutí rozšíření žádná data nezpřístupní. Rozšíření pro pacienty vidí jen to, co přihlášený pacient: jeho profil a pacienty v jeho účtu.
Kdo poskytuje klinikám podporu?
Za fungování vašeho rozšíření odpovídáte vy, za Medevio my. Když se klinika obrátí na nás, dotaz vám předáme.
Jak se to platí?
Obchodní model řešíme individuálně podle typu rozšíření. Napište nám.
Stát se partnerem
Chcete svůj produkt nabídnout v Medevio?
Napište nám, co stavíte. Projdeme si, jestli a jak dává napojení na Medevio smysl.
Raději e-mail? Napište na obchod@medevio.cz