iPhone — hälytysten asennus Pikakomennoilla

iOS ei anna sovellukselle oikeutta lukea tekstiviestejä suoraan. Siksi Hätäkeskuksen viesti välitetään Tilannekarttaan henkilökohtaisella webhook-osoitteella ja Pikakomennot-automaatiolla.

Automaatio lähettää viestin Tilannekartan palvelimelle, joka lähettää puhelimeesi hälytysilmoituksen. Siksi iPhone tarvitsee hälytyshetkellä verkkoyhteyden.

Mikä iOS-versio puhelimessasi on?Valitse versioiOS 27 tai uudempiiOS 26 tai vanhempi (esim. iOS 17 tai 18)

Versio näkyy kohdassa Asetukset → Yleiset → Tietoja → iOS-versio. Kunnes valitset, sivulla näkyvät molempien versioiden ohjeet.

Video

Koko asennus videona: Palokuntahälytys iPhonessa: Pikakomennot-automaation asennus (YouTube)

Videot on kuvattu iOS 18:lla. iOS 27:ssä automaation luonti on erilainen, joten seuraa kohdan 3 iOS 27 -ohjetta.

Pakollinen ennen automaation luontia

Tallenna kaikki Hätäkeskuksen käyttämät hälytysnumerot puhelimeesi saman yhteystiedon alle, esimerkiksi nimellä Hätäkeskus. Automaatio käynnistyy vain tältä yhteystiedolta tulevista viesteistä. Jos jokin käytössä oleva numero puuttuu, siitä numerosta tuleva hälytys ei välity Tilannekarttaan.

Pidä webhook-osoite yksityisenä

Osoite on henkilökohtainen avain hälytystesi välittämiseen. Älä julkaise sitä tai lähetä sitä muille. Jos osoite on päätynyt vääriin käsiin, valitse iOS-asennus-kortista Osoite vuotanut? Luo uusi. Vanha osoite lakkaa toimimasta heti, joten kopioi uusi osoite automaatioon saman tien.

1. Hätäkeskuksen numerot

iOS 27:n valmiissa pikakomennossa lähettäjinä ovat numerot 0400 112 326 ja 0400 112 327, joten yhteystietoa ei tarvitse luoda. Tarkista silti aiemmista hälytysviesteistä, että omat hälytyksesi tulevat näistä numeroista. Jos jokin hälytys on tullut muusta numerosta, lisäät sen kohdan 3 vaiheessa 5.

Katso numerot aiemmista Hätäkeskuksen lähettämistä hälytysviesteistä. Luo yhteystieto nimellä esimerkiksi Hätäkeskus ja lisää jokainen käytössä oleva hälytysnumero saman yhteystiedon alle.

Tämä vaihe on pakollinen: iOS 17 ja uudemmat tarvitsevat yhteystiedon Viesti-automaation lähettäjäsuodattimeksi.

Mistä oikeat numerot löytyvät?

Tähän ohjeeseen ei ole lisätty valtakunnallista numerolistaa, koska julkisista viranomaislähteistä ei löytynyt varmennettua listaa hälytysviestien lähettäjänumeroista. Tarkista puhelimesta jokaisen aiemmin vastaanottamasi hälytysviestin lähettäjä tai varmista numerot oman palokuntasi ylläpitäjältä tai pelastuslaitokselta.

Älä oleta lähettäjäksi numeroa 112. Se on virallinen hätäilmoitusten vastaanottonumero, ei tässä ohjeessa varmennettu lähtevien hälytysviestien lähettäjänumero.

Lähettäjä vain käynnistimeen

Valitse Hätäkeskus-yhteystieto Viesti-automaation käynnistimeen (iOS 27: Kun saan viestin). POST-pyynnön JSON-runkoon ei lisätä sender-kenttää.

2. Valmistele Tilannekartta

1. Avaa Asetukset → Palokunta ja kytke palokuntahälytykset päälle.
2. Salli Tilannekartan push-ilmoitukset.
3. Vieritä kortille iOS-asennus (Pikakomennot) ja valitse Kopioi URL. Jos kortissa on painike Salli ilmoitukset, paina sitä ensin. Jos kortissa lukee Valmistellaan osoitetta…, odota hetki. Jos kortissa lukee Osoitetta ei saatu palvelimelta, tarkista verkkoyhteys ja paina Yritä uudelleen. Sovellus ei näytä osoitetta tekstinä, koska se on yksityinen.

Palokuntahälytysten kytkimen alla oleva Käyttövalmius näyttää, ovatko ilmoitukset, äänet ja kriittiset ilmoitukset sallittu ja onko webhook-osoite valmis. iOS ei kerro sovellukselle, onko Pikakomennot-automaatio olemassa, joten tarkista se itse Pikakomennoista.

Hälytystapa (asemakanavan jäsenet)

Jos kuulut asemakanavaan, kortilla on valinta Hälytystapa:

• Asemakanava: kun toisen jäsenen puhelin saa Hätäkeskuksen viestin ja avaa asemakanavan, hälytys soi myös tässä iPhonessa ilman omaa automaatiota.
• Pikakomento: hälytys tulee vain oman automaatiosi kautta.

Jos et valitse, palvelin päättää hälytyshetkellä: asemakanava soi, kun asemalla on Android-jäsen, jonka palokuntahälytykset ovat päällä. Jos oma pikakomentosi on toiminut viimeisen 14 vuorokauden aikana, asemakanava ei soita samaa hälytystä toista kertaa. Oma valinta Asemakanava ohittaa nämä säännöt.

3. Luo automaatio

iOS 27

Valmis pikakomento sisältää käynnistimen ja hälytysnumerot. Sinun tarvitsee vain liittää oma webhook-osoitteesi ja kytkeä automaatio päälle.

1. Paina Tilannekartan iOS-asennus-kortissa Lisää valmis pikakomento. Sovellus kopioi webhook-osoitteesi ja avaa valmiin pikakomennon. Paina Lisää pikakomento.
   Jos nappia ei näy, kopioi osoite kohdan 2 ohjeella (Kopioi URL) ja avaa pikakomento tästä: Avaa Tilannekartta-pikakomento
2. Avaa Pikakomennoissa lisätty pikakomento Tilannekartta vpk-sms. Napauta toiminnon Hae sisältö URLista tekstiä LISÄÄ_OSOITE_TÄHÄN, poista se ja liitä tilalle kopioimasi osoite.
3. Kytke automaatio päälle. Napauta käynnistimen Kun saan viestin, jossa oikeassa reunassa olevaa nuolta. Kytke Automaatio päälle ja pidä Vahvista ennen suorittamista pois päältä. Jaettu automaatio tulee aina pois päältä, joten ilman tätä hälytykset eivät tule perille.
4. Jos hälytyksesi tulevat muusta numerosta kuin 0400 112 326 tai 0400 112 327, napauta käynnistimessä Hälytys ja lisää numero.
5. Tallenna painamalla Valmis.

Jos vanha, itse tehty Hätäkeskus-pikakomento on yhä käytössä, poista se, jotta sama hälytys ei lähde kahdesti.

Rakenna pikakomento itse

1. Avaa Pikakomennot: paina Tilannekartan Asetukset → Palokunta → iOS-asennus (Pikakomennot) → Avaa Pikakomennot tai avaa Pikakomennot-sovellus kotinäytöltä.
2. Paina + ja luo uusi pikakomento.
3. Lisää pikakomennon alkuun käynnistin Kun saan viestin ja valitse Lähettäjä-kenttään yhteystieto, johon olet tallentanut kaikki Hätäkeskuksen hälytysnumerot.
4. Varmista, että käynnistin suoritetaan heti ilman vahvistusta: valitse Suorita välittömästi, tai jos näet kytkimen Vahvista ennen suorittamista, pidä se pois päältä.
5. Lisää toiminto Hae sisältö URLista ja liitä URL-kenttään Tilannekartasta kopioitu webhook-osoite.
6. Vaihda metodiksi POST ja pyyntörungoksi JSON.
7. Lisää avain body ja valitse arvoksi käynnistimen muuttuja Viesti. Älä valitse Pikakomennon syötettä. iOS 27:ssä se on automaatiossa tyhjä, jolloin hälytys ei tule perille.
8. Lisää ketjun viimeiseksi toiminto Lopeta tämä pikakomento ja tallenna painamalla Valmis.

Ketju on siis: Kun saan viestin → Hae sisältö URLista → Lopeta tämä pikakomento, ja JSON-rungossa on vain yksi kenttä: body → Viesti.

Pikakomennon yläosan rivi Vastaanota: Ei koskee jakovalikkoa, eikä sitä tarvitse muuttaa.

Päivitit iOS 27:ään ja hälytykset lakkasivat

Avaa Hätäkeskus-pikakomento ja tarkista body-kentän arvo. Jos arvona on Pikakomennon syöte, vaihda se käynnistimen muuttujaan Viesti.

iOS 26 ja vanhemmat

Kuvat ovat iOS 18:sta. Napauta kuvaa, niin se suurenee.

1. Avaa Pikakomennot: paina Tilannekartan Asetukset → Palokunta → iOS-asennus (Pikakomennot) → Avaa Pikakomennot tai avaa Pikakomennot-sovellus kotinäytöltä.
2. Valitse Automaatio → + → Uusi automaatio.
3. Valitse käynnistimeksi Viesti.
   
4. Valitse Lähettäjä-kenttään yhteystieto Hätäkeskus.
   
5. Valitse Suorita välittömästi ja paina Seuraava → Uusi tyhjä automaatio.
   
6. Lisää toiminto Hae sisältö URLista.
   
7. Liitä URL-kenttään Tilannekartasta kopioitu webhook-osoite.
   
8. Vaihda metodiksi POST ja pyyntörungoksi JSON.
   
9. Lisää avain body ja arvoksi automaation muuttuja Pikakomennon syöte.
   
10. Lisää ketjun viimeiseksi toiminto Lopeta tämä pikakomento.
    
11. Tallenna painamalla Valmis.
    

JSON-rungossa on siis vain yksi kenttä: body → Pikakomennon syöte.

Miksi Lopeta tämä pikakomento

Lopeta tämä pikakomento estää iOS:ää näyttämästä palvelimen vastauksesta ylimääräistä Valmis-ikkunaa jokaisen hälytyksen jälkeen. Se tarvitaan kaikissa iOS-versioissa.

4. Testaa

Paina Tilannekartan palokunta-asetuksissa Käyttövalmius → Äänitesti → Testaa hälytys. Tämä tarkistaa sovelluksen oman hälytysruudun ja äänen.

Testiviestiä ei tarvitse lähettää. Hälytysviestin tunnistus tarkistetaan automaattisesti: jos pikakomento lähettää palvelimelle viallisen pyynnön, Tilannekartta ilmoittaa siitä.

Testaa hälytys ja todellinen hälytys

Kun Soi äänettömällä ja Älä häiritse -tilassa on päällä ja ääneksi on valittu VIRVE-ääni tai oletusääni, testi soi kriittisenä ilmoituksena valitulla voimakkuudella. Jos se ei onnistu, sovellus kertoo sen, ja testi soi puhelimen soittoäänen voimakkuudella. Varmista äänettömän tilan läpäisy silti myös hälytyksellä, joka tulee Pikakomentojen kautta.

Hälytysääni ja äänetön tila

Valitse ääni kohdassa Asetukset → Palokunta → Hälytysääni:

• VIRVE-hälytysääni (oletus) soi äänettömän tilan ja Älä häiritse -tilan läpi, kun kytkin Asetukset → Palokunta → Äänetön ja Älä häiritse → Soi äänettömällä ja Älä häiritse -tilassa on päällä. Kytkin on oletuksena päällä ja käyttää iOS:n kriittisiä ilmoituksia (Critical Alerts). Ne ohittavat äänettömän tilan ja Älä häiritse -tilan yhdessä, joten iPhonessa kytkimiä on yksi, Androidissa kaksi.
• Oletusääni on iOS:n oma ilmoitusääni. Myös se soi äänettömän tilan ja Älä häiritse -tilan läpi, kun kytkin on päällä.
• Vain värinä tuo hälytysilmoituksen ilman ääntä.

Kun kytkin on pois päältä, sekä VIRVE-ääni että oletusääni noudattavat puhelimen tilaa. Muutos koskee heti myös taustalla tulevia hälytyksiä, eikä webhook-osoitetta tarvitse kopioida uudelleen.

Hiljennys kartalta

Kun Palokuntahälytykset ovat päällä, kartan oikeassa reunassa on kellopainike. Napauta sitä ja valitse 1 h, Aamuun klo 7 tai Toistaiseksi. Painike kytkee Soi äänettömällä ja Älä häiritse -tilassa -kytkimen pois valituksi ajaksi, ja ilmoitus kertoo, mihin asti.

• Hiljennettynä painike on oranssi ja kello yliviivattu. Napauta sitä, niin kytkin palaa heti päälle.
• Aikarajattu hiljennys päättyy itsestään, myös jos sovellus on suljettu. Aamuun klo 7 tarkoittaa seuraavaa kello 7.00:aa Suomen aikaa.
• Hiljennys tallentuu palvelimelle, koska taustalla tuleva hälytys rakennetaan siellä. Ilman verkkoyhteyttä hälytys soi edelleen äänettömän tilan läpi, kunnes tallennus onnistuu. Jos palautus ei tavoita palvelinta, sovellus kertoo sen ja yrittää uudelleen, kun avaat sen seuraavan kerran.
• Painiketta siirretään pitkällä painalluksella kuten muitakin karttapainikkeita.

Äänenvoimakkuus

Kohdassa Asetukset → Palokunta → Äänenvoimakkuus valitset hälytysäänen voimakkuuden päivällä ja yöllä.

• Taso koskee VIRVE-ääntä ja oletusääntä, kun Soi äänettömällä ja Älä häiritse -tilassa on päällä. Kun kytkin on pois päältä tai valintana on Vain värinä, hälytys soi puhelimen soittoäänen voimakkuudella, ja säätimet eivät ole käytössä.
• Täysi voimakkuus on oletuksena päällä: hälytys soi 100 %:n voimakkuudella. Kun kytket sen pois, valitset tason liukusäätimellä. iOS ei kerro sovelluksille soittoäänen voimakkuutta, joten tasoa ei voi asettaa automaattisesti soittoäänen mukaan.
• Hiljaisempi yöllä on oletuksena pois päältä. Kun kytket sen päälle, yöaika on 22.00–6.00 ja taso 30 %. Ajat ovat Suomen aikaa, myös kun olet ulkomailla.
• Alin taso on 10 %.
• Asetus tallentuu palvelimelle, koska taustalla tuleva hälytys rakennetaan siellä. Jos tallennus ei onnistu, esimerkiksi ilman verkkoyhteyttä, asetuksissa näkyy varoitus ja Yritä uudelleen -painike. Siihen asti taustahälytys soi aiemmalla voimakkuudella. Sovellus yrittää tallennusta uudelleen myös, kun avaat sen seuraavan kerran.
• Taso koskee vain yhtä hälytystä. Puhelimen omat voimakkuudet eivät muutu.

Tilannekartta ilmoittaa viallisesta pikakomennosta

Jos pikakomento lähettää palvelimelle pyynnön, josta hälytysviesti ei voi välittyä, saat Tilannekartalta tavallisen ilmoituksen, joka alkaa sanoilla Hälytykset eivät tule perille. Ilmoitus ei ole hälytys: se ei soi äänettömän tilan läpi eikä avaa hälytysruutua. Sama ilmoitus tulee enintään kerran vuorokaudessa, ja vain silloin, kun palokuntahälytykset ovat päällä.

Ilmoituksen otsikko	Korjaus pikakomennossa
Pikakomento ei lähetä JSON-runkoa	Avaa Hae sisältö URLista ja valitse Pyynnön runko: JSON (ei Lomake eikä Tiedosto).
Pikakomennosta puuttuu body-kenttä	JSON-kentän nimen on oltava body pienin kirjaimin.
Pikakomento lähettää tyhjän viestin	iOS 27: valitse body-kentän arvoksi käynnistimen muuttuja Viesti, ei Pikakomennon syöte. iOS 26 ja vanhemmat: arvona on Pikakomennon syöte.
Pikakomennon body-kenttä on väärää tyyppiä	Valitse kentän tyypiksi Teksti ja arvoksi muuttuja (iOS 27: Viesti).

Testiviestiä ei tarvita korjauksen jälkeen. Jos vika jatkuu, ilmoitus tulee uudelleen seuraavasta viallisesta pyynnöstä, enintään kerran vuorokaudessa.

Et muuttanut pikakomentoasi? Ilmoitus menee webhook-osoitteen omistajalle, ei sille puhelimelle, joka lähetti viallisen pyynnön. Jos joku muu, esimerkiksi toinen palokuntalainen, on kopioinut osoitteesi omaan pikakomentoonsa, hänen vikansa näkyy sinulle. Valitse iOS-asennus-kortista Osoite vuotanut? Luo uusi ja kopioi uusi osoite omaan pikakomentoosi. Jokaisen on kopioitava osoite omasta Tilannekartastaan.

Ilmoitus ei kata kaikkia vikoja. Se ei tule, jos automaatio ei käynnisty lainkaan, webhook-osoite on väärä tai viestiin päätyy muuta tekstiä kuin hälytys. Jos hälytyksiä ei tule eikä ilmoitusta näy, katso iPhone-automaatio ei käynnisty.

Jos automaatio pysähtyy vahvistukseen

Avaa automaatio ja varmista, että se suoritetaan heti ilman vahvistusta. Valinnan on oltava Suorita välittömästi. Jos iOS 27 näyttää kytkimen Vahvista ennen suorittamista, pidä se pois päältä. Varmista myös, että Hae sisältö URLista -toiminnolla on lupa käyttää verkkoa.