Alapok · 01
Egy üzenet, amit a Postbox eljuttat minden telefonra
A Postbox a saját push-értesítés küldő rendszerünk. Megírod az üzenetet a konzolon, kiválasztod, kinek szól, és a Postbox közvetlenül az Apple-nek és a Google-nek adja át — készülékenként nyugtával. Ez a kézikönyv annak szól, aki a konzolon dolgozik.
Hogyan jut el egy üzenet a telefonig
Ki mit lát
A konzolra kétféle fiókkal lehet belépni. Egy superadmin mindent lát. Egy tenant-felhasználó (például egy ügyfélcég csapata) csak azokat az appokat, amelyeket hozzá rendeltek — appokként külön szereppel:
| Mit | Viewer | Editor | Superadmin |
|---|---|---|---|
| Dashboard, üzenetek, nyugták, közönség | olvas | olvas | minden |
| Küldés, ütemezés, lemondás; szegmensek, sablonok, tag-ek, tesztkészülékek, engedélykérés | — | ✓ | ✓ |
| Az app push-kulcsai (Apple, Firebase) | — | ✓ | ✓ |
| Billing — saját csomag, havi mérő, számlák | olvas | olvas | — |
| Audit log | — | a saját appjaié | minden |
| API keys | — | csak ha minden appon editor | ✓ |
| Users, tenantok, csomagok, új app | — | — | ✓ |
Egy editor egy szegmensre is korlátozható — például egy többnyelvű appban a német kolléga csak a német szegmensnek küldhet. Ő ír, küld, ütemez és sablont szerkeszt, de semmit nem módosíthat, ami eldönti, kit ér el egy üzenet: szegmenst, közönséget, kulcsot, engedélykérést, API-kulcsot.
Aminek nincs jogod, az meg sem jelenik a bal oldali menüben. Ha mégis közvetlen linken nyitod meg, a Not available to your account oldalt kapod.
Kinek melyik fejezet
02–09. fejezet
Belépés, üzenet írása és küldése, közönség, szegmensek, appbeállítások, számlázás.
10. fejezet
Felhasználók felvétele, appok hozzárendelése, jelszó-visszaállítás, kitiltás.
Amit szándékosan nem csinál
- Csak mobil push. Nincs e-mail, SMS, webes push és appon belüli üzenetdoboz.
- Nincs A/B teszt és nincs automatizált út (journey) — minden üzenetet ember indít, vagy a saját backendetek az API-n.
- Nem küld e-mailt a felhasználóknak sem: új fióknál és jelszó-visszaállításnál az ideiglenes jelszót a superadmin adja át.
Szerkesztők és nézők · 02
Az első belépés egy jelszócserével kezdődik
A fiókodat egy superadmin hozza létre, és egy ideiglenes jelszót ad hozzá. Azzal egyszer be tudsz lépni — de amíg le nem cseréled, a konzol semmi mást nem enged.
Nyisd meg a konzolt
A címet és az ideiglenes jelszót a superadmintól kapod — a Postbox maga nem küld e-mailt.
Lépj be az e-mail címeddel
A Sign in gomb után rögtön a jelszócsere képernyő jön.
Válassz saját jelszót
Írd be az ideiglenest a Current password mezőbe, és kétszer az újat. Legalább 10 karakter, és nem lehet azonos a régivel.
Save and continue
Megjelenik a Password changed üzenet, és betölt a Dashboard.
Choose your password
You signed in with a password an administrator set. Replace it to continue.
Current password *•••••••••••••••• New password * At least 10 characters••••••••••••• Repeat new password *••••••••••••• Save and continue 1 Sign out 2- Csak akkor aktív, ha az új jelszó legalább 10 karakter, és a két mező egyezik.
- Kilépés csere nélkül — a következő belépéskor ugyanez a képernyő fogad.
Az ideiglenes jelszót valaki más látta: a superadmin, és bárki, akin keresztül eljutott hozzád. Ezért a rendszer addig nem enged adatot látni, amíg csak te nem ismered a jelszavadat.
Önkiszolgáló jelszó-visszaállítás nincs. Szólj egy superadminnak: ad egy új ideiglenes jelszót, és az első belépéskor újra cserélned kell.
Szerkesztők és nézők · 03
A konzol mindig egy appon belül dolgozik
A jobb felső sarokban választott app határozza meg, mit látsz a Compose, a Messages, az Audience, a Segments és a Templates oldalon. Mielőtt bármit küldesz, ide nézz.
Dashboard
Mintababa — last 7 days
Heti összefoglaló · holnap 09:10 (helyi idő)
Hétfői tipp · sent · 48 910 / 51 002
- App-váltó. Csak a neked kiosztott appok szerepelnek benne. A választást a böngésző megjegyzi.
- Apple-környezet. production az éles App Store-os app; sandbox a fejlesztői build. A kettő tokenjei nem cserélhetők fel.
- Poste restante — az ütemezett, még ki nem ment üzenetek. Innen egy kattintással a Schedule oldalra jutsz.
Mit mutatnak a számok
| Csempe | Jelentése |
|---|---|
| Reachable devices | Hány telefon kap most értesítést — ennyinek megy egy „mindenkinek” küldés. Az alsó sor: hánynál van kikapcsolva az értesítés (notifications off), hány inaktív (halott tokenű), és hány tesztkészülék. |
| Messages | Az elmúlt 7 napban elfogadott üzenetek — konzolról és API-ról együtt. |
| Delivered | Hány eszközt fogadott el az Apple vagy a Google az összes nyugtából. |
| Failed / pruned | Sikertelen kézbesítés / törölt cím. A pruned nem hiba: az app törölve lett a telefonról, a címet a Postbox kivezette. |
Aki kikapcsolta a telefonján az értesítéseket, azt a Postbox megtartja, de nem küld neki, és nem számolja elérhetőnek. Amint újra bekapcsolja, és az app legközelebb elindul, újra a közönség része lesz.
A Recent events doboz csak editoroknak mutat sorokat — a viewer-nézetből az audit-adatok kimaradnak.
Szerkesztők és nézők · 04
Először a tesztkészülékekre, utána mindenkinek
A Compose oldal felülről lefelé három lépés: kinek megy, mi a szöveg, és mikor. Jobb oldalt élő előnézet mutatja, hogyan fest a telefonon, alatta a becsült címzettszám és a küldés gomb. Az oldal alapból a tesztkészülékekre címez — ezt csak szándékosan lehet átállítani.
New push notification
Mintaapp — write once, send to test devices first.
More targeting options
⊕ Add language 2
TitleSzia {{name}}! 3 MessageA {{tags.week}}. héten a baba már… Launch URLmintaapp://tudastar/het-12 Send to these platforms (2/2) 4› Advanced settings (cross-platform) 5
› Apple iOS settings
› Google Android settings
A tags.week. héten a baba már…
2 devices
Audience: Named test devices
Platforms: iOS + Android
Delivery: Immediately
- Kinek. A három gyakori mód látszik; az egyszeri szűrő és a konkrét felhasználók a More targeting options alatt vannak.
- Nyelvi változatok. Az Add language egy nyelvkódot kér (pl. de), és új fület nyit a német nyelvű telefonokra. A Default fül megy mindenki másnak; a telefon nyelve dönt.
- Helyőrzők a címzett adataiból: {{name}}, {{tags.week}}. Ha egy címzettnél nincs érték, üres szöveg lesz a helyén.
- Platformok. Kivehető az egyik: így csak iPhone-okra vagy csak Androidokra megy.
- Ritkán kell. Extra adat, hang, prioritás, élettartam és a platformonkénti beállítások összecsukva várnak; a kitöltött szakasz fejlécén 1 set jelzés látszik.
- Előnézet. Gépelés közben frissül; iOS és Android között váltható. A helyőrzők kiemelve látszanak.
- Becsült címzettszám. Magától újraszámol, ahogy a közönséget vagy a platformokat állítod.
A szöveg
Választhatsz egy mentett sablont a Start from template listából — ez kitölti a mezőket, amiket aztán ennél az egy küldésnél átírhatsz, a sablon maga nem változik. Vagy írd meg itt.
| Mező | Mire való |
|---|---|
| Title, Message | Az értesítés címe és szövege. Helyőrzők: {{name}}, {{tags.week}}. |
| Image | Kép az értesítésben (webcím). |
| Launch URL | Hova nyíljon az app a koppintásra, pl. mintaapp://tudastar/het-12. |
| Send to these platforms | Apple iOS, Google Android, vagy mindkettő. Legalább egy kell. |
Karakterkorlát
A mező fölött élő számláló fut. Narancsra vált, amikor a szöveg hosszabb annál, amit egy zárolt képernyő még teljesen megmutat; a felső korlátnál a mező nem enged tovább gépelni.
| Mező | Kb. ennyi látszik | Legfeljebb |
|---|---|---|
| Title | 50 | 100 |
| Subtitle (iOS) | 50 | 100 |
| Message | 150 | 1000 |
A helyőrzők a leírt hosszukkal számítanak ({{tags.week}} = 13 karakter), a telefonon a behelyettesített érték jelenik meg — az lehet rövidebb vagy hosszabb.
Személyre szabás: az Insert… menü
A Title, a Message és a Subtitle mező jobb szélén egy + gomb (Insert…) nyit menüt:
Personalization tag
A lista az app telefonjain ténylegesen meglévő címkéket mutatja, a leggyakoribbal kezdve, példaértékkel és hogy hány eszközön van. Kereshető.
Alapérték, ha kell
A Default value mezőbe azt írd, ami akkor jelenjen meg, ha a címzettnek nincs ilyen adata — pl. kedves. Üresen hagyva nem jelenik meg semmi.
Insert
A kurzor helyére kerül, pl. {{ tags.name | default: "kedves" }}. Ugyanitt pár gyakori emoji is beszúrható.
Az összecsukott szakaszokban:
| Szakasz · mező | Mire való |
|---|---|
| Advanced · Additional data | Az appnak szóló extra adat kulcs–érték párokként (Add field), érintetlenül továbbítva. Csak a fejlesztők kérésére töltsd. |
| Advanced · Collapse id, Sound | Az újabb értesítés lecserélje-e a régit, és milyen hanggal szóljon. Üresen a telefon alapbeállítása érvényes. |
| Advanced · Priority, Time to live | High csak sürgős, tranzakciós üzenetnek; a TTL után a kézbesítetlen értesítés elvész. |
| Advanced · Silent push | Nem jelenik meg semmi a telefonon; csak az appnak szól. Csak fejlesztői kérésre. |
| Apple iOS · Subtitle, Badge | Második sor és ikonszám, csak iPhone-on. |
| Google Android · Notification channel | Az app által regisztrált Android-csatorna. |
Alapérték nélkül a hiányzó adat üres szöveg lesz, nem hibaüzenet: a Szia {{name}}! név nélküli címzettnél Szia !-ként érkezik. Adj alapértéket az Insert… menüben, vagy írd úgy a szöveget, hogy nélküle is megálljon.
Kinek — az Audience
| Mód | Kinek megy |
|---|---|
| Send to named test devices | Csak a tesztkészüléknek jelölt telefonoknak. Alatta név szerint felsorolja őket. Így jelölsz meg egyet: 06. fejezet. |
| Send to a segment | Egy mentett szegmens (07. fejezet) — küldéskor számolja újra, kik tartoznak bele. |
| Send to everyone | Az app minden aktív eszköze. Narancs figyelmeztetés jelzi, és a küldés gomb is narancsra vált. |
| Send to a custom filter (More targeting options) | Egyszeri szűrő, mentés nélkül. Ugyanaz a szerkesztő, mint a szegmenseknél. |
| Send to specific users (More targeting options) | Konkrét felhasználók a saját azonosítójuk alapján, soronként vagy vesszővel elválasztva. Minden telefonjukra megy. |
A kiválasztott platformok minden módot szűkítenek: ha csak az Apple iOS aktív, a szegmensből is csak az iPhone-ok kapják meg.
Mikor — a Delivery schedule
| Mód | Mit csinál |
|---|---|
| Immediately | Azonnal indul. |
| At a specific time | Egy adott időpontban. |
| At a local time on each device | Minden telefonra a saját időzónája szerinti időpontban, pl. 09:10 Budapesten és 09:10 Berlinben is. Az On day (optional) mezővel egy adott napra. |
| On a recurring schedule | Ismétlődő küldés Cron kifejezéssel és időzónával. Az alapérték 0 9 * * 1 = minden hétfőn 9:00, Europe/Budapest. |
Ha egy ütemezett időpont egész óra, negyed, fél vagy háromnegyed ±2 percre esik, a Postbox kicsit arrébb teszi. Ezekben a percekben küld a világ legtöbb appja, és a Google ilyenkor lassabban fogad. Ezért látsz a Compose alatt ilyen figyelmeztetést, és ezért jó alapérték a 09:10.
A küldés, lépésenként
Válaszd ki az appot, aztán írd meg
Ellenőrizd a jobb felső app-választót. Ha írás közben appot váltasz, a Compose visszavisz a Dashboardra, és a félkész üzenet elvész — így nem maradhat a másik app szegmense vagy sablonja a képernyőn.
Küldd el a tesztkészülékekre
Send to named test devices + Immediately → Send to test devices. Nézd meg a telefonodon.
Állítsd át a közönséget
Szegmens vagy mindenki; nézd meg jobb oldalt az Estimated reach számot.
Küldés vagy ütemezés
Az elfogadás után a konzol az üzenet részleteihez ugrik (05. fejezet).
Írhatsz, és megszámolhatod a címzetteket, de a küldés gomb tiltva van, és ez áll fölötte: Your role on this app is read-only: you can draft and preview, not send.
A közönségnél csak két lehetőség marad: a tesztkészülékek, és a saját szegmensed (Send to your segment: …). Mindenkinek, szűrővel vagy konkrét felhasználóknak nem küldhetsz, és mások máshova szóló üzenetét sem mondhatod le.
Szerkesztők és nézők · 05
Minden telefonról külön nyugta jön vissza
A Messages oldal az app összes üzenete, a Schedule csak a még ki nem mentek. Egy üzenetre kattintva látod, hány telefon kapta meg, és melyiknél mi történt.
Heti összefoglaló
immediate · segment · accepted 2026-09-29 09:10
| Subscription | Status | Attempts | Provider id / error |
|---|---|---|---|
| ios · 5f…a91 | sent | 1 | apns-id 8C1E… |
| android · c2…77e | pruned | 1 | UNREGISTERED |
| ios · 0b…3d2 | failed | 1 | BadDeviceToken |
- Cancel amíg az üzenet nem ért véget; ütemezettnél mellette Reschedule is van. Viewernek egyik sem jelenik meg.
- Nyugták eszközönként, státusz szerint szűrhetők (any status).
Az üzenet állapotai
| Status | Jelentése |
|---|---|
| scheduled | Várja az idejét — a Schedule oldalon és a Dashboard Poste restante dobozában is ott van. |
| queued · dispatching · sending | Épp indul: a Postbox kiválogatja a címzetteket, aztán eszközönként küld. |
| sent | Minden címzett eszközre elment a kísérlet. A részletek a nyugtákban. |
| cancelled | Lemondták, mielőtt kiment volna. |
| failed | Az üzenet egésze nem indulhatott el. |
A nyugták állapotai
| Status | Jelentése |
|---|---|
| sent | Az Apple vagy a Google átvette. |
| queued | Még sorra kerül, vagy újrapróbálkozik — a Sent / next attempt oszlop mutatja, mikor. |
| pruned | A cím halott (az appot törölték vagy újratelepítették), ezért a Postbox kivezette. Legközelebb nem is próbálja. |
| failed | A szolgáltató elutasította, és újrapróbálni nincs értelme. Az oka a Provider id / error oszlopban. |
| dead_letter | Többszöri újrapróbálkozás után sem sikerült. |
| skipped | Nem kellett küldeni (pl. közben inaktiválták az eszközt). |
Minden régi címjegyzék tele van törölt appok címeivel. Az első nagy küldés kigyomlálja őket — utána a pruned szám a következő küldéseknél már kicsi. A Postbox a halott címre soha többé nem próbál küldeni.
Szerkesztők és nézők · 06
Egy ember, több telefon — és a tiéd tesztkészülék
Az Audience két nézetben mutatja a címjegyzéket: People — a felhasználók a saját azonosítójukkal, és Devices — az egyes telefonok. Itt jelölöd meg a saját telefonodat tesztkészüléknek.
Audience
| Device | External id | Locale / tz | Last seen |
|---|---|---|---|
| iOS test | …34cd | hu | ma |
| Android | …4f21 | hu | tegnap |
Mark as test device 1
- Adj egy felismerhető nevet, és nyomd meg a gombot. Ez a név jelenik meg a Compose-ban a Named test devices alatt. Utána ugyanitt: Rename és Remove from test devices.
Hogyan találod meg a saját telefonodat
Nyisd meg az appot a telefonodon
Egyszer mindenképp, bejelentkezve — ekkor regisztrál a Postboxba. Engedélyezd az értesítéseket.
Keress rá a saját azonosítódra
A Devices nézetben a Search mezőbe az external id-t írd (a fejlesztők megmondják, melyik a tiéd), vagy szűrj platformra és a Last seen-re.
Nevezd el és jelöld meg
A panelen: név → Mark as test device.
Egy telefon mellett a szürke muted jelzés azt jelenti: a felhasználó kikapcsolta rajta az értesítéseket. A Postbox megtartja, de nem küld neki, amíg vissza nem kapcsolja.
A telefon csak akkor van a címjegyzékben, ha az app kapott tőle push-tokent — vagyis ha engedélyezted az értesítéseket. Kikapcsolt értesítéssel az eszköz nem szerepel, és tesztkészüléknek sem jelölhető.
People és Devices — mi a különbség
Egy felhasználó
Egy external id, az összes telefonjával. A User tags itt állítva minden telefonjára érvényes. A Reachable only csak azokat mutatja, akiknek van élő eszközük.
Egy telefon
Egy push-cím. Itt látszik a platform, nyelv, időzóna, appverzió, és hogy mikor jelentkezett utoljára.
Szűrők: Platform, Locale, Tag + Tag value, Last seen (7 / 30 / 90 nap, 1 év), Active only, Test devices.
Halott címek
Ha egy telefont a Postbox kivezetett, a panel tetején piros sáv áll: Returned to sender: …. A Reactivate gomb visszaveszi, de a cím csak akkor él valóban, ha az app újra jelentkezik a telefonról.
A panel minden adatot mutat, de a mentő, tesztkészülék- és inaktiváló gombok nem jelennek meg.
Szerkesztők és nézők · 07
Egy szegmens szabály, nem lista
A szegmens azt írja le, kik kapják — például „német nyelvű telefonok, a 12. héttől”. Küldéskor számolja újra, így az azóta belépők is benne vannak. A sablon pedig egy újrahasználható szöveg.
Count devices 182 2 Cancel Save
- Mező, művelet, érték. A tag… a telefon címkéjét, a user tag… a felhasználóét nézi.
- Mentés előtt számolj a Count devices gombbal. A lista oldalon a Devices now oszlop mindig a mostani számot mutatja.
Mezők és műveletek
| Mező | Példa |
|---|---|
| locale | starts_with de — minden német nyelvű telefon (de, de-AT, de-CH). |
| platform | eq ios |
| app version | starts_with 1.43 — csak az új verziót használók. |
| last seen, registered | within_days 30 — az elmúlt 30 napban aktívak. |
| tag… / user tag… | week gte 12, plan eq pro — amit az app vagy ti adtatok a telefonnak vagy a felhasználónak. |
| external id, timezone, device model, OS version, is test device | ritkábban kell, de használható |
Műveletek: eq egyenlő, ne nem egyenlő, in / nin benne van / nincs a listában (a, b, c), gt gte lt lte nagyobb / kisebb, exists van ilyen adat (true / false), contains, starts_with, within_days.
Sok push-rendszerben minden nyelvi változat külön app. A Postboxban egy app van, és a telefon nyelve szerint szegmentálunk (locale starts_with de). A nyelvi fülek a Compose-ban (04) ugyanezt oldják meg egyetlen küldésen belül.
A locale a telefon nyelve, nem az, hogy melyik nyelvű appváltozatot használta valaki. Egy magyar telefonon futó német app magyarnak számít.
Sablonok
A Templates oldalon ugyanazokat a mezőket töltöd ki, mint a Compose-ban, nyelvi fülekkel együtt. A Compose-ban a Start from template listából választva a mezők kitöltődnek. Az ott tett módosítások csak arra az egy küldésre vonatkoznak — a sablont a Templates oldalon szerkeszted. Egy appon belül a sablon és a szegmens neve egyedi (A template with this name already exists for the app).
Szerkesztők és nézők · 08
Két kulcs nélkül egyetlen értesítés sem megy ki
Minden apphoz kell egy Apple-kulcs (iPhone) és egy Firebase-kulcs (Android). Ezeket az editor tölti fel az Apps oldalon; ugyanitt állítható, mikor kérje az app az értesítési engedélyt.
Apple Developer → Keys → APNs auth key. Not an App Store Connect API key — both are .p8 and they are not interchangeable.
MIGTAgEAMBMGByqGSM49…
-----END PRIVATE KEY-----
Store key 2
- A teljes fájltartalom, a BEGIN és END sorral együtt.
- Store key (meglévő kulcsnál Rotate key) mentéskor ellenőriz: rossz kulcsnál azonnal hibát kapsz, nem az első küldésnél. Törlés: Remove APNs key.
Honnan jön a két kulcs
| Fül | Honnan | Mit másolj be |
|---|---|---|
| APNs (iPhone) | Apple Developer → Certificates, IDs & Profiles → Keys → „Apple Push Notifications service” | A .p8 tartalma, a Key ID és a Team ID. Egy kulcs a csapat minden appjához jó. |
| FCM (Android) | Firebase Console → Project settings → Service accounts → Generate new private key | A letöltött JSON teljes tartalma (Service account JSON). Abból a Firebase-projektből, amelyikbe az Android app tartozik. |
Az Apple-fiókban több .p8 kulcs is van: App Store Connect API, előfizetés (IAP), Sign in with Apple. Egyik sem jó push-ra. Ha a mentés ezt írja: privateKey must be the contents of an APNs auth key, akkor rossz fájlt választottál.
Amíg valamelyik kulcs hiányzik, a Compose jobb oldalán, a küldés gomb fölött sárga sáv figyelmeztet (csak a kiválasztott platformokra): APNs credentials are missing — those deliveries will fail until they are stored.
Az engedélykérés (Permission prompt)
Az app saját, barátságos kérdéssel előzi meg az iOS/Android rendszer-engedélyablakát — mert azt csak egyszer lehet feltenni, és egy azonnali „Nem” végleges. A szövegét és a szabályait itt állítod, az app a következő indításkor megkapja, új verzió kiadása nélkül.
| Beállítás | Mit jelent |
|---|---|
| Show this prompt | Kikapcsolva az app nem kérdez. |
| Title, Body, Allow button, Later button, Image URL | A kérdés szövege (pl. Engedélyezem / Talán később), nyelvi változatokkal. |
| Sessions before asking | Hányadik appmegnyitáskor kérdezzen először. |
| Seconds in app | Mennyi idő után az adott megnyitáson belül. |
| Cooldown after “later” (days) | „Talán később” után ennyi napig nem kérdez újra. |
| Max asks, ever | Összesen legfeljebb ennyiszer. |
Alul a statisztika: hányszor jelent meg (shown), hányan engedélyezték (allowed), halasztották (later) vagy zárták be (dismissed).
A Credentials és Permission prompt ikon csak editornak látszik. Új appot felvenni, átnevezni vagy kikapcsolni csak superadmin tud.
Szerkesztők és nézők · 09
Ami az egész céget érinti, nem csak egy appot
Három oldal nem egy apphoz, hanem az egész tenanthoz tartozik: a számlázás, az API-kulcsok és a napló. Mindegyiknek más a jogosultsági szabálya.
Billing — mindenkinek, csak olvasásra
A csomagod (Plan), a hónap mérője (MAU — az adott hónapban aktív felhasználók száma), a várható díj (Projected charge), a nyitott tartozás (Outstanding), a csomag korlátai (Limits) és a kiállított számlák PDF-ben. Módosítani nem lehet; csomagváltáshoz a Smartbitshez fordulj.
API keys — csak ha minden appon editor vagy
A kulcsokkal a saját backendetek (sk_…, küldhet) és a mobilapp (pk_…, csak a telefont regisztrálja) éri el a Postboxot. Új kulcsnál a titok egyszer jelenik meg (Copy it now) — utána csak az eleje látszik.
Egy sk_ kulcs a tenant összes appjához hozzáfér. Ha csak a Mintababa editora kiadhatna ilyet, a kulccsal a PregHellóba is küldhetne. Ezért a menüpont csak annak jelenik meg, aki minden appon editor.
A Revoke azonnal hat: ami azzal a kulccsal hívja a Postboxot, onnantól elutasítást kap. Előbb cseréld ki az új kulcsra a backendben vagy az appban, csak utána vond vissza a régit.
Audit log — ki, mit, mikor
Minden változás egy sor: ki csinálta (Actor), mit (Action), min (Target), sikerült-e (Outcome), és mi változott (Changes). Jelszó és kulcs soha nem kerül bele. Az editor a saját appjai sorait látja; aki minden appon editor, az a tenantszintűeket is (kulcsok, elutasított próbálkozások). Szűrhető műveletre (message, app.*), kimenetelre és a This app only kapcsolóval.
Az adatok exportja
Az Audience (emberek és eszközök), a Segments és a Templates oldalon az Export gomb az aktuális app adatait tölti le, a teljeset — nem csak a képernyőn látható oldalt vagy szűrést. Aki látja az appot, exportálhatja is, a viewer is.
- CSV (spreadsheet) — Excelben megnyílik; a tag-ek, szűrők és tartalmak JSON-ként egy cellában vannak.
- NDJSON (re-importable) — soronként egy rekord, pontosan úgy, ahogy tároljuk; ez a fejlesztőknek való.
Az eszközexport minden telefon teljes push tokenjét tartalmazza: ezzel vihető át a közönség másik szolgáltatásba. A fájlt személyes adatként kezeld. Minden export egy sor az audit logban (Data exported).
30 napig a konzol csak olvasható — piros sáv mutatja a törlés dátumát —, de az Export menü működik. Ments le, amire szükséged van, a dátum előtt: utána az adatok törlődnek.
Superadmin · 10
Egy felhasználó egy tenanthoz tartozik, appokként más szereppel
A Users oldalon veszed fel a konzol felhasználóit, rendeled hozzájuk az appokat, és itt állítod vissza a jelszavukat. Csak superadmin látja.
Users
+ New user| User | Access | Status | |
|---|---|---|---|
| admin@example.com | superadmin | active | |
| eva@example.com | Mintaapp Mintababa · editor Mintaapp · editor | active password pending 1 | 🔐 🔑 ⏻ 2 |
| anna@example.com | Mintaapp Mintababa · viewer | deactivated | 🔐 🔑 ⏻ |
- Password pending: még nem lépett be, vagy belépett, de nem cserélt jelszót.
- Sorvégi ikonok: App access, Reset password, Deactivate / Reactivate. Saját magadat nem tudod kikapcsolni.
Új felhasználó
New user
E-mail, név, és a típus: Tenant user vagy Superadmin.
Tenant és appok
Tenant user esetén válaszd ki a tenantot, majd appokként: None · Viewer · Editor. Editornál a Sends only to mezőben egy szegmensre korlátozhatod — üresen hagyva bárkinek küldhet.
Create
A konzol generál egy ideiglenes jelszót, és egyszer megmutatja (Hand this over now). Másold ki.
Add át te magad
A Postbox nem küld e-mailt. Jelszókezelőn vagy titkosított csatornán küldd el — az első belépéskor a felhasználó lecseréli (02. fejezet).
Minden tenantot, kulcsot, push-kulcsot és számlát. Ügyfélnek soha ne adj superadmint — a Tenant user + minden appon Editor ad mindent, ami nekik kell.
Hozzáférés módosítása
Az App access ablakban appokként állítod a szerepet, és a Save az egész készletet cseréli. A változás a felhasználó következő kattintásánál érvényes — nem kell kilépnie.
Egy felhasználó egyszerre csak egy cég appjait érheti el; két tenant appjait a rendszer nem engedi összekeverni (A user belongs to one tenant). Ha valaki céget vált, előbb minden appját állítsd None-ra, mentsd, és csak utána válaszd az új tenantot.
Egy szegmensre korlátozott editor
Többnyelvű appnál így kap a német kolléga csak német küldési jogot: Editor + Sends only to = a német szegmens. A listában a jelvényen látszik: Mintaapp · editor → German.
Ha a szűrőt átírhatná, a korlát semmit sem érne. Ezért a korlátozott editor nem módosíthat szegmenst, közönséget, push-kulcsot, engedélykérést, és API-kulcsot sem kaphat (egy API-kulcs az egész tenantot eléri). A szegmens szűrőjét te, vagy egy nem korlátozott editor állítja.
Amíg valaki egy szegmensre van korlátozva, azt a szegmenst nem lehet törölni (An editor is restricted to this segment; change their access first).
Jelszó-visszaállítás és kitiltás
- Reset password — új ideiglenes jelszó, egyszer megmutatva; a felhasználó a következő belépéskor cserél.
- Deactivate — a felhasználó a következő kattintásánál kijelentkezik, és többé nem léphet be. Az adatai és a naplóbejegyzései megmaradnak; Reactivate-tel visszahozható.
Minden felvétel, hozzáférés-módosítás, jelszócsere és kitiltás bekerül az Audit logba — a jelszó maga soha.
Ha baj van · 11
A hibaüzenet többnyire megmondja az okát
A konzol a szerver válaszát szó szerint mutatja. Itt a leggyakoribbak, a valódi okukkal.
| Amit látsz | Ami mögötte van |
|---|---|
| Not available to your account | A menüpont a jogaid alapján nem a tiéd — superadmin-oldal, vagy API-kulcs/napló, amihez editori jog kell. |
| Your role on this app is read-only | Ezen az appon viewer vagy. Egy superadmin tud editorrá tenni. |
| App … not found vagy … not found egy ismert elemre | Az elem egy olyan apphoz tartozik, amihez nincs hozzáférésed — a rendszer ilyenkor szándékosan nem árulja el, hogy létezik. |
| Account deactivated | Egy superadmin kikapcsolta a fiókodat. |
| Change your password to continue | Ideiglenes jelszóval vagy bent; a jelszócsere képernyő a teendő. |
| Current password is wrong | A jelszócserénél a régi (ideiglenes) jelszó nem egyezik. |
| No test devices named yet — mark some in Audience. | Még nincs tesztkészülék az appban — 06. fejezet. |
| Az Estimated reach 0-t mutat | A szűrő senkire sem illik, vagy az appnak még nincs élő címe. Nézd meg a feltételeket, és hogy a jó app van-e kiválasztva. |
| … credentials are missing | Hiányzik az Apple- vagy a Firebase-kulcs; az azon a platformon lévő telefonok nem kapnak semmit — 08. fejezet. |
| privateKey must be the contents of an APNs auth key | Nem push-kulcsot töltöttél fel (App Store Connect / IAP / Sign in with Apple .p8). |
| serviceAccount is missing "…", serviceAccount is not valid JSON | Nem a Firebase service-account JSON teljes tartalma került be. |
| Unknown filter field "…", "within_days" only applies to date fields | Elgépelt mezőnév, vagy dátumművelet nem dátum mezőn. |
| A segment with this name already exists for the app | Az appon belül a név egyedi. |
| You may send only to your segment or to the named test devices | Egy szegmensre vagy korlátozva; a közönségnél a saját szegmensedet vagy a tesztkészülékeket válaszd. |
| You send to one segment of this app; changing its audience or settings is not yours | Korlátozott editorként szegmenst, közönséget, kulcsot vagy engedélykérést nem módosíthatsz. |
| An editor is restricted to this segment; change their access first | A törölni kívánt szegmensre valaki korlátozva van — előbb a Users oldalon vedd le róla. |
| A mező nem enged tovább gépelni | Elérted a karakterkorlátot (Title 100, Message 1000). |
| Kevesebb eszköz az Audience-ben „elérhető”, mint amennyi a listában van | A különbség a kikapcsolt értesítésű (muted) telefonok — megmaradnak, de nem kapnak üzenetet. |
| Plan limit reached: … | A csomagod korlátját érted el (pl. szegmensek száma). A Billing oldal Limits része mutatja; bővítéshez a Smartbits. |
| A címzett „Szia !”-t kapott | A helyőrzőnek ({{name}}) nem volt értéke annál a címzettnél — 04. fejezet. |
| Sok pruned az első küldés után | Nem hiba: régi, törölt appok címei. Egyszer tisztul ki. |
| Nem találom a telefonomat az Audience-ben | Nincs engedélyezve az értesítés, vagy az app még nem indult el a Postboxszal regisztráló verzióval. |
Ismert korlátok
| Korlát | Mit tegyél |
|---|---|
| Nincs önkiszolgáló jelszó-visszaállítás, és a Postbox nem küld e-mailt | Superadmin ad új ideiglenes jelszót. |
| A tenant saját maga nem vehet fel felhasználót | Új kolléga felvételét superadmin végzi. |
| A csomag a konzolról nem váltható | Kérd a Smartbitstől. |
| A locale a telefon nyelve, nem az appváltozaté | Ha az appváltozat számít, a fejlesztők adjanak a telefonnak tag-et, és arra szegmentálj. |