Einwilligung und das 24-Stunden-Fenster

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.

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, 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, contact_opted_out oder 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. 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. Eine Vorlage ohne Genehmigung ergibt 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.