Zum Inhalt springen

Zielgruppe aufbauen

Anmeldeformular mit Double Opt-in einrichten

Binden Sie auf Ihrer Website ein Anmeldeformular ein, das Abonnenten erst nach der Bestätigung ihrer Adresse zu einer Notifuse-Liste hinzufügt.

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.
  1. Ö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 /subscribe nimmt 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
    Der Bereich Neue Liste mit eingeschalteter Öffentlicher Liste und Double Opt-in und der Auswahl der Bestätigungsvorlage
  2. Formular auf Ihrer Website einbinden

    Diese Seite ist ein vollständiges, lauffähiges Beispiel. Ersetzen Sie YOUR_NOTIFUSE_HOST, YOUR_WORKSPACE_ID und YOUR_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.

  3. So funktioniert der Anmeldeaufruf

    Wenn Sie das Formular in Ihrem eigenen Framework bauen, ist dies der Aufruf, den Sie nachbilden. POST /subscribe ist ö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, contact mit einer gültigen email und mindestens ein Eintrag in list_ids. Weitere Kontaktfelder wie first_name oder last_name sind optional.

    Die Antworten:

    StatusBodyWann
    200{"success": true}Die Anfrage wurde angenommen.
    400{"error": "list is not public"}Eine Liste in list_ids ist 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-After gibt 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-Origin aus der Umgebungsvariable CORS_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.

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

  1. 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.
  2. Öffnen Sie Kontakte, suchen Sie Ihre Adresse und öffnen Sie den Kontakt. In seinem Bereich Listen zeigt die Liste Ausstehend.
  3. Öffnen Sie die Bestätigungs-E-Mail und klicken Sie auf den Link. Das Benachrichtigungscenter öffnet sich und bestätigt die Anmeldung.
  4. Ö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.

Ein Kontaktdatenblatt: Die Liste Newsletter zeigt Ausstehend, bis der Kontakt bestätigt
Ein Kontaktdatenblatt: Die Liste Newsletter zeigt Ausstehend, bis der Kontakt bestätigt

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 error an, 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 als contact.email sendet.
  • 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 aus Retry-After ab.
  • 500 “Failed to subscribe to lists”: Prüfen Sie die Listen-ID in list_ids und 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 absichtlich 200 und keine E-Mail.
  • Der Browser blockiert die Anfrage (CORS): Prüfen Sie, ob NOTIFUSE_HOST stimmt und erreichbar ist. Prüfen Sie auf einer selbst gehosteten Instanz, ob CORS_ALLOW_ORIGIN den 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