Bestätigungen

Welche Aktionen eine Bestätigung brauchen

• E-Mail-Kampagne versenden oder einplanen
• E-Mail-Automation aktivieren oder deaktivieren
• E-Mail einer Automation aktivieren oder deaktivieren
• Löschen oder archivieren
• Bestellung erstatten
• Abo oder Ratenzahlung beenden
• Externe Kund:innen deaktivieren

Ablauf

1. Du rufst den Endpunkt auf, zum Beispiel POST /v1/email/campaigns/{campaign_id}/send. Dabei passiert noch nichts.
2. Die Antwort enthält eine confirm_url und eine confirmation_id.
3. Die Kontoinhaberin oder der Kontoinhaber öffnet die confirm_url, während sie oder er in Tentary angemeldet ist, und klickt auf Bestätigen. Mit Nicht ausführen wird die Aktion abgelehnt.
4. Mit GET /v1/confirmations/{confirmation_id} fragst du den Stand ab.

Die Seite in Tentary heißt KI-Aktion bestätigen. Sie zeigt, wer fragt, was passieren wird, und einen Link zum Objekt in Tentary.

Status einer Bestätigung

status	Bedeutung
pending	Noch nicht entschieden.
running	Bestätigt, die Aktion läuft gerade. Frag in ein paar Sekunden noch einmal.
done	Die Aktion ist gelaufen. result enthält die Details.
failed	Die Aktion konnte nicht laufen. result sagt, warum.
canceled	Die Aktion wurde abgelehnt.
expired	Der Link ist abgelaufen.

Regeln

• Der Link gilt 5 Minuten.
• Nur die Kontoinhaberin oder der Kontoinhaber desselben Kontos kann bestätigen.
• Eine Aktion läuft nur einmal.
• Hat sich das Objekt nach der Anfrage geändert, zum Beispiel der Text einer Kampagne, führt Tentary die Aktion nicht aus. Stell die Anfrage dann neu.
• Pro Konto gibt es höchstens 50 Anfragen für Bestätigungen pro Tag.

Eine bestätigte Aktion erscheint im Aktivitätsprotokoll mit dem Schlüssel oder der App, die gefragt hat.