👨‍👩‍👧 Familiaren laguntzarekin konfiguratzeko gida

Ikuspegi orokorra: Magic Link nola funtzionatzen duen

Magic Link funtzioak pertsona teknologiko batek ("administratzaileak") konfigurazio lan guztia egin eta esteka berezi gisa partekatzeko aukera ematen du. Pertsona helduak bere telefonoan esteka hori sakatzean, TapAlert-ek automatikoki konfigurazio osoa aplikatzen du — kontaktuak, mezuak, ezarpenak eta dena — urrats bakar batean.

Admin's phone                         Senior's phone
─────────────────────────────────     ─────────────────────────────────
1. Open Admin Setup screen       →    (senior does nothing yet)
2. Fill in all configuration
3. App tests and validates
4. Generate Magic Link           →    (link shared via WhatsApp, email, etc.)
                                       5. Senior taps the link
                                       6. TapAlert opens and asks to confirm
                                       7. Senior taps "Apply" → app is ready!

Pertsona helduak ez du inoiz ezer idatzi behar ezta ezarpenetan nabigatu ere.

Hasi aurretik: Zer beharko duzun

Alertak nola bidali nahi dituzun arabera, bildu hauek hasi aurretik:

Beti beharrezkoa

• Pertsona helduaren izena (alerta mezuak pertsonalizatzeko)
• Alertak jaso behar dituzten pertsonen telefono zenbakiak (familia, auzokoak, etab.)

Aukerazkoa: Twilio bidezko SMS automatikoak egiteko

Alertak automatikoki bidali nahi badituzu pertsona helduaren telefonoan inongo aplikaziorik ireki gabe:

• Twilio kontu bat (doako proba twilio.com-en eskuragarri)
• Twilio Account SID (Twilio Console paneletik)
• Twilio Auth Token (Twilio Console paneletik)
• Twilio telefono zenbaki bat, EDO igorle izen alfanumeriko bat (adib., "TapAlert") zure herrialdeak onartzen badu
• Zure telefono zenbakia — aplikazioak proba SMS bat bidaliko du Twilio funtzionatzen duela egiaztatzeko

Aukerazkoa: Posta elektronikoaren erredundantziarako

Alertak SMS ez ezik posta elektroniko bidez ere bidali nahi badituzu:

• Bidaltzeko posta elektroniko helbide dedikatu bat (Gmail, Outlook, iCloud, Yahoo edo pertsonalizatua)
• Kontu horretarako App Pasahitz bat (ikusi 4. urratsa behean)

1. urratsa: Administratzaile konfigurazioa ireki zure telefonoan

1. Instalatu TapAlert zure telefonoan (Magic Link sortzeko aplikazioa behar duzu).
2. Ireki TapAlert.
3. Oraindik onboardinga osatu ez baduzu, baimenaren pantailak egin. Azken pantailan, sakatu "Beste norbaitzarako konfiguratu".
4. TapAlert dagoeneko instalatuta badago, joan Ezarpenak → joan behera → sakatu "Admin konfigurazioa / Magic Link".

Admin konfigurazio pantaila irekiko da. Ibili sekzioen artean — beheko urratseetan bakoitza beteko duzu.

2. urratsa: Pertsona helduaren izena sartu

"Erabiltzaile informazioa" atalean, pantailaren goialdean:

• Pertsona helduaren izena — Idatzi bere izena (adib., "Maria"). Izen hau alerta mezuetan agertuko da hartzaileek nor bidali duen jakiteko.

3. urratsa: SMS bidalketa konfiguratu (Twilio)

A aukera: Twilio gabe (sinpleena)

Utzi "Twilio SMS gaitu" txandakatzailea itzalita.

• Androiden, aplikazioak SMS bidaltzen ditu zuzenean SIM txartela erabiliz — ez da Twilio behar.
• iPhonean, aplikazioak Mezuak aplikazioa beteta irekitzen du eta pertsona helduak Bidali behin sakatu behar du. Sinplea baina urrats gehigarri bat.

B aukera: Twilio-rekin (automatizazio osoa lortzeko gomendatua)

1. Piztu "Twilio SMS gaitu" txandakatzailea.
2. Sartu zure Twilio kontsola-ko Account SID ("AC…"-rekin hasten da).
3. Sartu zure Twilio kontsola-ko Auth Token (begi ikonoa sakatu erakusteko/ezkutatzeko).
4. Aukeratu igorlea nola identifikatu:
   • Twilio zenbakia — Sartu Twilio zenbakia (adib., +12015551234). Aukeratu lehenik herrialde bandera.
   • Igorle izena — Piztu "Igorle izen alfanumerikoa" eta idatzi izen labur bat (adib., "TapAlert"). Oharra: ez da herrialde guztietan onartzen (adib., EEBB).
5. Zure zenbakia — Sartu zure zenbakia. Aplikazioak proba SMS bat bidaliko du esteka sortu aurretik Twilio funtzionatzen duela berresteko.

4. urratsa: Posta elektronikoaren alertak konfiguratu (aukerazkoa)

Posta elektronikoko alertak alerta bakoitzaren kopia bidaltzen du posta helbidea duten hartzaileei. SMS huts egiten badu lagungarria da.

1. Piztu "Posta elektronikoaren erredundantzia gaitu" txandakatzailea.
2. Aukeratu zure posta hornitzailea: Gmail, Outlook, Hotmail, Yahoo Mail, iCloud Mail (ezarpenak automatikoki beteta) edo SMTP pertsonalizatua.
3. Sartu bidaltzeko posta helbidea — ahal bada, helbide dedikatu bat, ez pertsona helduaren posta pertsonala.
4. Sartu kontu horretarako App Pasahitza.

Nola lortu App Pasahitz bat

Ohiko posta pasahitzak ez dira funtzionatuko. Posta hornitzaileek App Pasahitzak eskatzen dituzte SMTP bidez konektatzen diren aplikazioetarako.

Gmail

1. Joan myaccount.google.com → Segurtasuna
2. Gaitu 2 urratseko egiaztapena oraindik aktibatuta ez badago
3. Itzuli Segurtasuna → "Aplikazioen pasahitzak"
4. Sortu App Pasahitz berri bat, izendatu "TapAlert", kopiatu 16 karaktereko kodea

Outlook / Hotmail

1. Joan account.live.com/proofs/manage
2. "Aplikazioen pasahitzak" atalean, sortu "TapAlert" izena duen berri bat

Yahoo Mail

1. Joan account.yahoo.com/security
2. "Aplikazioen pasahitzak" atalean, sortu "TapAlert" izena duena

iCloud Mail

1. Joan appleid.apple.com → Saioa hasi eta segurtasuna → App pasahitz espezifikoak
2. Egin klik + botoian, izendatu "TapAlert" eta kopiatu pasahitza

5. urratsa: Larrialdi kontaktuak gehitu

"Larrialdi kontaktuak" atalean, pertsona helduaren alertak jaso behar duen pertsona bakoitzarentzat:

1. Sartu bere izena Izen eremuan (adib., "Carlos" edo "Dr. García").
2. Sartu bere telefono zenbakia — aukeratu lehenik herrialde bandera egokia eta idatzi zenbakia.
3. Sakatu + botoi urdina zerrendara gehitzeko.
4. Errepikatu kontaktu bakoitzarentzat. Behar adina gehitu dezakezu (50 arte premium-arekin; doako bertsioak 1 onartzen du).

Kontaktu bat kentzeko, sakatu bere izenaren ondoko zakarrontzi gorri ikonoa.

6. urratsa: Aurrez konfiguratutako alerta-mezuak idatzi

«Alerta-mezuak» atalean, erabilerako prest dauden 3 mezu idatz ditzakezu:

• 1. mezua — Larrialdietako mezu nagusia (adib., «Laguntza behar dut, deitu iezadazu»)
• 2. mezua — «Ongi nago» edo egiaztapen-mezu bat (adib., «Ongi nago, ez kezkatu»)
• 3. mezua — Beste mezu pertsonalizatu bat (adib., «Erori naiz, mesedez etorri»)

Hauek botoi handi gisa agertuko dira nagusiaren pantaila nagusian, behin ukituz alerta bidal dezan, ezer idatzi gabe.

7. urratsa: Aplikazioaren ezarpenak aukeratu

«Aplikazioaren ezarpenak» atalean, konfiguratu nola jokatzen duen aplikazioak nagusiarentzat:

Alertaren atzerako kontaketa

Nagusiak alerta-botoia sakonduta, zenbat segundu itxaron bidalketa egin baino lehen.

• 0 segundo — berehala bidaltzen du, ezin da bertan behera utzi
• 3–10 segundo — nagusi gehienentzat gomendatua; denbora ematen du bertan behera uzteko oker sakonduz gero
• 15–30 segundo — nagusiak ustekabean ukitzeko joera badu

Aktibazio-modua

• Ukitu bakarra — behin ukitu atzerako kontaketa hasteko (errazagoa mugikortasun mugatua duten nagusientzat)
• Eutsita mantendu — eutsita mantendu botoia berresteko (ustekabean bidaltzea ekiditzen du)

Itxura

• Sistemaren lehenetsia — telefonoaren argi/ilun modu-ezarpena jarraitzen du
• Modu argia — atzealdia beti argia
• Modu iluna — atzealdia beti iluna (begiei erosoagoa argi gutxirekin)

Hizkuntza

Hautatu aplikazioaren interfazerako hizkuntza. Erabilgarri: English, Español, Català, Français, Deutsch, Italiano, Nederlands, Português, Euskara, Galego.

8. urratsa: Magic Link sortu eta partekatu

Atal guztiak bete ondoren:

1. Mugitu pantailaren beheraino.
2. Sakatu «Magic Link sortu eta partekatu» botoia (botoi urdin handia).

Jarraian zer gertatzen den:

Proba-fasea (segundo batzuk behar ditu):

• Twilio gaituta badago: aplikazioak proba-SMS bat bidaltzen du zure telefono-zenbakira funtzionatzen duela egiaztatzeko. SMS hau segundu gutxitan jaso beharko zenuke.
• Posta elektronikoa gaituta badago: aplikazioak proba-mezu bat bidaltzen du sartu duzun posta-helbidera. Egiaztatu zure sarrerako ontzia.
• Probak huts egiten badute, errore-mezu bat agertzen da. Egiaztatu zure egiaztagiriak eta saiatu berriro.

Partekatzeko fasea:

• Sistemaren partekatzeko orria automatikoki irekitzen da.
• Bidali Magic Link nagusiari WhatsApp, iMessage, posta elektroniko, SMS edo erabiltzen duzun mezularitza-app baten bidez.

9. urratsa: Nagusiak Magic Link irekitzen du

Nagusiaren telefonoan (TapAlert instalatuta):

1. Nagusiak bidali zenion mezua jasotzen du.
2. Esteka sakatzen du.
3. TapAlert automatikoki irekitzen da eta baieztapen-pantaila bat erakusten du: «Prest [Izena]rentzat TapAlert konfiguratzeko?» konfiguratuko denaren laburpenarekin.
4. Nagusiak «Bai, konfiguratu» sakatzen du (edo baliokidea den botoia).
5. Aplikazioak konfigurazio osoa momentuan aplikatzen du.
6. Arrakasta-mezu bat agertzen da eta aplikazioa pantaila nagusira irekitzen da — erabiltzeko prest.

Hori da dena. Nagusiak ez du ezarpen, egiaztagiri edo aukerarik sartu behar.

TapAlert oraindik nagusiaren telefonoan instalatuta ez badago

1. Lehenik instalatu TapAlert App Store-tik (iOS) edo Google Play-tik (Android).
2. Pasa baimen-pantailatik (kokapena, mikrofonoa, kontaktuak, jakinarazpenak).
3. Ondoren sakatu Magic Link — onboarding-ean zehar aplikatuko da.

10. urratsa: Dena funtzionatzen ari dela egiaztatu

Magic Link aplikatu ondoren, proba azkar bat egin:

1. Ireki TapAlert nagusiaren telefonoan.
2. Nagusiaren izena hasierako pantailan ikusi beharko zenuke.
3. Sakatu alerta-botoietako bat.
4. Itxaron atzerako kontaketari (edo bidali berehala kontaketa 0 bada).
5. Egiaztatu konfiguratutako kontaktu guztiek SMS jasotzen dutela (eta posta elektronikoa, konfiguratuta badago).
6. Egiaztatu mezuaren testua eta kokapen-esteka zuzenak direla.

Konfigurazio ostean: Nagusiak zer ikusten duen

Nagusiaren aplikazioa zuzenean Izualdeko Moduaren pantailara irekitzen da — pantaila osoko larrialdi-botoi sinplea. Interfazea irakurri gabe erabiltzeko diseinatuta dago:

• Botoi gorri handi SOS erdian — sakatu larrialdi-alerta bidaltzeko
• Botoi berde handi OK behean — sakatu «Ongi nago» mezu bat bidaltzeko
• Irristatu ezkerrerantz aurrez konfiguratutako mezu-botoiak ikusteko (mezuak konfiguratu baziren)

Nagusiak ez du inoiz Ezarpenetan sartu behar ez eta ezer nola funtzionatzen duen ulertu.

Hainbat nagusi konfiguratu

TapAlert hainbat nagusirentzat konfiguratu dezakezu, aldiro hasieratik hasi gabe:

1. Lehen Magic Link sortu ondoren, sakatu «Beste nagusi bat konfiguratu» bukaera-elkarrizketan.
2. Inprimakiak nagusiaren izena eta kontaktuak garbitzen ditu, baina zure Twilio egiaztagiriak, posta ezarpenak eta aplikazioaren hobespenak gordetzen ditu.
3. Aldatu soilik desberdina dena (izena, kontaktuak, mezuak) hurrengo nagusiarentzat.
4. Sortu eta partekatu Magic Link berri bat.

Arazoen konponketa

"Balioztatze-hutsa" errorea esteka sortzean

• Egiaztatu beharrezko eremu guztiak beterik daudela (mezu gorri batekin markatuta).
• Twilio gaituta badago, ziurtatu Account SID, Auth Token eta telefono-zenbakia zuzenak direla.
• Posta elektronikoa gaituta badago, egiaztatu App Pasahitza — kontu-pasahitz arruntek ez dute funtzionatuko.

Nagusiak ez du proba-SMS jaso

• Egiaztatu Twilio telefono-zenbakia aktibo dagoela eta ez dela proba-zenbaki bat egiaztatu gabeko zenbakietara bidaltzen.
• Twilio-ren doako probaldian, Twilio Kontsolan egiaztatu dituzun telefono-zenbakietara soilik bidali dezakezu. Gehitu nagusiaren kontaktuak egiaztaturiko zenbaki gisa, edo igo kontu ordainpekora.
• Egiaztatu telefono-zenbakiaren formatua zuzena dela (herrialdeko kodea barne).

Magic Link-ek ez du TapAlert irekitzen

• Ziurtatu TapAlert nagusiaren telefonoan instalatuta dagoela.
• Android telefono batzuetan, eutsita sakatu esteka eta hautatu "Ireki TapAlert-ekin" nabigatzaile baten ordez.
• Horren ordez nabigatzaile bat irekitzen bada, kopiatu URL osoa eta itsatsi berriro nabigatzailean — bigarren saiakeran, sistemak normalean TapAlert aukera eskaintzen du.

Nagusiak ustekabean botoi okerra sakatzen du

• Handitu Alertaren atzerako kontaketa 10–15 segundura — honek bidaltzeko denbora eman baino lehen bertan behera uzteko denbora ematen du.
• Edo aldatu Eutsita mantentze modura (aktibazio-modua = eutsita mantendu) botoiak nahita sakatzea eskatzen duen.
• Ezarpen hauek eguneratu ditzakezu zuzendutako ezarpenekin Magic Link berri bat sortuz eta nagusiaren telefonora bidaliz.

Twilio SMS funtzionatzen du baina ez posta elektronikoa

• Kausa ohikoena: hartzaileek ez dute posta-helbiderik gordeta. Egiaztatu hartzaileak aplikazioaren Hartzaileak pantailan.
• Ziurtatu App Pasahitza zuzena dela eta ez dela iraungitu. Gmail eta Outlook-en App Pasahitzak baliogabetu daitezke — sortu berri bat behar izanez gero.

Segurtasun eta pribatutasun oharrak

• Magic Link-aren karga kodetuta dago baina ez enkriptatuta. Atzeman dezakeen edonork konfigurazioa irakur dezake, Twilio egiaztagiriak barne. Partekatu zuzenean nagusiarekin soilik.
• TapAlert-ek ez ditu zerbitzaririk — Magic Link nagusiaren gailuan prozesatzen da guztiz. Ez da daturik TapAlert zerbitzura bidaltzen.
• Twilio egiaztagiriak estekaren barruan nagusiaren gailuan lokalki gordetzen dira biltegiratze seguruan (enkriptatua) aplikatu ostean.
• Magic Link bat atzeman dutela uste baduzu, biratu zure Twilio Auth Token Twilio Kontsolan berehala eta sortu Magic Link berri bat.

Erreferentzia azkarreko txartela (nagusiarentzat inprimatzeko)

┌─────────────────────────────────────────────┐
│            YOUR TAPALERT BUTTONS            │
│                                             │
│  🔴  Big red button  →  Send EMERGENCY      │
│                          alert to family    │
│                                             │
│  🟢  Green button    →  Send "I'm OK"       │
│                          message            │
│                                             │
│  📱  Swipe left      →  More message        │
│                          options            │
│                                             │
│  ────────────────────────────────────────   │
│  After tapping, you have N seconds          │
│  to cancel before it sends.                 │
│  Just press the X button to cancel.         │
└─────────────────────────────────────────────┘

Bete konfiguratu zenuen atzerako kontaketaren denbora (adib., "10 segundo").