Quick links

Get help with Zona

Get help with sources, alerts, accounts, devices, or Zona Plus. Write to one address and include enough detail to reproduce the problem.

Email supportterabasedevteam@gmail.com

Include

  • Your Zona version and device model.
  • A clear description of what happened, and when.
  • The safe diagnostics copied from Settings → App Status.

Never send

  • A complete source token (zona_live_…)
  • A password
  • A push token
  • Payment information
  • Real alert content

If a token may have been exposed, revoke it in Sources first. Deleting the email does not make a credential safe again.

Before you write

Three checks that answer most delivery questions on their own.

  1. Copy the safe diagnostics

    Open Settings → App Status and copy the redacted diagnostic summary into your email.

  2. Check notification permission

    Make sure notifications are allowed for Zona in your phone’s settings.

  3. Look in the inbox

    An inbox record may exist even when a push banner does not appear. If the alert is there, the send worked.

Questions people ask

Straight answers, including the things Zona does not do.

Where can I download Zona?

Zona is on the App Store for iPhone and iPad. Get it on the App Store.

The sender API and the MCP server are documented here in full. Questions: terabasedevteam@gmail.com.

My alert was accepted, but no notification appeared. Why?

A 202 or 200 response means Zona stored the alert in your inbox. It does not prove that a banner appeared or that someone saw it. Push delivery is best effort.

  • Check that notification permission is enabled for Zona.
  • Check whether quiet hours or a source schedule was active. Notification details say so.
  • While Zona is open, it shows its own banner at the top of the screen instead of the system banner. Check that In-app banners is on in Settings. No banner appears for an alert whose details are open, or one already in view in the inbox with no search or filter applied.
  • On app version 0.0.10 or later, open the alert’s details to see its delivery status.
  • Push needs the app on a physical device. Copy the diagnostics from App Status if it still fails.

Do quiet hours delete or delay my alerts?

No. Quiet hours and per-source schedules never reject or delete an alert. Zona stores it, keeps it searchable in the inbox, and skips only the phone push for that window and, if Zona is open, the in-app banner.

The saved window follows your phone’s current time zone. After you change time zones, open and save the schedule so the server receives the new zone.

On Zona Plus, turn on Let critical alerts through for each schedule if you want sender-marked critical alerts to push and show an in-app banner during those hours. Every active schedule must allow them. Skipped pushes are not sent later, and your phone’s Focus and notification settings still apply.

I lost my source token. Can Zona show it again?

No. Zona shows a complete token once and stores only its SHA-256 hash, so the original cannot be recovered by anyone. Create a new key for the source in Sources, update your sender, then revoke the old key.

If you think the token was exposed, revoke it right away. Revoking is permanent and does not affect other keys.

How do I rotate a key without breaking my scripts?

A source can hold several access keys. Create a new key on the same source, deploy it to your script or agent, send a test alert, then revoke the old key. The source keeps its name, sound, filters and history throughout.

Never revoke the whole source just to rotate one credential.

How long does Zona keep my alerts?

The default inbox retention is one day for guest accounts, seven days for Standard accounts and thirty days for Zona Plus. The period shown in Settings is authoritative, and attachments follow their notification.

A longer plan extends alerts already in the inbox, and a downgrade never shortens them. On Standard and Zona Plus, a pin can keep an alert and its images until it is unpinned or its pin expires; a guest’s pin ends with the alert’s retention. You can delete individual notifications at any time. Compare plans.

How do I delete my account, and what happens to my subscription?

Delete your Zona account in Settings. Deletion stops its source keys and removes associated app data, subject to provider or legal retention.

Deleting your account does not cancel an App Store subscription. Cancel it through Settings → Manage Subscription or Apple’s subscription settings first. Signing out of an unprotected guest account is also permanent, so the app asks you to confirm.

I changed phones. How do I get my account back?

If you protected your account with an enabled sign-in method, use the same method on the new phone: email and password, Apple, Google or GitHub, as available. Your sources, server-backed preferences, plan and retained history come with you; device preferences such as the theme and in-app banner switch are set on each phone. Settings → Zona Plus → Restore Purchases brings back a subscription.

Source tokens are never recoverable, and a guest account that was never protected cannot be restored.

Is Zona available on Android?

Not yet. There is no Android store release today. An Android preview build exists and handles safe areas, the navigation bar, notification channels and Android sound behaviour, but Android push depends on a Firebase Cloud Messaging setup that is not guaranteed.

Zona Plus is sold through the App Store. Google Play billing is future work.

What does Zona never see or do?

  • Zona never receives your payment-card details. Apple processes Zona Plus payments.
  • Zona stores only a one-way hash of each source key, never the key itself.
  • Zona does not sell personal data, serve behavioural advertising, or track you across other apps or websites.
  • Zona cannot control your computer: there is no remote shell, command execution or PC heartbeat.

Alert titles, bodies and source labels do pass through Supabase, Expo and Apple or Google push services, and may show on a lock screen. Never put passwords, tokens or other secrets in an alert. How Zona protects your alerts.

Usage extension on iOS

Each example starts in Zona on the iPhone. You send an alert, you see it in the inbox, and the shortcut uses that Zona notification.

Apple’s list of the new actions isNew in iOS 27. The send commands and the sentences you can paste into Shortcuts are in Usage extension on iOS.

On the iPhone, in Zona

  1. Open Zona and sign in. The iPhone needs iOS 27 or iPadOS 27.
  2. In Sources, create a source named Office PC and copy the zona_live_ token. Zona shows the complete token once.
  3. In Settings, turn Message previews on and allow notifications for Zona. Turn quiet hours off for this try. With previews off, the notification is generic and a filter on your real title will not match.
  4. Leave Zona for the Home Screen before you send. The shortcut reads the system notification. While Zona is open, the alert shows as Zona’s own banner instead, and the shortcut has nothing to run.

Log a failed backup

Send a failed backup to Zona, read it on the iPhone, and have Shortcuts file that Zona notification.

In Zona on iPhone

  1. In Zona, use the source Office PC. Leave Zona for the Home Screen, then send the alert titled Backup failed, body “The nightly backup failed. The backup disk is full.”
  2. The Zona notification shows that title and body, and the source name Office PC.
  3. Open Zona. The same alert is the inbox row under Office PC.

Shortcut, from the Zona notification

  1. When I receive a notification from Zona. Filter the message so it contains failed.
  2. Add Item to List. Name the list Zona failures. The item is the Zona notification.

Send command

Keep the latest Zona alert

Send a disk check to the same source. The shortcut stores that Zona notification, and an XL widget shows it.

In Zona on iPhone

  1. Leave Zona in the background and send title Disk check finished, body “Office PC has 12 GB free.”
  2. The Zona notification shows that title and body.
  3. Open Zona. The row is at the top of the inbox, with a thin green ring for low severity.

Shortcut, from the Zona notification

  1. When I receive a notification from Zona. Filter the title for Disk check, or leave the filter off to keep every Zona notification.
  2. Store Content under the name last-zona-alert. The content is the Zona notification. Saving that name again keeps the newest one.
  3. A second shortcut runs Get Stored Content for last-zona-alert and shows the text. Add that shortcut as an XL widget.

Send command

Message the on-call group

Send Backup failed again. The shortcut reads that Zona notification and messages the group.

In Zona on iPhone

  1. Leave Zona in the background and send the same Backup failed alert, with a new idempotency key so Zona delivers it again.
  2. The Zona notification shows the title Backup failed.
  3. Open Zona and the row is in the inbox under Office PC.

Shortcut, from the Zona notification

  1. When I receive a notification from Zona.
  2. Filter the title for Backup failed.
  3. Send Message to the on-call group. The message is the Zona notification text.

Send command

The guide has the send command for each example, sentences you can paste into Shortcuts, and what stays the same in the inbox. Do not put a token or a password in an alert: with previews on, that text is on the lock screen and in the shortcut.

Policies