Tuki

Android-automaatio

Tämän ohjeen avulla korttimaksusi tallentuvat Kuluseurantaan automaattisesti myös Androidilla. Automaatiosovellus (Tasker tai MacroDroid) huomaa Google Walletin tai pankkisi maksuilmoituksen ja välittää summan ja kaupan nimen Kuluseurantaan. Kuluseuranta lähettää heti ilmoituksen "Uusi ostos", ja sitä napauttamalla valitset ostokselle kategorian, samaan tapaan kuin iPhonen Apple-automaatiossa.

Ennen kuin aloitat

Asenna Kuluseuranta Chromesta aloitusnäytölle (asennusohje), kirjaudu sisään ja salli ilmoitukset.
Varmista, että puhelin näyttää ilmoituksen korttimaksusta. Google Walletissa maksuilmoitukset otetaan käyttöön Walletin asetuksista kohdasta Ilmoitukset; monen pankin sovelluksessa on vastaava korttimaksujen ilmoitus.
Valitse automaatiosovellus: MacroDroid on ilmainen (enintään viisi makroa) ja helpompi aloittaa, Tasker on maksullinen ja monipuolisempi. Molemmat löytyvät Google Playsta.

1 Luo API-token sovelluksessa

Avaa Kuluseuranta → Asetukset → API-tokenit-kohta. Anna tokenille nimi (esim. "Android-automaatio") ja paina Luo uusi token. Token näytetään vain kerran, joten kopioi se heti talteen.

Huom: Token toimii kuin salasana. Älä jaa sitä kenellekään. Jos epäilet tokenin vuotaneen, poista se Asetuksista, jolloin automaatio lakkaa toimimasta kunnes luot uuden.

2 Katso, miltä maksuilmoitus näyttää

Tee pieni korttimaksu ja katso puhelimeen tullutta ilmoitusta. Google Walletin ilmoituksessa otsikkona on yleensä kaupan nimi ja tekstinä summa, esimerkiksi:

Otsikko: Lidl
Teksti: 12,50 €

Pankkien ilmoituksissa järjestys voi olla toinen, esimerkiksi otsikkona "Korttimaksu" ja tekstinä "12,50 € K-Market Keskusta". Ilmoituksen tekstiä ei tarvitse muokata: Kuluseuranta poimii summan tekstistä itse (euromerkin vieressä oleva luku valitaan ensin). Kaupan nimeksi kannattaa valita se kenttä, jossa pelkkä kaupan nimi on, yleensä otsikko.

3 Tee automaatio

Valitse jompikumpi sovellus. Molemmat lähettävät saman pyynnön Kuluseurannan palvelimelle:

POST https://api.kuluseuranta.com/api/pending-transaction
Authorization: Bearer <TOKEN>
amount = ilmoituksen teksti
merchant = ilmoituksen otsikko

Vaihtoehto A: MacroDroid

Avaa MacroDroid ja paina Lisää makro. Nimeä se esimerkiksi "Kuluseuranta".
Laukaisin: lisää laukaisin Ilmoitus (Notification) → Ilmoitus vastaanotettu (Notification Received). Valitse sovellukseksi Google Wallet tai pankkisi sovellus. Rajaa tekstiehdoksi, että ilmoitus sisältää merkin €, jotta muut ilmoitukset (esim. tarjoukset) eivät käynnistä automaatiota. MacroDroid pyytää lupaa lukea ilmoituksia; salli se.
Toiminto: lisää toiminto HTTP-pyyntö (HTTP Request) ja täytä:
- Metodi: POST
- URL: https://api.kuluseuranta.com/api/pending-transaction
- Kyselyparametrit (Query Params): amount = taikateksti [notification] (ilmoituksen teksti) ja merchant = [notification_title] (ilmoituksen otsikko)
- Otsikot (Headers): Authorization = Bearer <TOKEN>
Tallenna makro.

Taikatekstit lisätään kenttään kenttien vieressä olevalla ...-painikkeella (Magic Text), jolloin oikeaa nimeä ei tarvitse kirjoittaa käsin.

Vaihtoehto B: Tasker

Profiilit → + → Tapahtuma (Event) → UI → Ilmoitus (Notification). Valitse omistajasovellukseksi (Owner Application) Google Wallet tai pankkisi sovellus ja kirjoita tekstikenttään *€*, jotta vain maksuilmoitukset käynnistävät profiilin. Tasker pyytää lupaa lukea ilmoituksia; salli se.
Luo profiilille uusi tehtävä (Task), esim. "Kuluseuranta", ja lisää siihen toiminto Net → HTTP Request:
- Method: POST
- URL: https://api.kuluseuranta.com/api/pending-transaction
- Headers: Authorization:Bearer <TOKEN>
- Query Parameters, kumpikin omalle rivilleen:
  amount:%evtprm3
  merchant:%evtprm2
Palaa takaisin, niin Tasker tallentaa profiilin.

%evtprm2 on ilmoituksen otsikko ja %evtprm3 sen teksti. Voit valita ne myös kentän muuttujavalitsimesta (tunnistekuvake), jossa ne näkyvät nimillä Title ja Text.

Kaupan nimi on valinnainen. Jos pankkisi ilmoituksessa ei ole pelkkää kaupan nimeä, jätä merchant-parametri pois. Kirjoita silloin kauppa itse, kun täydennät ostosta. Kenttään mahtuu 100 merkkiä.

4 Testaa automaatio

Tee pieni korttimaksu. Puhelimeen pitäisi tulla muutaman sekunnin sisällä Kuluseurannan ilmoitus "Uusi ostos", jossa näkyvät summa ja kaupan nimi. Voit testata palvelinyhteyden myös tietokoneelta ilman maksua:

curl -X POST "https://api.kuluseuranta.com/api/pending-transaction?amount=12,50%20%E2%82%AC&merchant=Lidl" -H "Authorization: Bearer <TOKEN>"

Jos ilmoitusta ei tule, tarkista että:

token on kopioitu kokonaan ja Authorization-otsikon arvo alkaa Bearer (välilyönti ennen tokenia)
pyynnön metodi on POST, ei GET
automaatiosovelluksella on lupa lukea ilmoituksia, ja se on poistettu akun optimoinnista (Asetukset → Sovellukset → MacroDroid tai Tasker → Akku → Rajoittamaton), ettei Android sammuta sitä taustalla
Chromen ilmoitukset on sallittu Kuluseurannalle (Asetukset → Ilmoitukset)

Virhe "amount puuttuu tai on virheellinen"? Ilmoituksen tekstissä ei ollut summaa. Tarkista vaiheesta 2, kummassa kentässä summa on, ja vaihda tarvittaessa amount- ja merchant-parametrien arvot keskenään. Näet automaation lähettämät arvot lisäämällä ennen HTTP-pyyntöä tilapäisen toiminnon, joka näyttää ne (MacroDroidissa Näytä ilmoitus, Taskerissa Alert → Flash).

5 Täydennä ostos ilmoituksesta

Napauta "Uusi ostos" -ilmoitusta. Kuluseuranta avautuu näkymään, jossa summa ja kaupan nimi ovat jo valmiina. Jos olet ostanut samasta kaupasta aiemmin, kategoria ja maksutapa on ehdotettu edellisen ostoksen mukaan. Tarkista tiedot ja paina Tallenna tapahtuma.

Jos et ehdi napauttaa ilmoitusta heti: ei haittaa. Kun avaat Kuluseurannan seuraavan kerran, täydennysnäkymä avautuu automaattisesti, kunnes olet hoitanut ostoksen. Voit myös painaa "Hylkää tämä ostos", jos se ei kuulu seurantaan.

6 Mitä tietoja lähetetään

Automaatio lähettää vain summan ja kaupan nimen suoraan omalla tokenillasi Kuluseurannan palvelimelle. Kaupan nimi tallennetaan salattuna samoin kuin muut tapahtumien tiedot. Muita ilmoituksia automaatiosovellus ei lähetä, kun laukaisin on rajattu maksusovellukseen ja euromerkkiin.