Am Ende haben Sie auf Ihrer Website ein Formular, das Besucher bei einer Notifuse-Liste anmeldet, ihnen eine Bestätigungs-E-Mail schickt und sie als aktiv markiert, sobald sie auf den Link klicken.
Voraussetzungen
- Ein Arbeitsbereich, in dem unter Einstellungen › Integrationen ein E-Mail-Anbieter für Marketing-E-Mails eingerichtet ist. Über diesen Anbieter gehen die Bestätigungs-E-Mails hinaus.
- Die ID Ihres Arbeitsbereichs. Sie haben sie beim Anlegen des Arbeitsbereichs gewählt, und sie steht in der URL der Konsole nach
/console/workspace/. - Die Adresse Ihrer Notifuse-Instanz, also dieselbe, unter der Sie die Konsole öffnen. Die Beispiele verwenden
https://YOUR_NOTIFUSE_HOST. - Eine Seite auf Ihrer Website, in die Sie HTML und JavaScript einfügen können.
Öffentliche Liste mit Double Opt-in anlegen
Öffnen Sie Kontakte und klicken Sie in der linken Leiste neben Listen auf Neue Liste. Füllen Sie Folgendes aus:
- Name: zum Beispiel „Newsletter“.
- ID: wird aus dem Namen abgeleitet, oder Sie klicken auf Ändern und geben eine eigene ein. Nur Buchstaben und Ziffern, höchstens 32 Zeichen. Ihr Formular sendet diese ID, und sie lässt sich nach dem Anlegen nicht mehr ändern.
Schalten Sie unter Abonnement beide Schalter ein:
- Öffentliche Liste: Der öffentliche Endpunkt
/subscribenimmt nur öffentliche Listen an. - Double Opt-in: Neue Abonnenten erhalten eine Bestätigungs-E-Mail und bleiben Ausstehend, bis sie auf deren Link klicken. Dieser Schalter verlangt eine Bestätigungsvorlage.
Wählen Sie unter Bestätigungsvorlage eine Vorlage der Kategorie Opt-in. Wenn Sie noch keine haben, klicken Sie in der Auswahl auf Neue Vorlage und gehen Sie vom Muster Abonnementbestätigung aus. Es öffnet sich im Vorlageneditor und ist nach dem Speichern bereits ausgewählt.
Die Bestätigungs-E-Mail muss auf
{{ confirm_subscription_url }}verlinken. Das Muster enthält schon eine Schaltfläche mit diesem Ziel. In einer eigenen Vorlage schreiben Sie:<a href="{{ confirm_subscription_url }}">Confirm your subscription</a>Klicken Sie auf Liste erstellen.
Der Bereich Neue Liste mit eingeschalteter Öffentlicher Liste und Double Opt-in und der Auswahl der Bestätigungsvorlage Formular auf Ihrer Website einbinden
Diese Seite ist ein vollständiges, lauffähiges Beispiel. Ersetzen Sie
YOUR_NOTIFUSE_HOST,YOUR_WORKSPACE_IDundYOUR_LIST_ID, und fügen Sie sie dann in Ihre Website ein oder öffnen Sie sie zum Ausprobieren als Datei.<!doctype html> <html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Subscribe to our newsletter</title> <style> .signup { max-width: 420px; margin: 2rem auto; font-family: system-ui, sans-serif; } .signup label { display: block; margin: 0.75rem 0 0.25rem; font-size: 0.9rem; } .signup input { width: 100%; padding: 0.6rem; border: 1px solid #ccc; border-radius: 6px; box-sizing: border-box; } .signup button { margin-top: 1rem; width: 100%; padding: 0.7rem; border: 0; border-radius: 6px; background: #4f46e5; color: #fff; font-size: 1rem; cursor: pointer; } .signup button:disabled { opacity: 0.6; cursor: wait; } .signup .message { margin-top: 1rem; font-size: 0.9rem; } .signup .message.error { color: #b91c1c; } .signup .message.success { color: #15803d; } </style> </head> <body> <form class="signup" id="signup-form" novalidate> <h2>Subscribe to our newsletter</h2> <label for="first-name">First name (optional)</label> <input id="first-name" name="first_name" type="text" autocomplete="given-name" /> <label for="email">Email</label> <input id="email" name="email" type="email" autocomplete="email" required /> <button type="submit">Subscribe</button> <p class="message" id="signup-message" role="status" aria-live="polite"></p> </form> <script> const NOTIFUSE_HOST = 'https://YOUR_NOTIFUSE_HOST' const WORKSPACE_ID = 'YOUR_WORKSPACE_ID' const LIST_ID = 'YOUR_LIST_ID' const form = document.getElementById('signup-form') const button = form.querySelector('button') const message = document.getElementById('signup-message') function show(text, kind) { message.textContent = text message.className = 'message ' + kind } form.addEventListener('submit', async (event) => { event.preventDefault() const email = form.email.value.trim() const firstName = form.first_name.value.trim() if (!form.email.checkValidity() || email === '') { show('Please enter a valid email address.', 'error') return } const contact = { email } if (firstName) contact.first_name = firstName button.disabled = true show('Subscribing…', '') try { const response = await fetch(NOTIFUSE_HOST + '/subscribe', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ workspace_id: WORKSPACE_ID, contact, list_ids: [LIST_ID] }) }) if (response.ok) { form.reset() show('Almost done: check your inbox and click the link to confirm your subscription.', 'success') } else if (response.status === 429) { show('Too many attempts. Please try again in a few minutes.', 'error') } else { const result = await response.json().catch(() => ({})) show(result.error || 'Something went wrong. Please try again.', 'error') } } catch (error) { show('Network error. Please check your connection and try again.', 'error') } finally { button.disabled = false } }) </script> </body> </html>Die Erfolgsmeldung bittet den Besucher, in seinem Posteingang nachzusehen: Bei einer Liste mit Double Opt-in ist er erst angemeldet, wenn er auf den Link klickt.
So funktioniert der Anmeldeaufruf
Wenn Sie das Formular in Ihrem eigenen Framework bauen, ist dies der Aufruf, den Sie nachbilden.
POST /subscribeist öffentlich: Der Endpunkt braucht keinen API-Schlüssel und lässt sich daher gefahrlos aus dem Browser aufrufen.{ "workspace_id": "YOUR_WORKSPACE_ID", "contact": { "email": "visitor@example.com", "first_name": "Ada" }, "list_ids": ["YOUR_LIST_ID"] }Pflicht sind
workspace_id,contactmit einer gültigenemailund mindestens ein Eintrag inlist_ids. Weitere Kontaktfelder wiefirst_nameoderlast_namesind optional.Die Antworten:
Status Body Wann 200{"success": true}Die Anfrage wurde angenommen. 400{"error": "list is not public"}Eine Liste in list_idsist nicht öffentlich.400{"error": "invalid contact: invalid email format"}Die E-Mail-Adresse ist fehlerhaft. Ein fehlendes Feld erzeugt eine eigene Meldung, etwa workspace_id is required.429{"error": "Too many subscription attempts. …"}Ein Ratenlimit wurde erreicht. Der Header Retry-Aftergibt die Wartezeit in Sekunden an.500{"error": "Failed to subscribe to lists"}Alle anderen Fälle, etwa eine unbekannte Listen-ID oder eine Bestätigungs-E-Mail, die nicht gesendet werden konnte. Außerdem gelten diese Regeln:
- Die Ratenlimits liegen bei 10 Anfragen pro Minute für eine E-Mail-Adresse und 50 pro Minute von einer IP-Adresse.
- Wegwerfadressen werden stillschweigend verworfen. Die Antwort ist trotzdem
200, und es wird kein Kontakt angelegt. - Eine anonyme Anfrage überschreibt nie die Felder eines Kontakts, der schon im Arbeitsbereich existiert.
- Ein ausstehender Kontakt, der das Formular erneut absendet, erhält die Bestätigungs-E-Mail noch einmal. Ein aktiver Kontakt bleibt aktiv und erhält nichts.
Für CORS setzt Notifuse
Access-Control-Allow-Originaus der UmgebungsvariableCORS_ALLOW_ORIGIN, deren Standardwert*ist. Wenn Sie selbst hosten und den Wert einschränken, fügen Sie den Origin Ihrer Website hinzu. Die Variable nimmt eine kommagetrennte Liste an.Was nach dem Absenden passiert
Bei einer Liste mit Double Opt-in fügt Notifuse den Besucher mit dem Status Ausstehend zur Liste hinzu und sendet die Bestätigungsvorlage.
Der Link in dieser E-Mail öffnet das Benachrichtigungscenter, das die Anmeldung bestätigt. Der Kontakt wechselt von Ausstehend zu Aktiv, und Notifuse erfasst ein Ereignis
list.confirmed.Auf diesem Ereignis bauen Sie weiter auf. Eine Automatisierung mit dem Auslöser Liste › Bestätigt erreicht nur Personen, die bestätigt haben. Siehe Willkommensserie aufbauen.
Kontakte, die Sie in der Konsole oder mit einem API-Schlüssel hinzufügen, erhalten keine Bestätigungs-E-Mail und sind sofort Aktiv. Ausnahme ist ein Kontakt, der sich von der Liste abgemeldet hatte: Melden Sie ihn erneut über das Formular, die Konsole oder die API an, wird er wieder auf Ausstehend gesetzt und erhält die Bestätigungs-E-Mail.
Prüfen, ob es funktioniert
- Senden Sie das Formular mit einer Adresse ab, deren Posteingang Sie lesen können. Das Formular sollte die Meldung zeigen, dass Sie in Ihrem Posteingang nachsehen sollen.
- Öffnen Sie Kontakte, suchen Sie Ihre Adresse und öffnen Sie den Kontakt. In seinem Bereich Listen zeigt die Liste Ausstehend.
- Öffnen Sie die Bestätigungs-E-Mail und klicken Sie auf den Link. Das Benachrichtigungscenter öffnet sich und bestätigt die Anmeldung.
- Öffnen Sie Ihren Kontakt erneut: Die Liste zeigt jetzt Aktiv. Auf dem Tab Aktivität zeigt der Filter Listen & Segmente die Änderung.
Die Bestätigungs-E-Mail erscheint auch unter Protokolle auf dem Tab Nachrichten, mit der Herkunft Andere. Siehe Protokolle.
Empfehlungen
- Weisen Sie im Formular darauf hin, dass Sie eine Bestätigungs-E-Mail senden, und lassen Sie die Erfolgsmeldung auf den Posteingang verweisen.
- Verlinken Sie neben dem Formular Ihre Datenschutzerklärung.
- Halten Sie die Bestätigungs-E-Mail kurz, mit dem Link als Hauptschaltfläche. Auch ihre Textversion sollte
{{ confirm_subscription_url }}enthalten. - Zeigen Sie bei einer fehlgeschlagenen Antwort das Feld
erroran, oder eine eigene, verständliche Meldung für jeden Status. - Testen Sie das Formular auf dem Smartphone und am Desktop.
Fehlerbehebung
400“list is not public”: Klicken Sie unter Kontakte in der Leiste auf die Liste, dann auf Liste bearbeiten, und schalten Sie Öffentliche Liste ein.400“invalid contact: invalid email format”: Die Adresse ist fehlerhaft. Prüfen Sie das Feld, das Ihr Formular alscontact.emailsendet.429“Too many subscription attempts”: Sie haben das Limit von 10 pro E-Mail-Adresse oder 50 pro IP-Adresse und Minute erreicht, was beim Testen schnell passiert. Warten Sie die Zeit ausRetry-Afterab.500“Failed to subscribe to lists”: Prüfen Sie die Listen-ID inlist_idsund ob ein E-Mail-Anbieter für Marketing-E-Mails eingerichtet ist, denn die Bestätigungs-E-Mail wird während der Anfrage gesendet.200, aber keine Bestätigungs-E-Mail: Suchen Sie unter Protokolle › Nachrichten nach einem fehlgeschlagenen Versand. Eine Wegwerfadresse erhält absichtlich200und keine E-Mail.- Der Browser blockiert die Anfrage (CORS): Prüfen Sie, ob
NOTIFUSE_HOSTstimmt und erreichbar ist. Prüfen Sie auf einer selbst gehosteten Instanz, obCORS_ALLOW_ORIGINden Origin Ihrer Website enthält. - Der Kontakt bleibt Ausstehend: Er hat noch nicht auf den Link geklickt. Wird das Formular mit derselben Adresse erneut abgesendet, geht die Bestätigungs-E-Mail noch einmal hinaus.
Nächste Schritte
- Willkommensserie aufbauen, ausgelöst durch Bestätigt.
- Listen beschreibt die Listeneinstellungen und die Abonnementstatus.
- Das Benachrichtigungscenter ist die Seite, auf der Ihre Abonnenten ihre Anmeldung bestätigen und ihre Abonnements verwalten.
