> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

```html
<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](https://www.notifuse.com/docs/assets/screenshots/list_double_optin.png)

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

```html signup-form.html
<!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.

```json
{
  "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:

| Status | Body                                                 | Wann                                                                                                                |
| ------ | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `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](https://www.notifuse.com/de/docs/guides/welcome-sequence.md).

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](https://www.notifuse.com/de/docs/features/logs.md).

![Ein Kontaktdatenblatt: Die Liste Newsletter zeigt Ausstehend, bis der Kontakt bestätigt](https://www.notifuse.com/docs/assets/screenshots/contact_pending.png)

## 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

- [Willkommensserie aufbauen](https://www.notifuse.com/de/docs/guides/welcome-sequence.md), ausgelöst durch **Bestätigt**.
- [Listen](https://www.notifuse.com/de/docs/features/lists.md) beschreibt die Listeneinstellungen und die Abonnementstatus.
- Das [Benachrichtigungscenter](https://www.notifuse.com/de/docs/features/notification-center.md) ist die Seite, auf der Ihre Abonnenten ihre Anmeldung bestätigen und ihre Abonnements verwalten.
