Postbox konzol — kézikönyv

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

Felírás
Megírás
Címzés
Kézbesítés
Visszajelzés
Telefon
Az app regisztrálpush token + user id
Megjelenik az értesítés
Konzol
Composeszöveg, sablon
Közönségteszt / szegmens / mindenki
Üzenet részleteiSent · Failed · Pruned
Postbox
CímjegyzékAudience
Kiválogatja a címzetteket
Apple (APNs) · Google (FCM)eszközönként
Nyugta eszközönkénthalott cím törlése
A konzolon te csak a középső sávban dolgozol — a címjegyzéket az app tölti, a kézbesítést a Postbox végzi.

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:

MitViewerEditorSuperadmin
Dashboard, üzenetek, nyugták, közönségolvasolvasminden
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ákolvasolvas—
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

Viewer, editor

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.

Superadmin

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.

  1. Nyisd meg a konzolt

    A címet és az ideiglenes jelszót a superadmintól kapod — a Postbox maga nem küld e-mailt.

  2. Lépj be az e-mail címeddel

    A Sign in gomb után rögtön a jelszócsere képernyő jön.

  3. 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.

  4. Save and continue

    Megjelenik a Password changed üzenet, és betölt a Dashboard.

postbox.example.com/admin
Amíg ez a képernyő áll, a konzol többi része el sem érhető — nem lehet „később” gombbal kikerülni.
  1. Csak akkor aktív, ha az új jelszó legalább 10 karakter, és a két mező egyezik.
  2. Kilépés csere nélkül — a következő belépéskor ugyanez a képernyő fogad.
Miért így

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.

Elfelejtett jelszó

Ö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.

postbox.example.com/admin
Mintababa · Mintaapp 1production 2 Keva@example.com
DashboardComposeMessagesScheduleAudienceSegmentsTemplatesAppsBillingAPI keysAudit log

Dashboard

Mintababa — last 7 days

Reachable devices
22 131
30 393 notifications off · 0 inactive · 1 test
Messages
3
accepted in the last 7 days
Delivered
48 910
of 51 002 receipts
Failed / pruned
14 / 2 078
return to sender prunes dead addresses
Poste restante 3

Heti összefoglaló · holnap 09:10 (helyi idő)

Recent messages

Hétfői tipp · sent · 48 910 / 51 002

A menü a jogaidhoz igazodik: ez egy editor nézete, aki minden appon editor — ezért látja az API keys menüt is.
  1. App-váltó. Csak a neked kiosztott appok szerepelnek benne. A választást a böngésző megjegyzi.
  2. Apple-környezet. production az éles App Store-os app; sandbox a fejlesztői build. A kettő tokenjei nem cserélhetők fel.
  3. Poste restante — az ütemezett, még ki nem ment üzenetek. Innen egy kattintással a Schedule oldalra jutsz.

Mit mutatnak a számok

CsempeJelentése
Reachable devicesHá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.
MessagesAz elmúlt 7 napban elfogadott üzenetek — konzolról és API-ról együtt.
DeliveredHány eszközt fogadott el az Apple vagy a Google az összes nyugtából.
Failed / prunedSikertelen 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.
Miért kisebb, mint az összes eszköz

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.

postbox.example.com/admin/compose
Mintaapp · Mintaappproduction
DashboardComposeMessagesScheduleAudienceSegmentsTemplates

New push notification

Mintaapp — write once, send to test devices first.

1 · Audience 1
Send to named test devices 2
Send to a segment
Send to everyone

More targeting options

2 · Message Start from template ▾

⊕ 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
✓ Apple iOS ✓ Google Android

› Advanced settings (cross-platform) 5
› Apple iOS settings
› Google Android settings

3 · Delivery schedule
Immediately
At a specific time
At a local time on each device
On a recurring schedule
Preview 6
9:41
Szia name!
A tags.week. héten a baba már…
iOSAndroid
Estimated reach 7

2 devices

Audience: Named test devices
Platforms: iOS + Android
Delivery: Immediately

Send to test devices
A gomb felirata követi a beállítást: „Send to test devices” → „Send message” → „Schedule message”. Mindig olvasd el, mielőtt kattintasz.
  1. 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.
  2. 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.
  3. 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.
  4. Platformok. Kivehető az egyik: így csak iPhone-okra vagy csak Androidokra megy.
  5. 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.
  6. 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.
  7. 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, MessageAz értesítés címe és szövege. Helyőrzők: {{name}}, {{tags.week}}.
ImageKép az értesítésben (webcím).
Launch URLHova nyíljon az app a koppintásra, pl. mintaapp://tudastar/het-12.
Send to these platformsApple 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átszikLegfeljebb
Title50100
Subtitle (iOS)50100
Message1501000

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:

  1. 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ő.

  2. 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.

  3. 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 dataAz 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, SoundAz ú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 liveHigh csak sürgős, tranzakciós üzenetnek; a TTL után a kézbesítetlen értesítés elvész.
Advanced · Silent pushNem jelenik meg semmi a telefonon; csak az appnak szól. Csak fejlesztői kérésre.
Apple iOS · Subtitle, BadgeMásodik sor és ikonszám, csak iPhone-on.
Google Android · Notification channelAz app által regisztrált Android-csatorna.
Figyelj

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ódKinek megy
Send to named test devicesCsak a tesztkészüléknek jelölt telefonoknak. Alatta név szerint felsorolja őket. Így jelölsz meg egyet: 06. fejezet.
Send to a segmentEgy mentett szegmens (07. fejezet) — küldéskor számolja újra, kik tartoznak bele.
Send to everyoneAz 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ódMit csinál
ImmediatelyAzonnal indul.
At a specific timeEgy adott időpontban.
At a local time on each deviceMinden 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 scheduleIsmé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.
Miért tolódik el pár percet

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

  1. 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.

  2. Küldd el a tesztkészülékekre

    Send to named test devices + Immediately → Send to test devices. Nézd meg a telefonodon.

  3. Állítsd át a közönséget

    Szegmens vagy mindenki; nézd meg jobb oldalt az Estimated reach számot.

  4. Küldés vagy ütemezés

    Az elfogadás után a konzol az üzenet részleteihez ugrik (05. fejezet).

Viewerként

Í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.

Ha egy szegmensre vagy korlátozva

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.

postbox.example.com/admin/messages/3f2a…
Mintaapp · Mintaapp
DashboardComposeMessagesScheduleAudience

Heti összefoglaló

immediate · segment · accepted 2026-09-29 09:10

Refresh Cancel 1 sent
Total
51 002
Sent
48 910
95.9%
Received
31 204
Pending
0
0 skipped
Failed
14
Pruned
2 078
Delivery receipts 2
SubscriptionStatusAttemptsProvider id / error
ios · 5f…a91sent1apns-id 8C1E…
android · c2…77epruned1UNREGISTERED
ios · 0b…3d2failed1BadDeviceToken
A Sent és a Received nem ugyanaz: a Sent az Apple/Google elfogadása, a Received az, hogy az app vissza is jelezte a megérkezést.
  1. Cancel amíg az üzenet nem ért véget; ütemezettnél mellette Reschedule is van. Viewernek egyik sem jelenik meg.
  2. Nyugták eszközönként, státusz szerint szűrhetők (any status).

Az üzenet állapotai

StatusJelentése
scheduledVá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.
sentMinden címzett eszközre elment a kísérlet. A részletek a nyugtákban.
cancelledLemondták, mielőtt kiment volna.
failedAz üzenet egésze nem indulhatott el.

A nyugták állapotai

StatusJelentése
sentAz Apple vagy a Google átvette.
queuedMég sorra kerül, vagy újrapróbálkozik — a Sent / next attempt oszlop mutatja, mikor.
prunedA 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.
failedA szolgáltató elutasította, és újrapróbálni nincs értelme. Az oka a Provider id / error oszlopban.
dead_letterTöbbszöri újrapróbálkozás után sem sikerült.
skippedNem kellett küldeni (pl. közben inaktiválták az eszközt).
Miért nem baj a sok pruned

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.

postbox.example.com/admin/audience
Mintaapp · Mintaapp
DashboardComposeMessagesAudienceSegments

Audience

PeopleDevices
external id, test device name…Test devices ✓
DeviceExternal idLocale / tzLast seen
iOS test…34cdhuma
Android…4f21hutegnap
Device External id The tenant's own user id.5f1c2e9a7b3d4c0012ab34cd Localehu
Test device name Shown in the composer's test-device list.Éva iPhone

Mark as test device 1

A telefonra kattintva nyílik a jobb oldali panel. A tesztkészülék-jelölés a panel alsó részén van, külön a többi mezőtől.
  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

  1. Nyisd meg az appot a telefonodon

    Egyszer mindenképp, bejelentkezve — ekkor regisztrál a Postboxba. Engedélyezd az értesítéseket.

  2. 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.

  3. 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.

Ha nem találod magad

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

People

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.

Devices

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.

Viewerként

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.

postbox.example.com/admin/segments
A feltételek „és” kapcsolatban állnak: mindkettőnek teljesülnie kell.
  1. Mező, művelet, érték. A tag… a telefon címkéjét, a user tag… a felhasználóét nézi.
  2. 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
localestarts_with de — minden német nyelvű telefon (de, de-AT, de-CH).
platformeq ios
app versionstarts_with 1.43 — csak az új verziót használók.
last seen, registeredwithin_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 deviceritká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.

Miért nincs külön német app

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.

Figyelj

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.

postbox.example.com/admin/apps
A mentés után a kulcs soha többé nem olvasható vissza — csak az azonosítói (Key ID, Team ID) látszanak.
  1. A teljes fájltartalom, a BEGIN és END sorral együtt.
  2. 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ülHonnanMit 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 keyA letöltött JSON teljes tartalma (Service account JSON). Abból a Firebase-projektből, amelyikbe az Android app tartozik.
A leggyakoribb tévedés

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ásMit jelent
Show this promptKikapcsolva az app nem kérdez.
Title, Body, Allow button, Later button, Image URLA kérdés szövege (pl. Engedélyezem / Talán később), nyelvi változatokkal.
Sessions before askingHányadik appmegnyitáskor kérdezzen először.
Seconds in appMennyi 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).

Ki mit lát

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.

Miért kell minden appon editornak lenni

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.

Visszavonás

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).

Ha a szerződés megszűnik

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.

postbox.example.com/admin/users
Sadmin@example.com
DashboardAppsTenantsUsersPlansInvoices

Users

+ New user
UserAccessStatus
admin@example.comsuperadminactive
eva@example.comMintaapp Mintababa · editor Mintaapp · editoractive password pending 1🔐 🔑 ⏻ 2
anna@example.comMintaapp Mintababa · viewerdeactivated🔐 🔑 ⏻
A „password pending” addig áll, amíg a felhasználó le nem cserélte az ideiglenes jelszavát.
  1. Password pending: még nem lépett be, vagy belépett, de nem cserélt jelszót.
  2. Sorvégi ikonok: App access, Reset password, Deactivate / Reactivate. Saját magadat nem tudod kikapcsolni.

Új felhasználó

  1. New user

    E-mail, név, és a típus: Tenant user vagy Superadmin.

  2. 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.

  3. Create

    A konzol generál egy ideiglenes jelszót, és egyszer megmutatja (Hand this over now). Másold ki.

  4. 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).

A superadmin mindent lát

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.

Miért csak egy tenant

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.

Miért nem szerkesztheti a szegmensét

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átszAmi mögötte van
Not available to your accountA 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-onlyEzen az appon viewer vagy. Egy superadmin tud editorrá tenni.
App … not found vagy … not found egy ismert elemreAz elem egy olyan apphoz tartozik, amihez nincs hozzáférésed — a rendszer ilyenkor szándékosan nem árulja el, hogy létezik.
Account deactivatedEgy superadmin kikapcsolta a fiókodat.
Change your password to continueIdeiglenes jelszóval vagy bent; a jelszócsere képernyő a teendő.
Current password is wrongA 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 mutatA 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 missingHiá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 keyNem push-kulcsot töltöttél fel (App Store Connect / IAP / Sign in with Apple .p8).
serviceAccount is missing "…", serviceAccount is not valid JSONNem a Firebase service-account JSON teljes tartalma került be.
Unknown filter field "…", "within_days" only applies to date fieldsElgépelt mezőnév, vagy dátumművelet nem dátum mezőn.
A segment with this name already exists for the appAz appon belül a név egyedi.
You may send only to your segment or to the named test devicesEgy 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 yoursKorlá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 firstA 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épelniElérted a karakterkorlátot (Title 100, Message 1000).
Kevesebb eszköz az Audience-ben „elérhető”, mint amennyi a listában vanA 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 kapottA helyőrzőnek ({{name}}) nem volt értéke annál a címzettnél — 04. fejezet.
Sok pruned az első küldés utánNem hiba: régi, törölt appok címei. Egyszer tisztul ki.
Nem találom a telefonomat az Audience-benNincs engedélyezve az értesítés, vagy az app még nem indult el a Postboxszal regisztráló verzióval.

Ismert korlátok

KorlátMit tegyél
Nincs önkiszolgáló jelszó-visszaállítás, és a Postbox nem küld e-mailtSuperadmin 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.