# Einwilligung und das 24-Stunden-Fenster

> Wer welche Nachricht bekommen darf. Opt-in-Zustände, freier Text im 24-Stunden-Fenster und genehmigte Vorlagen außerhalb davon.

Stand: 2026-10-30. Quelle: https://docs.smartchat.marketing/de/concepts/consent-and-24h-window/

WhatsApp hat strenge Regeln. Die API setzt sie auf dem Server durch. Du kannst nicht daran vorbei senden, auch nicht mit einem Schlüssel, der alle Rechte hat.

## Opt-in

Jeder Kontakt hat ein Feld `optin_whatsapp`:

| Wert | Bedeutung |
|---|---|
| `none` | Es wurde noch kein Opt-in angefragt. |
| `pending` | Eine Opt-in-Nachricht wurde gesendet, noch keine Antwort. |
| `confirmed` | Der Kontakt hat Ja gesagt. |
| `opted_out` | Der Kontakt hat sich abgemeldet. |

Welche Art von Nachricht ein Kontakt bekommen darf, hängt von diesem Wert ab:

| Art der Nachricht | `none`, `pending` | `confirmed` | `opted_out` |
|---|---|---|---|
| Freier Text, im 24-Stunden-Fenster (Aufruf "Nachricht senden") | ja | ja | ja, nur als Antwort im offenen Fenster (die Person hat dir gerade geschrieben) |
| Freier Text, Fenster geschlossen | `window_closed` | `window_closed` | `contact_opted_out` |
| Genehmigte Vorlage (Aufruf "Vorlagen-Nachricht senden") | `contact_not_confirmed` | ja | `contact_opted_out` |
| Newsletter | nicht gesendet, gezählt als `not_confirmed` | ja | nicht gesendet, gezählt als `opted_out` |
| Opt-in-Anfrage (Aufruf "Opt-in bestätigen") | nur `none` ohne laufende Anfrage; `pending` wird übersprungen | übersprungen, nicht nötig | nie |
| Testversand | ja, die Nummer muss kein Kontakt sein | ja | `contact_opted_out` |

Eine Nummer auf der Sperrliste bekommt gar nichts und die Antwort ist [`number_suppressed`](https://docs.smartchat.marketing/de/errors/#number_suppressed).

- Die API **setzt nie einen Kontakt auf `confirmed`**. Nur der Kontakt kann bestätigen, indem er auf die Opt-in-Nachricht antwortet. Das Opt-in kannst du mit dem Aufruf "Opt-in bestätigen" anfragen.
- Ein Newsletter geht nur an Kontakte mit `confirmed`.
- Nur ein Kontakt mit `confirmed` kann über die API abgemeldet werden. Bei jedem anderen Kontakt antwortet der Abmelde-Aufruf mit [`contact_not_confirmed`](https://docs.smartchat.marketing/de/errors/#contact_not_confirmed), denn so ein Kontakt bekommt ohnehin kein Marketing.
- Ein Aufruf, der an einen Kontakt senden will, der die Nachricht nicht bekommen darf, scheitert mit [`contact_not_confirmed`](https://docs.smartchat.marketing/de/errors/#contact_not_confirmed), [`contact_opted_out`](https://docs.smartchat.marketing/de/errors/#contact_opted_out) oder [`number_suppressed`](https://docs.smartchat.marketing/de/errors/#number_suppressed).

## Das 24-Stunden-Fenster

Wenn ein Kontakt dir schreibt, öffnet sich ein Fenster von 24 Stunden. Darin darfst du **freien Text** senden. Ist es geschlossen, geht kein freier Text mehr. Die Antwort ist [`window_closed`](https://docs.smartchat.marketing/de/errors/#window_closed). Sende stattdessen eine genehmigte Vorlage.

## Nur genehmigte Vorlagen

Außerhalb des Postfachs gehen Nachrichten nur als Vorlagen, die WhatsApp genehmigt hat. Variablen in einer Vorlage werden mit den Werten gefüllt, die du sendest. Fehlende Werte ergeben [`template_variables_missing`](https://docs.smartchat.marketing/de/errors/#template_variables_missing). Eine Vorlage ohne Genehmigung ergibt [`template_not_approved`](https://docs.smartchat.marketing/de/errors/#template_not_approved).

Das gilt auch für Testversand: Ein Test geht an die Nummer, die du nennst, aber nur mit einer genehmigten Vorlage und nie an einen Kontakt, der sich abgemeldet hat.

## Abmelden

Mit dem Abmelde-Aufruf markierst du einen Kontakt als `opted_out`. Das lässt sich über die API nicht rückgängig machen.