Zum Inhalt springen

Formulare ​

Ein Formular baust du im Dashboard, veröffentlichst es unter einem eigenen Link und bettest es überall ein. Jede Einsendung landet als Push-Benachrichtigung auf deinem Handy — über denselben Versandweg wie ein Webhook, also funktionieren Routing, Prioritätsstufen und Nachrichtenverlauf so, wie du sie schon kennst.

Kein E-Mail-Postfach dazwischen. Keine Tabelle, die du ständig neu laden musst.

Formular erstellen ​

Formulare → Erstellen. Der Builder hat fünf Tabs und daneben eine Live-Vorschau:

TabWas er enthält
FelderTitel, Einleitungstext, die Felder selbst, Fußzeilentext
DesignTheme, Farben, Schrift, Größe, Eckenradius, Absende-Button
EinstellungenPush-Titel, Routing, Priorität, Antwortlimits, Nachrichten
TeilenÖffentlicher Link, QR-Code, Einbettungscode
VorschauDieselbe Live-Vorschau, für schmale Bildschirme

Speicher das Formular, dann zeigt dir der Tab Teilen den Link: https://frms.click/<id>.

Feldtypen ​

GruppeTypen
TextKurztext, Langtext, E-Mail, Telefon, Zahl, URL, Datum
AuswahlDropdown, Optionsfelder, Kontrollkästchen, einzelnes Kontrollkästchen (Zustimmung)
BewertungSternebewertung (1–5), NPS (0–10)
LayoutÜberschrift, Absatz, Trennlinie
TrackingVerstecktes Feld

Bis zu 30 Felder pro Formular, bis zu 50 Optionen in einem Auswahlfeld. E-Mail-, Telefon-, Zahl- und URL-Felder werden im Browser und zusätzlich auf dem Server geprüft — die Prüfung im Client ist eine Komfortfunktion, kein Schutz.

Layout-Felder sind reine Gestaltung: Sie erscheinen nie in der Nachricht. Datei-Uploads und Zahlungen werden nicht unterstützt.

Versteckte Felder ​

Ein verstecktes Feld übernimmt einen Wert aus dem Link in die Nachricht. Vergib einen Parameternamen, dann erscheint ?utm_source=newsletter in der URL in der Benachrichtigung. Mit einem Klick fügst du alle fünf UTM-Parameter auf einmal hinzu.

Wenn ein Formular eingebettet ist, werden die Parameter der Host-Seite weitergereicht. So markiert eine Kampagnen-Landingpage ihre Einsendungen automatisch, ohne dass du etwas tun musst.

So sieht die Nachricht aus ​

Die Antworten kommen zuerst, in der Reihenfolge der Felder:

Name: Jane Doe
Email: [email protected]
Rating: ★★★★☆ 4/5
Message: Do you ship to Canada?

utm_source: newsletter
Form: Contact
IP: 203.0.113.10
Submitted: 2026-09-23 14:05

Versteckte Felder, die IP des Besuchers und der Zeitstempel stehen unten, nach den Antworten. Der Zeitstempel nutzt die Zeitzone deines Kontos. Alles wird wie jede andere Nachricht mit deinem persönlichen Schlüssel verschlüsselt gespeichert.

Push-Titel ​

Standardmäßig lautet der Titel der Benachrichtigung Form: <form name>. Mit einer Vorlage erkennst du auf den ersten Blick mehr:

New lead: {Name} ({Email})

Platzhalter beziehen sich auf das Feldlabel, Groß- und Kleinschreibung spielt keine Rolle, dazu {form} für den Formularnamen. Leere Antworten fallen aus dem Titel heraus; bleibt nichts übrig, wird der Standardtitel verwendet. Die Vorlage wird auf der öffentlichen Seite nie angezeigt.

Das Pocket-Alert-Badge ​

Ein veröffentlichtes Formular zeigt darunter einen kleinen Link „Powered by Pocket Alert“. Mit einem bezahlten Tarif kannst du ihn unter Design → Branding ausschalten.

Die Entscheidung trifft die API, nicht der Browser: Speicherst du das Flag im kostenlosen Tarif, wird es zurückgesetzt. Läuft ein bezahlter Tarif aus, erscheint das Badge auf der öffentlichen Seite wieder, ohne dass du das Formular anfassen musst.

Routing und Priorität ​

Ein Formular kann eine Anwendung und ein bestimmtes Gerät ansteuern und eine Prioritätsstufe von lautlos bis kritisch mitbringen — dieselben Stufen wie bei der API. Lässt du die Stufe auf Standard, folgt das Formular deinen normalen Zustellregeln.

Jede Einsendung verbraucht eine Nachricht aus deinem Tageslimit. Ist das Kontingent aufgebraucht, sieht der Besucher eine neutrale Meldung „Bitte später erneut versuchen“ ohne Hinweis auf deinen Tarif, und du bekommst die übliche Limit-E-Mail.

Formular schließen ​

Drei unabhängige Schalter, jeder davon schließt das Formular:

  • Antworten annehmen — aus schließt es sofort
  • Antwortlimit — schließt nach N Einsendungen; der Platz wird reserviert, bevor die Nachricht erstellt wird, sodass ein Traffic-Schub das Limit nicht überschreiten kann
  • Schließen am — Datum und Uhrzeit in deiner Zeitzone

Ein geschlossenes Formular ist trotzdem erreichbar: Besucher sehen deine Nachricht für geschlossene Formulare statt der Felder, und Einsendungen werden serverseitig abgelehnt.

Einbetten ​

Der Tab Teilen liefert dir ein Script-Snippet:

html
<div data-pocketalert-form="<id>"></div>
<script src="https://frms.click/embed/form.js" async></script>

Das Formular lädt in ein iframe, das seine eigene Höhe meldet. Dadurch gibt es keine innere Scrollleiste und keine feste Höhe, die du pflegen musst. Der Seitenhintergrund scheint durch — wähle für die Kartenfarbe des Formulars Töne, die mit Transparenz zurechtkommen, dann fügt es sich ein.

Nach einer Einsendung feuert der Container ein pocketalert:submit-Event, an das du Analytics hängen kannst:

js
document.querySelector('[data-pocketalert-form]')
  .addEventListener('pocketalert:submit', () => gtag('event', 'generate_lead'));

Wo Skripte nicht erlaubt sind, gibt es zusätzlich ein einfaches <iframe>-Snippet — feste Höhe, und URL-Parameter werden nicht weitergereicht.

Einschränken, wo das Formular verwendet werden darf ​

Eine Formular-ID ist öffentlich — sie steckt im Link und im QR-Code. Deshalb kann standardmäßig jeder, der sie hat, das Formular auf beliebigen Seiten einbetten. Einstellungen → Wo es verwendet werden darf nimmt eine Liste von Domains entgegen und schließt diese Lücke:

  • Nur diese Seiten dürfen das Formular einbetten (die Seite wird mit einer passenden frame-ancestors-Richtlinie ausgeliefert);
  • Eine Einsendung, deren Origin (oder Referer) nicht auf der Liste steht, wird mit 403 abgelehnt;
  • Der eigene Link des Formulars funktioniert in jedem Fall weiter.

Trage Hosts ein, keine URLs: example.com, app.example.com, *.example.com für alle Subdomains, localhost:3000 während der Entwicklung. Bis zu 10 Einträge. www. wird ignoriert, example.com deckt also www.example.com ab.

Eine leere Liste bedeutet „überall“. Das ist die richtige Einstellung für einen Link, den du in deiner Bio teilst, oder für einen QR-Code auf einem Plakat.

Was das stoppt und was nicht

Origin wird vom Browser gesetzt und kann von einer Seite nicht gefälscht werden. Ein Skript, das direkt mit der API spricht, kann jeden beliebigen Header senden. Die Allowlist verhindert also, dass dein Formular auf fremden Seiten eingebettet wird — gegen einen entschlossenen Flooder schützt sie nicht. Dafür sind die unten beschriebenen Ratenlimits da.

Woher eine Einsendung kam ​

Stammt eine Einsendung aus einem eingebetteten Formular, wird der Host neben der IP in der Nachricht festgehalten:

Form: Contact (abc123)
Source: shop.example.com
IP: 203.0.113.10

Einsendungen von der eigenen Seite des Formulars haben keine Zeile Source.

Spam-Schutz ​

  • Ein Honeypot-Feld, das kein Mensch sieht. Bots, die es ausfüllen, bekommen einen normal aussehenden Erfolgsbildschirm, und es wird nichts zugestellt.
  • Ratenlimits: 10 Einsendungen pro Minute von einer IP, 60 pro Minute und 300 pro Stunde je Formular. Das Stundenlimit gibt es, damit eine Flut nicht in wenigen Minuten einen ganzen Tag an Nachrichten aufbraucht.
  • Öffentliche Formularseiten sind noindex, ein Formular taucht also nicht von selbst in Suchergebnissen auf.

CAPTCHA ist für Formulare derzeit weder erforderlich noch verfügbar.

Limits pro Tarif ​

TarifFormulare
Kostenlos1
Starter10
Medium30
LargeUnbegrenzt

Einsendungen selbst sind nur durch dein Tageslimit für Nachrichten begrenzt.

API ​

Alles, was der Builder kann, ist über die REST API verfügbar:

EndpunktWas er tut
GET /v1/formsDeine Formulare auflisten
POST /v1/formsEines erstellen
PUT /v1/forms/:tidFelder, Design und Einstellungen ersetzen
DELETE /v1/forms/:tidLöschen
GET /v1/forms/:tidÖffentlich: Felder und Design eines aktiven Formulars
POST /v1/forms/:tid/submitÖffentlich: eine Einsendung annehmen

Die ersten vier nutzen dein normales Token; die letzten beiden sind das, was die Formularseite selbst aufruft.

Pocket Alert Dokumentation