Sicher senden
Die API ist so gebaut, dass ein falscher Aufruf deinen Kontakten nicht schaden kann. Diese Prüfungen laufen auf dem Server bei jedem Aufruf, der eine Nachricht sendet. Du kannst sie nicht abschalten.
#Prüfungen, bevor eine Nachricht gesendet wird
| Prüfung | Was sie bedeutet |
|---|---|
| Recht | Der Schlüssel hat das Recht für diesen Aufruf. Einen Newsletter zu senden braucht newsletters:send zusätzlich zu jedem Schreibrecht. |
| Opt-in | Nur Kontakte, die die Nachricht bekommen dürfen. Newsletter gehen nur an Kontakte mit confirmed. |
| Abgemeldet | Ein Kontakt mit opted_out bekommt keine Vorlage und keinen Newsletter. Die einzige Ausnahme ist eine Antwort mit freiem Text im offenen 24-Stunden-Fenster, direkt nachdem die Person dir geschrieben hat (siehe Einwilligung und das 24-Stunden-Fenster). Eine gesperrte Nummer bekommt nie etwas. Kann die Sperrliste nicht gelesen werden, wird nichts gesendet (suppression_check_unavailable). |
| 24-Stunden-Fenster | Freier Text nur im Fenster. Sonst window_closed. |
| Vorlagen | Nur genehmigte Vorlagen werden gesendet. |
| Schutz vor Wiederholung | Aufrufe, die senden, brauchen einen Idempotency-Key. Eine Wiederholung sendet nicht doppelt. |
| Audit | Jeder Aufruf, der etwas ändert oder sendet, wird in ein Audit-Log geschrieben, mit dem Schlüssel, der Zeit und der Request-ID. |
Einzelheiten zu jeder Regel: Einwilligung und das 24-Stunden-Fenster.
#Vorschau, bevor du sendest
Ein Vorschau-Aufruf zeigt, wer einen Newsletter bekäme, wie viele ausgeschlossen sind und warum, und ein paar Beispieltexte. Er liest und rechnet nur; er sendet nichts. Siehe get_newsletter_send_preview.
#Ohne Risiko testen
- Nutze einen Schlüssel mit der Stufe Read, während du baust. Nichts kann sich ändern.
- Ein Testversand eines Newsletters geht an die Telefonnummer, die du nennst. Er nutzt nur genehmigte Vorlagen und geht nie an einen Kontakt, der sich abgemeldet hat.
- Nutze den Webhook-Test-Aufruf, um eine signierte Zustellung ohne echtes Ereignis zu sehen. Siehe Webhook-Tests.
#Schlüssel haben Grenzen, mit Absicht
Ein Schlüssel kann keine Daten löschen. Ausnahmen: einen Tag von einem Kontakt entfernen und einen Webhook-Endpunkt abmelden. Er kann auch das Konto oder den Tarif nicht verwalten und keine Schlüssel anlegen. Siehe Anmeldung.
#Text von außen
Text von Kontakten ist markiert und darf nie als Anweisung behandelt werden. Siehe Nicht vertrauenswürdiger Inhalt.
#Telefonnummern
Ein Schlüssel mit der Stufe Read sieht die Telefonnummern deiner Kontakte. Halte Schlüssel geheim und gib Integrationen nur die Stufe, die sie brauchen.