⚠️ Clinikon integraatiota varten sinulla tulee olla Practice-tason paketti (14 päivän ilmainen kokeilu saatavilla). Clinikon integraatio on tällä hetkellä saatavilla vain Australiassa. Tämä koskee sekä Heidi Scribea että Heidi Commsia.

Videodemo — Clinikon asennus ja käyttö

Luo Cliniko API-avaimesi

Luot yhden API-avaimen Clinikossa ja käytät sitä sitten Clinikon yhdistämiseen Heidi Scribeen, Heidi Commsiin tai molempiin. Noudata ensin näitä vaiheita Clinikossa, ja siirry sitten osioon sen Heidi-puolen mukaan, jonka otat käyttöön.

Kirjaudu Cliniko-tilillesi.
Napsauta nimeäsi vieressä olevaa nuolta näytön vasemmassa alakulmassa.
Napsauta Omat tiedot.
Vieritä alas API-avaimet-osioon. Käännä kytkin, jossa lukee "Salli itsellesi luoda ja käyttää API-avaimia", asentoon Kyllä.
Napsauta Päivitä käyttäjä sivun alareunassa.
Cliniko pyytää sinua vahvistamaan henkilöllisyytesi salasanallasi tai avaimellasi.
Kun henkilöllisyys on vahvistettu, sivu päivittyy. Klikkaa API-avaimet -kohdassa Hallitse API-avaimia.
Napsauta API-avaimet-sivulla Lisää API-avain.
Anna API-avaimellesi nimi. Suosittelemme nimeä "Heidi Health", jotta tunnistat sen myöhemmin.
Napsauta Luo API-avain. Näet kirjain- ja numerojoukon — se on API-avaimesi. Kopioi se nyt — Cliniko ei näytä sitä enää uudelleen. Jos et kopioi sitä ajoissa, voit aina luoda uuden.

💡 Lisätietoja Clinikon API-avaimista saat Clinikon omasta ohjeartikkelista.

Olet nyt valmis yhdistämään Clinikon Heidiin. Valitse alla oleva asianmukainen osio — tai määritä molemmat.

Yhdistä Heidi Scribe Clinikoon

Kun API-avain on kopioitu, siirry Heidiin ja navigoi kohtaan Asetukset → Sähköisen potilaskertomuksen integraatiot → Cliniko.
Napsauta Määritä integraatio ja liitä API-avaimesi kenttään.
Napsauta Yhdistä integraatio.
Kun yhteys on muodostettu, näet vahvistusnäytön. Jos kohtaat virheitä, tukitiimimme on täällä auttamassa.

Jos sinulta pyydetään Practitioner ID -tunnusta

Joitakin hoitohenkilöstön jäseniä pyydetään antamaan Practitioner ID -tunnus asennuksen aikana. Löydät sen Clinikosta seuraavasti:

Napsauta vasemman valikkorivin Asetukset.
Avaa Käyttäjät & hoitajat kohdasta "Kliniikkamme".
Valitse itsesi.
Napsauta Muokkaa hoitajan asetuksia.
Practitioner ID -tunnuksesi löytyy URL-osoitteesta, /practitioners/- ja /edit-osien väliltä.

Käytä Heidi Scribea Clinikon kanssa

Avaa vasemman valikon Istunnot-paneeli.
Valitse Istunnot-paneelissa Aikataulu-välilehti.
Napsauta kalenterikuvaketta valitaksesi päivän. Tämän päivän istunnot näkyvät oletuksena.
Etsi haluamasi ajanvaraus ja valitse potilas.
Käy konsultaatio kuten tavallisesti.
Tarkista ja muokkaa muistiinpanoasi tarpeen mukaan.
Kun olet valmis, napsauta Lähetä muistiinpano Clinikoon. Heidi luo uuden hoitomuistiinpanon kyseisen potilaan Cliniko-tiedostoon.

💡 Tärkeää: Vain Aikataulu-välilehdeltä avaamillasi potilailla on "Lähetä Clinikoon" -painike.

Muistiinpanojen luominen ja päivittäminen

Ensimmäisellä kerralla, kun lähetät muistiinpanon, Heidi luo Clinikoon hoitomuistiinpanon luonnos-tilaan.
Jos lähetät muistiinpanon uudelleen, Heidi päivittää olemassa olevan hoitomuistiinpanon, kunhan se on vielä luonnos-tilassa.
Jos Clinikon hoitomuistiinpano on viimeistelty tai arkistoitu, uudelleenlähetys luo uuden muistiinpanon sen sijaan.

Yhdistä Heidi Comms Clinikoon

Heidi Comms käyttää samaa Cliniko API-avainta, jonka loit yllä, sekä kahta lisätietoa: aluekoodiasi ja perus-URL-osoitettasi.

Kun API-avain on kopioitu, avaa Heidi Comms ja napsauta Integraatiot-välilehteä.
Liitä Cliniko API-avaimesi API-avain-kenttään.
Etsi aluekoodi. API-avaimesi päättyy lyhyeen koodiin (kuten au1, au4 tai uk1), joka kertoo Heidille, millä Cliniko-palvelimella tilisi sijaitsee. Katso avaintasi ja etsi muutama merkki, jotka tulevat viimeisen yhdysviivan (-) jälkeen — se on aluekoodi.
Anna perus-URL-osoitteesi. Perus-URL-osoite on osoite, jota Heidi käyttää kommunikoidessaan Clinikon kanssa. Liitä seuraavaan kenttään alla oleva URL-osoite ja korvaa REGION juuri löytämälläsi arvolla:
```
<https://api.REGION.cliniko.com/v1>
```
Esimerkiksi jos aluekoodi on au4, perus-URL-osoitteeksi tulee:
```
<https://api.au4.cliniko.com/v1>
```
Napsauta Yhdistä Clinikoon. Olet valmis aloittamaan.

💡 Miksi Heidi tarvitsee "aluekoodin"? Cliniko isännöi eri tilejä eri palvelimilla ympäri maailmaa. Aluekoodi (muutama merkki API-avaimesi lopussa) kertoo Heidille, millä palvelimella tilisi sijaitsee, ja perus-URL-osoite on täydellinen osoite, jota Heidi käyttää sen saavuttamiseen. Jos olet nähnyt sanan "shard" Clinikon kehittäjädokumentaatiossa, se tarkoittaa samaa asiaa — käytämme tässä termiä "aluekoodi", koska se on selkeämpi.

Jos yhdistämisvaihe epäonnistuu, tarkista, että perus-URL-osoitteesi aluekoodi vastaa täsmälleen API-avaimesi loppua ilman ylimääräisiä välilyöntejä.

Jos kohtaat ongelmia jomman kumman integraation asennuksessa, ota yhteyttä tukitiimiimme — olemme täällä auttamassa.

Aiheeseen liittyvät artikkelit