Skip to main content

Apps: one for each website

What an app is in Email & Push, the list and its statuses, an app's page — the opt-in prompt, checking the site, the install guide, API keys, topics and webhooks — and editing or deleting an app.

M
Monfri Team
Updated ·4 min read

An app in Email & Push stands for one website that collects web push subscribers. Monfri creates it for you when you set up your site in the Hub; each app has its own subscribers. They are in Email & Push → Push → Apps.

The list

Each app shows its Name, Website, Subscribers and Status. Click a row to open the app.

Status Means
Ready — waiting for subscribers Made by the setup guide for your site: the Monfri tag on the site shows the opt-in prompt, nobody subscribed yet. Nothing to install.
Active It has subscribers (an app the setup guide made), or its installation was checked and it has subscribers.
SDK verified Installation checked, nobody subscribed yet.
SDK not verified Set up, but the installation was not checked yet.
Setup pending Not set up yet — the Setup guide walks through it.

Create app adds one by hand — an App name, the Website URL and an optional Description (optional) — for a site the Hub does not know.

An app's page

At the top, four numbers: Website, Subscribers, API keys and SDK — what the last check found. Next to the name: Opt-in prompt — the banner's words and look: The opt-in prompt — and Edit.

  • Installed through your Monfri tag — on an app the setup guide made: the tag on the site already shows the prompt. Nothing to install; a link leads to the manual guide for developers.
  • Install on your site — on an app made by hand: the three steps for adding the Push SDK by hand, for sites without the Monfri script — the service worker push-sw.js to download, the script tag and the start code, each with a copy button. Setup guide walks through the same in four steps and checks them: Step 1 · Service worker, Step 2 · SDK script, Step 3 · Initialize the SDK, Step 4 · Verify.
  • API keys — for developers who send through the Push API; the SDK in the browser does not need one. Type a Key name and create it: API key created — copy it now, it is not shown again. Revoke stops every request that uses a key. Only an admin can create or revoke keys.

On the right:

  • VAPID public key — the SDK uses it on its own; you need it only for a manual integration.
  • App settings — when your plan includes them (Growth and Scale): Notification topics (Web push subscribers and topics) and Webhooks, which tell another system when something happens in Email & Push.
  • Check the site — Verify SDK checks your site from Monfri's servers and shows Service worker and Script with ✓ or ✗. A site with the Monfri script needs no service worker file, and the line says so.
  • Delete app.

Edit or delete

Edit changes the App name, the Website URL and the Description (optional). Under Security, Allowed origins lists other addresses that may use this app, one per line — a staging site, a subdomain; the website itself is always allowed.

Delete app removes the app together with its subscribers and campaigns — they stop getting notifications from it; it cannot be undone. Only an admin can delete an app.

If something doesn't work

Verify SDK shows ✗ for Script

The check reads your home page as a visitor would. The script is missing, added through Google Tag Manager (the check cannot see it — it still works), or the page is cached without it. See Check that tracking works.

This address cannot be checked from our servers

The website address points to a private or internal address. Use the public address of the site.

A webhook at auto.monfri.net that you did not add

It belongs to a flow in Automation that starts on an event in Email & Push — a new subscriber, an unsubscribe, or a notification delivered, clicked or failed. Publishing the flow puts the address on every app of the workspace. Deleting it here stops that flow's events until the flow is published again.

Only an admin of Push can do this. Ask a workspace admin in Monfri.

Creating API keys and deleting an app are for Email & Push admins.

Didn't find your answer?

Write to us and tell us what you were trying to do.