9. 7stamp Scanner Application — Manual / Autopilot / Kiosk

7stamp Scanner ni app ya kazi kwa staff na wateja. Kazi yake ni kubadilisha scan ya Card kuwa stamping, voucher redemption, na lottery spinning. Hicho ndicho kinachokaa kimwili kwenye till, mfukoni mwa staff, au kwenye stand inayomkabili mteja. Staff Login moja inatoa ufikiaji wa modes zote tatu — uchaguzi wa mode hutegemea kasi ya biashara yako na scenario ya huduma.

9.1 Mahali 7stamp Scanner inapoendesha

Web version (kifaa chochote): scanner.7stamp.com

Hufanya kazi kwenye browser yoyote ya kisasa: kwenye smartphone, tablet, au computer.
Hakuna install — fungua ukurasa, weka Staff Login yako, na uanze kazi.
Inafaa kwa laptop ya pamoja kazini karibu na till, tablet kwenye stand, au kifaa chochote cha Windows/Mac/Linux chenye kamera.
Unaweza kuunganisha scanner ya nje na kuscan Card za wateja nayo. Hakuna configuration inayohitajika.

Android: Google Play iOS: App Store

Native app — inaenda haraka zaidi na hutumia kamera ya simu vizuri zaidi.
Inafaa kwa staff wanaofanya kazi kwa simu zao wenyewe (premium service, field work, delivery).
Unaweza kuunganisha scanner ya nje na kuscan Card za wateja nayo (na katika hali hiyo fikiria Autopilot mode).
Inaweza kuendeshwa kwenye tablet ndani ya Kiosk mode.

Cha kuchagua. Ikiwa una Android tablet kwenye till au iPad kwenye counter — sakinisha native app. Ikiwa unafanya kazi kutoka vifaa tofauti au unatumia computer moja ya pamoja kwenye till — chagua web version https://scanner.7stamp.com. Login na password za kuingia huundwa kwenye admin panel chini ya Staff.

Unaweza kuingia kutoka platform yoyote (Web / Android / iOS) kwa kutumia Staff Login ileile uliyounda kwenye admin (Staff → + CREATE → Creating Staff Login). Baada ya login, app hujifunga kiotomatiki na business profile yako.

Side menu (hufunguka kwa icon ya ☰ juu kushoto):

Manual Mode — mode ya manual scanning (default).
Kiosk Mode — mode ya self-service ya mteja.
Open Admin Panel — quick link kwenda admin (admin.7stamp.com).
Log Out — kutoka kwenye akaunti (chini ya menu, red button).

Huhitaji “kubadilisha modes” kati ya Manual na Autopilot kupitia menu. Autopilot ni sub-mode ya Manual Mode, inayowashwa kwa switch moja moja kwa moja kwenye screen kuu (tazama hapa chini).

9.3 Manual Mode — staff inascan kwa mkono

Manual Mode ndiyo scenario ya msingi ambapo staff inascan Card ya mteja yenyewe. Hutumika kwenye premium service (beauty salons, barbershops, spa, sit-down restaurants) ambapo stamping ni sehemu ya mawasiliano ya kibinafsi na mteja.

Screen kuu ya Manual Mode

Header indicator: Waiting for the card scan — app iko tayari kupokea scan.
Juu kulia — switch ya Auto-Stamp (Scanner Only) (imezimwa kwenye Manual).
Chini ya screen — recent shift event log (issued / used / deleted vouchers). Kila entry inaweza kuguswa na kufungua details.
Mwisho kabisa wa screen — action buttons mbili:
- 🔍 Search Customer — tafuta mteja kwa jina, email, simu, au nambari ya Card.
- 📷 Use Camera — fungua kamera ya kifaa na uscan QR ya Card ya mteja.

Njia nne za kumpata mteja na kufanya stamping ya Card

1. Kuscan kwa kamera ya kifaa (Use Camera). Hii ndiyo njia kuu ya kufanya kazi.

Mtu wa staff hugusa Use Camera, anaelekeza kamera ya simu/tablet kwenye QR ya Card ya mteja (mteja hufungua Card yake kwenye Apple Wallet au Google Wallet na kuonyesha screen), app hutambua code ndani ya sekunde ndogo na kufungua mara moja Card ya mteja.

2. Kuscan Card ya mteja kwa scanner ya nje.

Unganisha scanner kwenye kifaa chako kisha uscan Card ya mteja nayo tu.

3. Customer search (Search Customer). Fallback wakati mteja hana simu yake mkononi.

Inafaa wakati:

mteja ameiacha simu au battery imeisha;
mteja amesajiliwa sasa hivi na bado hajajua Card inafungukaje;
mtu wa staff anafanya kazi kwa appointment na hufungua Card ya mteja mapema.

Search hufanya kazi kwa jina, email, au nambari ya Card.

4. Direct voucher search (Voucher Search). Wakati mteja anafika akiwa tayari na voucher mkononi (kwa mfano iliyochapishwa kwenye karatasi) na anataka kuikomboa. Unaweza kuingiza nambari ya voucher kwenye search, kuiscan kwa scanner ya nje, au kuiscan kwa kamera ya kifaa.

Card ya mteja baada ya scan

Baada ya Card kupatikana, customer card hufunguka ikiwa na tabs mbili:

Info — taarifa za msingi (jina, email, Card ID #XXXXXX, birthday yenye edit ✏️).
Vouchers (N) — orodha ya voucher zote za mteja huyu: active, redeemed, expired.

Kwenye eneo la juu kuna red button ya Reset stamps — hukuruhusu kurudisha Stamp za mteja mwanzo (kwa mfano, ikiwa amefunga final goal, amepata Reward, na unataka kuanza Card mpya). Kumbuka. Huhitaji ku-reset Card: ukiscan tena wakati ujao akiwa kwenye final goal bila ku-reset, mfumo utaweka kwa mzunguko Stamp ya kwanza ya iteration mpya.

Vidhibiti vya Stamp

Chini ya screen — vidhibiti vya Stamp:

🟢 + (green) — ongeza Stamp.
🔴 − (red) — ondoa Stamp (ukifanya makosa).
Quantity field yenye − / + — ongeza Stamp kadhaa mara moja (kwa mfano kama Card inatumia By amount na mteja ametumia kiasi kikubwa).
🔍 Search Customer — fungua mteja mwingine.
📷 — scan tena.

Scenarios tatu za kufika kwenye goal

Stamp inapomfikisha mteja kwenye goal (milestones au final goal), Scanner huonyesha popup yenye zawadi. Yaliyomo kwenye popup hutegemea Reward type iliyowekwa kwenye Card.

1. Reward = Award (zawadi ya maandishi ya papo hapo).

Kwenye screen — maandishi na picha ya zawadi (“Free Coffee”, “1 free pastry”, n.k.). Mtu wa staff humwonyesha mteja screen hiyo na kumpa zawadi iliyoahidiwa.

2. Reward = Voucher (Smart Voucher with Redeem Code).

Popup ya Voucher Unlocked! yenye picha, kichwa cha voucher, na nambari ya voucher #XXXXXXX. Actions tatu:

Use Voucher (green button) — komboa voucher moja kwa moja ndani ya Scanner. Ikiwa voucher ina option ya Redeem Code imewashwa, screen itaonyesha code text + QR + barcode. Staff huingiza / kuscan code kwenye POS. Voucher huhamia hali ya redeemed na haiwezi kutumika tena.
See All Vouchers — fungua orodha ya voucher zote za mteja (kwa mfano ikiwa mteja anataka kukomboa voucher nyingine kwanza).
Close — funga popup; voucher hubaki active na mteja anaweza kuitumia baadaye.

3. Reward = Lottery (droo).

Screen ya lottery hufunguka kwenye kifaa cha staff. Staff humpa mteja kifaa (au humwonyesha screen) na kumwomba aguse “Play”. Baada ya spin, mojawapo ya Variants hutokea kisha hushughulikiwa kama Award au Voucher (tazama juu).

Ukombozi wa voucher na mteja mwenyewe kwenye Manual mode

Ikiwa mteja anafika kwa zawadi aliyoahidiwa baadaye (si mara tu baada ya kuipokea), staff hufungua Card yake na kubadilisha kwenda tab ya Vouchers (N). Voucher zote za mteja zinaonekana hapa. Staff hugusa ile sahihi → voucher hufunguka na Use Voucher → thibitisha → status redeemed.

Security: state machine ya Voucher (issued → active → redeemed → expired) huzuia matumizi ya mara mbili. Baada ya redeemed, voucher (au screenshot yake) haitafanya kazi tena.

9.4 Autopilot Mode — background scanning kwenye till

Autopilot Mode ni sub-mode ya Manual Mode ambamo Stamp huongezwa kwenye background, bila confirmations na bila modals. Inafaa kwa peak hours kwenye coffee shop, fast food, bakery, car wash — mahali popote penye foleni na ambapo huduma haiwezi kupungua kasi.

Jinsi ya kuiwasha

Kwenye screen kuu ya Manual Mode, geuza switch ya Auto-Stamp (Scanner Only) iliyo juu kulia kuwa “on” (green). Screen hubadilika:

Icon hubadilika na kuwa picha ya external scanner.
Header kuu husomeka: Auto-Stamp Mode Active.
Subheader: “The system stamps automatically only for scanner input.”

Jinsi inavyofanya kazi

Kauli ya “Scanner Only” ina maana kwamba kwenye mode hii Stamp huongezwa tu kupitia input kutoka hardware scanner (USB au Bluetooth barcode scanner ya nje iliyounganishwa kwenye computer/tablet). Buttons za Use Camera na Search Customer hubaki kuonekana kwenye screen na zinapatikana ukizihitaji, lakini hazitumiki kwenye operesheni ya kawaida ya Autopilot — ni backup (kwa mfano scanner isipomkamata mteja na ukahitaji kumtafuta kwa mkono).

Workflow:

Staff huchukua order kama kawaida (kwenye till, kaunta ya bar, au car wash).
Wakati wa malipo au mara tu baada yake, mteja huonyesha Wallet Card yake.
External scanner hushika QR “kama barcode”.
7stamp Scanner huongeza Stamp kwenye Card ya mteja background.
Hakuna modal — foleni haisimami.
Mteja huona progress update baadaye kwenye Wallet kupitia PUSH notification.

Unachohitaji

Barcode scanner: USB au Bluetooth, inayoweza kusoma QR codes. Models za kawaida kutoka Honeywell, Zebra, Datalogic zinatosha. Scanner inapaswa kuwekwa kwenye keyboard emulation (HID mode).
Kifaa cha kudumu kwenye till: laptop au tablet yenye scanner.7stamp.com wazi au yenye Android/iOS app.
Internet thabiti — kila Stamp huenda cloud kwa wakati halisi.

Ukombozi wa voucher na mteja mwenyewe kwenye Autopilot

Katika Autopilot staff haiscani Wallet Card kimwili kwenye “dialog mode” — inahudumia foleni. Lakini mteja anaweza kutumia voucher yake papo hapo, na hilo halihitaji kubadilisha modes. Kwenye ukurasa wa Card ndani ya Wallet mteja ana link ya voucher zake. Akiufungua, mteja ama:

humwambia cashier Redeem Code kwa sauti, ambaye huiingiza kwenye till (ikiwa till inaunga mkono promo codes), au
huonyesha QR/barcode kwenye screen ya simu yake, na cashier huiscan kwa external scanner.

Baada ya hapo voucher huhamia redeemed na haiwezi kutumika tena. Kama njia mbadala, cashier anaweza kuzima kwa muda switch ya Auto-Stamp, kufungua Card ya mteja kwa mkono, na kukomboa voucher kwa Use Voucher.

Wakati wa kurudi kwenye Manual

Wakati wowote staff inaweza kuzima switch ya Auto-Stamp na kurudi kwenye manual scanning — kwa mfano ikiwa mteja anakuja na tatizo (amepoteza voucher, anataka kurekebisha Stamp kwa mkono) au unahitaji kumtafuta kwa jina/email. Vipengele vyote vya Manual Mode vinapatikana — search, camera scan, utoaji wa voucher kwa mkono, na redemption.

9.5 Kiosk Mode — self-service ya mteja

Kiosk Mode ni full-screen self-service mode ambamo tablet humkabili mteja na mteja anascan Card yake mwenyewe. Staff haihusiki kabisa kwenye mchakato — ndiyo maana kuna “zero staff training”. Inafaa kwa coffee shops, bakeries, fast casual restaurants, light retail, na car washes.

Kuweka Kiosk Mode

Step 1. Badilisha kwenda Kiosk.

Kwenye side menu (☰) chagua Kiosk Mode. App huingia setup mode.

Hakikisha unasoma tips za kwenye screen kuhusu jinsi ya “kupin” app kwenye Android tablet au iPad ili mteja asiweze kuiminimize au kuifunga (hiki ndicho kinachoitwa Kiosk mode ya kifaa). Hizi ni system features za tablet yako — soma hint iliyo kwenye screen yetu, au manual ya kifaa chako.

Step 2. Chagua Card itakayoonyeshwa.

Ikiwa biashara yako ina Stamp Cards kadhaa (kwa mfano Card tofauti ya kahawa na nyingine ya pastry), chagua ile itakayoonyeshwa kwenye tablet hii mahsusi. Unaweza kusanidi tablets kadhaa kwa Card tofauti.

Step 3. Options za ziada.

Settings za ziada za kuanzisha Kiosk.

Kwanza — color scheme. Unaweza kuzindua Kiosk kwa palette ya Card yako au kuchagua mojawapo ya sets zetu zilizotayarishwa. Jaribu option inayoonekana vizuri zaidi kwako!

Option muhimu zaidi ni Prevent Immediate Scans. Hii humzuia mteja yuleyule kupata Stamp mara mbili mfululizo: ikiwa option imewashwa, repeat scan humwonyesha tu mteja matokeo yake ya awali (Reward / screen ya mwisho iliyoonyeshwa), na hakuna Stamp inayoongezwa. Hii hulinda dhidi ya accidental double scans kwenye counter.

Baada ya confirmation — Kiosk huzinduliwa.

Screen kuu ya Kiosk Mode

Anachokiona mteja anapokaribia tablet:

Juu kabisa — logo na jina la biashara yako (vimetolewa kutoka settings za Card).
Header: Collect Stamps Get Rewards.
Carousel ya Your Reward — huonyesha zawadi ya mwisho (na, ukiwa na milestone rewards, zote za katikati pia). Inaweza kuswipewa.
Black button kubwa ya 📱 Scan your card yenye sublabel “Get your next stamp by scanning the card.” (au “Hold your phone near the reader” — maandishi hubadilika kulingana na hali).
Chini — block ya wateja wapya: No Card Yet? “Scan QR-Code and add card to Your wallet” pamoja na QR ya join page.

Scenario ya mteja kwenye Kiosk Mode

Mteja anakuja kwenye stand ya tablet.
Ikiwa tayari ana Card → fungua Wallet → gusa Scan your card → weka screen ya Wallet karibu na kamera ya tablet → Stamp inaongezwa.
Ikiwa bado hana Card → scan QR ya No Card Yet? kwa kamera ya simu yake → Card huhifadhiwa mara moja kwenye Wallet → gusa Scan your card → pata Stamp yake ya kwanza.

Anachokiona mteja anapofika kwenye goal

Reward = Award.

Screen ya full-screen ya Congratulations! yenye picha na maelezo ya zawadi. Mteja humwonyesha staff screen hiyo na kuchukua zawadi iliyoahidiwa.

Reward = Voucher.

Screen ya Congratulations! Voucher Unlocked! yenye voucher card. Mteja anaweza kukomboa voucher mwenyewe moja kwa moja ndani ya Kiosk — use button hufungua screen yenye Redeem Code (text + QR + barcode) ambayo mteja humwonyesha cashier, naye huiscan au kuiingiza kwenye till. Baada ya redemption voucher huhamia redeemed na haiwezi kutumika tena, hata kama mteja ameweka screenshot.

Chini — buttons:

My Vouchers — tazama voucher zangu zote.
Closing in 12s — countdown ya kurudi kiotomatiki kwenye screen kuu.

Huu ni muundo muhimu wa Kiosk: auto-close. Bila huu, tablet ingebaki “imekwama” kwenye screen ya mteja mmoja mpaka staff iingilie. Countdown huhakikisha tablet inarudi kila wakati kwenye screen safi ya kuanzia sekunde 10–15 baada ya action.

Reward = Lottery.

Mteja huzungusha lottery mwenyewe kwenye screen — game mechanic ya kupendeza. Baada ya Variant kutoka, screen hujionyesha kama Award au Voucher hapo juu.

Kuangalia voucher za mteja

Wakati wowote mteja anaweza kugusa My Vouchers kwenye screen kuu ya Kiosk na kuona voucher zake zote active. Hii ni rahisi: ikiwa mteja ana voucher ambayo haijatumika kutoka ziara ya awali, anaweza kuionyesha staff mara moja bila kufungua Wallet.

Mahitaji ya kiufundi kwa stand ya Kiosk

Tablet: iPad / Android tablet ya 10” au 12”. Kadri screen inavyokuwa kubwa, ndivyo inavyokuwa rahisi zaidi kwa mteja. Tunapenda iPad mini.
Stand: iwe imesimama, imemkabili mteja. Stand inapaswa kumruhusu mteja kuleta simu yenye Wallet karibu na kamera ya tablet.
Power: muunganisho wa umeme wa kudumu. Kiosk huendesha siku nzima.
Internet: Wi-Fi ya kuaminika au mobile 4G.
Optional — instruction card rahisi karibu na stand: “1) Open your card in Wallet. 2) Hold it up to the camera. 3) Done!” — kwa lugha mbili ikiwa una wageni wa kimataifa. Ingawa tablet iliyowekwa vizuri yenye Kiosk UI yetu kwa kawaida hushughulikia kazi hii yenyewe.

9.6 Jinsi ya kuchagua mode — ulinganisho

Parameter	Manual Mode	Autopilot Mode	Kiosk Mode
Nani anascan	Staff kwa simu/kamera	External scanner “kama barcode”	Mteja mwenyewe kwenye stand
Aina ya biashara	Premium service, salons, restaurants	Coffee shops, fast food, busy counters	Coffee shops, bakeries, car washes, light retail
Kasi ya foleni	Tulivu — kuna muda wa mawasiliano ya kibinafsi	Juu — haiwezi kupungua	Yoyote — mteja hujihudumia
Anachokiona mteja	Screen ya staff (optional)	Hakuna — update hufika kwenye Wallet	Kiosk ya full-screen
Inakaa wapi	Simu/tablet ya staff	Laptop/tablet kwenye till	Tablet kwenye stand inayomkabili mteja
Unachohitaji	Kamera ya kifaa	External QR scanner	Tablet ya 10–12” + stand
Risk ya mafunzo ya staff	Ndogo (tap moja)	Sifuri (kazi ya background)	Sifuri (mteja ndiye anafanya)
Lottery	Mteja hucheza kutoka kwenye screen ya staff	Inapatikana kwa action ya manual	Mteja huicheza mwenyewe
Kurudi baada ya action	Staff hufunga popup	Kiotomatiki background	Auto-close kwa timer

Unaweza kutumia modes kadhaa kwa wakati mmoja. Kwa mfano, hotel yenye restaurant na spa: kwenye spa — Manual Mode (premium, mawasiliano ya kibinafsi); kwenye cafe ya restaurant — Kiosk Mode kwenye stand (haraka, hakuna ushiriki wa waiter); kwenye reception — Autopilot kwa regulars. Staff Seat moja inaunga mkono login moja kwa wakati mmoja; ukihitaji points kadhaa za wakati mmoja, ongeza Staff Logins kwenye admin.

9.7 Vidokezo vya vitendo vya kuzindua Scanner

Fanya test kabla ya kufungua. Fanya trial scans 5–10 kwa Card yako mwenyewe asubuhi kabla ya shift — hakikisha kamera inafocus, internet inafanya kazi, na Stamp zinaongezwa.
Kwenye tablet ya Kiosk, zima auto-lock na notifications. Hakuna anayepaswa kutoka kwa bahati mbaya kwenda OS au kupata stray notification. Kwenye iOS tumia Guided Access, kwenye Android tumia Screen Pinning.
Kwa outages za internet weka printed QR labels karibu (zilizoexportiwa kutoka admin) — mteja huziscan mwenyewe na hupata Card hata kama Scanner haipatikani kwa muda.
Waingize staff wapya. Kila mshiriki mpya wa shift anapaswa kujua mambo matano: jinsi ya kuingia Scanner, jinsi ya kuscan Card, jinsi ya kuongeza Stamp, jinsi ya kushughulikia Voucher Unlocked!, na jinsi ya kukomboa voucher kutoka tab ya Vouchers. Dakika tano za training zinatosha.
Recent event log iliyo chini ya Manual Mode ndiyo working log yako. Ikiwa mteja analalamika “Stamp haikuingia”, iangalie: utaona muda, Card ID, na kile kilicho issued / used.