Tuki

Apple Shortcuts -automaatio

Tämän ohjeen avulla saat Apple Wallet -maksusi tallentumaan Kuluseurantaan automaattisesti heti maksun jälkeen. Puhelin lähettää summan taustalla palvelimelle, joka lähettää heti työntöilmoituksen puhelimeesi. Napauttamalla ilmoitusta avautuu Kuluseuranta suoraan siihen kohtaan, jossa valitset kategorian ja kuvauksen tälle ostokselle. Shortcuts-puolella ei tarvitse kysyä mitään muuta kuin summan.

Valmiit pikakomentopohjat (nopein tapa aloittaa)

Voit ladata valmiit pohjat suoraan ja muokata niihin vain oman API-tokenisi, sen sijaan että rakentaisit pikakomennon tyhjästä. Molemmat tarvitaan: automaatio käynnistää itse skriptin aina Wallet-maksun yhteydessä.

Lataa: Wallet automaatio käynnistin, joka havaitsee Wallet lähimaksun
Lataa: Tallenna maksu skripti itse pikakomento, joka lähettää summan Kuluseurantaan

Lataamisen jälkeen avaa "Tallenna maksu" -pikakomento muokkaustilassa ja korvaa Authorization-otsikon <TOKEN>-kohta omalla, vaiheessa 1 luodulla API-tokenillasi. Voit silti lukea vaiheet 1–9 alta ymmärtääksesi, miten kokonaisuus toimii, tai jos haluat rakentaa pikakomennon itse alusta asti.

1 Luo API-token sovelluksessa

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

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 Testaa palvelinyhteys ennen pikakomentoa

Kannattaa varmistaa palvelinpuolen toimivuus erikseen, ennen kuin rakennat itse pikakomentoa. Näin tiedät heti, onko mahdollinen ongelma tokenissa/palvelimessa vai vasta pikakomennon rakenteessa.

Vaihtoehto A: Terminaali (Mac) tai muu tietokone

Aja tämä komento, korvaa <TOKEN> omalla tokenillasi:

curl -X POST "https://api.kuluseuranta.com/api/pending-transaction?amount=12.50" -H "Authorization: Bearer <TOKEN>"

Vaihtoehto B: Suoraan puhelimella, Pikakomennoissa

Tee yksinkertainen testipikakomento: yksi Hae sisältö URLista -toiminto, jonka URL, metodi ja otsikko täytetään täsmälleen niin kuin vaiheessa 5 kuvataan, mutta amount=-kohtaan kirjoitetaan suoraan kiinteä luku, esim. 12.5, muuttujapillerin sijaan. Suorita pikakomento kertaalleen käsin.

Jos testi onnistuu, puhelimeen pitäisi ilmestyä muutaman sekunnin sisällä ilmoitus "Uusi ostos". Ennen tätä sinun täytyy avata Kuluseuranta kertaalleen ja hyväksyä ilmoitusten lupakysely (tämä tapahtuu automaattisesti kirjautumisen yhteydessä). Kun testi toimii, voit siirtyä rakentamaan varsinaisen automaation alla olevien vaiheiden mukaan.

3 Luo uusi pikakomento

Avaa Pikakomennot-sovellus iPhonessa → + (Uusi pikakomento). Nimeä se esimerkiksi "Tallenna maksu".

Miten kokonaisuus toimii: teet yhden pikakomennon ("Tallenna maksu"), jonka sisälle tulevat kaikki seuraavat vaiheet peräkkäin. Automaatio (vaihe 4) ei ole erillinen pikakomento, vaan se käynnistää tämän saman "Tallenna maksu" -pikakomennon automaattisesti aina kun teet Wallet-maksun.

4 Aseta automaation käynnistin

Tämä vaihe päättää, milloin "Tallenna maksu" -pikakomento käynnistyy. Valitse jompikumpi tavoista.

Vaihtoehto A: Automaatio Apple Walletin maksusta

Pikakomennot → Automaatio-välilehti → + → Luo henkilökohtainen automaatio
Valitse Wallet → kortti, jota käytät maksuihin → Kun sitä käytetään lähimaksuun
Lisää toiminnoksi "Suorita pikakomento" ja valitse luomasi "Tallenna maksu" -pikakomento
Poista "Kysy ennen suorittamista" käytöstä, jotta se toimii täysin automaattisesti

Tämän jälkeen jokainen Wallet-lähimaksu käynnistää "Tallenna maksu" -pikakomennon automaattisesti taustalla, eikä sinun tarvitse avata Pikakomennot-sovellusta itse.

Vaihtoehto B: Pikakomento kotinäytöllä / Siri

Jos et halua automaattista käynnistystä, voit lisätä pikakomennon kotinäytölle tai käynnistää sen Sirillä maksun jälkeen

5 Tee muuttuja summalle

Jotta URL-kenttään voi valita summan "pillerinä", pikakomennossa täytyy ensin olla toiminto, joka tuottaa sen tiedon. Kategoriaa ja kuvausta ei kysytä Shortcuts-puolella lainkaan, ne täytetään myöhemmin Kuluseurannassa push-ilmoituksesta.

Riippuu siitä, millä käynnistit automaation (vaihe 4)

Jos käytit Wallet-automaatiota (vaihtoehto A): summa tulee automaattisesti mukana toiminnon syötteenä. Erillistä "Pyydä"-toimintoa ei tarvita. Kun täytät URL-kenttää (vaihe 6), avaa muuttujavalitsin ja etsi listasta Pikakomennon syöte tai Transaktion summa / Tapahtuman summa. Se on Wallet-automaation antama valmis muuttuja, eikä sitä tarvitse luoda itse.
Jos käytit vaihtoehtoa B (manuaalinen käynnistys): lisää toiminto Kysy tekstisyötettä, kysymykseksi esim. "Kuinka paljon maksoit?", ja aseta vastaustyypiksi Numero. Nimeä tulos heti Summa-nimiseksi (katso ohje alla).

Näin nimeät "Annettu syöte" -tuloksen (vain vaihtoehto B)

"Kysy tekstisyötettä" -toiminnon alla näkyy pienellä tekstillä sen tulos, oletuksena "Annettu syöte".
Napauta tätä "Annettu syöte" -tekstiä (ei itse kysymystä ylempänä).
Avautuvasta valikosta valitse Nimeä muuttuja uudelleen (tai pitkä painallus, jos lyhyt napautus ei avaa valikkoa).
Kirjoita tilalle selkeä nimi: Summa.

Kun avaat muuttujavalitsimen URL-vaiheessa, näet suoraan "Summa"-nimisen vaihtoehdon "Annettu syöte" -nimisen sijaan.

6 Lisää "Hae sisältö URLista" -toiminto

Lisää pikakomentoon toiminto Hae sisältö URLista (nimi voi näkyä myös muodossa "Nouda URL-osoitteen sisältö" tai englanniksi "Get Contents of URL" iOS-version mukaan; löydät sen hakemalla hakukentästä sanalla URL, Verkko-kategoriasta). Täytä se näin:

URL: osoite alla, muuttuja lisättynä amount-parametriin
Metodi: POST
Otsikot (Headers): lisää avain Authorization, tekstiksi Bearer <tokenisi>
Pyynnön runko (Request Body): jätä pois päältä / "Ei mitään", kaikki tieto menee URL:n parametrissa

https://api.kuluseuranta.com/api/pending-transaction?amount=[Summa]

[Summa] on tässä ohjeessa vain kuvitteellinen paikka, ei tekstiä jonka pitäisi kirjoittaa URL-kenttään, se korvataan muuttujapillerillä alla olevien askelten mukaisesti.

Näin lisäät muuttujan oikein URL-kenttään:

Kirjoita URL-kenttään ensin pelkkä teksti https://api.kuluseuranta.com/api/pending-transaction?amount= (ilman hakasulkeita tai mitään niiden perään).
Jätä kirjoituskohdistin heti amount=-tekstin perään ja napauta näppäimistön yläpuolella näkyvää muuttujavalitsinta (pieni rivi, jossa lukee aiemmin luomiesi toimintojen nimiä). Jos nimesit muuttujan vaiheessa 5 ohjeen mukaan, näet listassa suoraan Summa-nimisen vaihtoehdon "Annettu syöte" -nimisen sijaan.
Valitse listasta oikea muuttuja: Wallet-summa (esim. "Pikakomennon syöte" tai "Transaktion summa") tai oma nimeämäsi Summa-muuttuja vaiheesta 5. Se ilmestyy kenttään sinisenä pillerinä, ei tekstinä.

Tunnistat onnistuneen lisäyksen siitä, että muuttuja näkyy URL-kentässä pyöreäkulmaisena, eri taustavärisenä "pillerinä" eikä tavallisena kirjoitettuna tekstinä hakasulkeiden sisällä. Jos näet kentässä hakasulkeita sisältävää tavallista tekstiä (esim. [Summa]), muuttujaa ei ole vielä lisätty oikein, poista teksti ja toista edelliset askeleet.

Vinkki: Jos summa saattaa sisältää desimaalipilkun, muunna se pisteeksi ennen lähetystä (Pikakomennot → "Korvaa teksti" -toiminto: , → .), koska API odottaa desimaalipistettä.

7 Testaa koko pikakomento

Suorita pikakomento kertaalleen käsin Pikakomennot-sovelluksesta. Puhelimeen pitäisi ilmestyä muutaman sekunnin sisällä ilmoitus "Uusi ostos" summan kanssa. Jos näin ei käy, tarkista että:

token on kopioitu kokonaan ja ilman ylimääräisiä välilyöntejä
Authorization-otsikon arvo alkaa täsmälleen Bearer (välilyönti ennen tokenia)
pyynnön metodi on POST, ei GET
summa on numero eikä sisällä valuuttamerkkiä
ilmoitusten lupa on annettu Kuluseurannalle (Asetukset-sovellus → Ilmoitukset → Kuluseuranta)

Virhe "amount puuttuu tai on virheellinen"? Tämä tarkoittaa, ettei summamuuttuja päätynyt URL:iin kelvollisena numerona. Yleisin syy on, että Wallet-automaation summamuuttuja sisältää valuuttamerkin tai pilkun (esim. 1,39 €) eikä pelkkää numeroa (1.39). Selvitä tarkka syy näin:

Lisää pikakomentoon tilapäisesti Näytä tulos -toiminto juuri ennen "Hae sisältö URLista" -toimintoa, ja anna sille näytettäväksi täsmälleen se URL, jonka rakensit (paina URL-kenttää ja valitse koko lauseke).
Suorita pikakomento ja lue mitä amount=-kohdan jälkeen todella lukee.
Jos siellä on valuuttamerkki, ylimääräinen välilyönti tai pilkku, lisää ennen URL-vaihetta Korvaa teksti -toiminto(ja), jotka poistavat €-merkin ja välilyönnit sekä vaihtavat pilkun pisteeksi.
Jos kenttä on kokonaan tyhjä, muuttujaa ei ole liitetty URL-kenttään oikein. Paina URL-tekstikenttää uudelleen ja valitse muuttuja listasta sen sijaan, että kirjoitat sen nimen käsin.

8 Täydennä ostos ilmoituksesta

Napauta puhelimeen saapunutta "Uusi ostos" -ilmoitusta. Kuluseuranta avautuu suoraan näkymään, jossa summa on jo valmiina. Valitse vain kategoria ja kirjoita halutessasi kuvaus, ja paina Tallenna tapahtuma. Vasta tämän jälkeen ostos ilmestyy Yhteenvetoon ja Historiaan.

Jos et ehdi napauttaa ilmoitusta juuri sillä hetkellä: ei haittaa. Seuraavan kerran kun avaat Kuluseurannan, se avaa saman täydennysnäkymän automaattisesti, kunnes hoidat ostoksen kategorian ja kuvauksen. Voit myös painaa "Hylkää tämä ostos", jos se ei kuulu seurantaan.

9 Ota automaatio käyttöön

Kun testi onnistuu, palaa automaatioon (jos käytit vaihtoehtoa A) ja varmista, että "Kysy ennen suorittamista" on pois päältä. Tämän jälkeen jokainen Wallet-lähimaksu lähettää ilmoituksen Kuluseurantaan automaattisesti, ja voit täydentää sen kategorian milloin ehdit.