smartchat

Entwürfe und Aktivierung

#Automationen

  • Eine Automation, die du über die API ohne status anlegst, ist ein Entwurf. Ein Entwurf tut nichts.
  • Um sie einzuschalten, setze den Status auf active. Das braucht das Recht automations:run; automations:write allein bereitet nur Entwürfe vor. Dasselbe Recht brauchst du, um den Auslöser, die Schritte oder die Regeln einer Automation zu ändern, die schon aktiv ist. Schritte, die eine Adresse aufrufen, brauchen webhooks:write; Schritte in verbundenen Apps und Tresor-Geheimnisse brauchen connections:run.
  • Eine Automation, die aktiv war, kann nicht zurück auf draft (das würde wartende Nachrichten entfernen). Nutze paused.
  • Du darfst eine Automation aktivieren, auch wenn eine Vorlage, die sie nutzt, noch nicht genehmigt ist. Die Automation ist aktiv; Nachrichten, die die Vorlage brauchen, warten, bis sie genehmigt ist. Die Antwort enthält einen Hinweis dazu.
  • Eine Automation von Hand mit Daten zu starten (ein Live-Lauf) braucht ein eigenes Recht, automations:run.

#Newsletter

  • Ein Newsletter beginnt als Entwurf. Einen Entwurf kannst du ändern und in der Vorschau ansehen. Es wird nichts gesendet.
  • Einen Newsletter zu senden ist ein Schritt. Er braucht das Recht newsletters:send und einen Idempotency-Key. Es gibt keinen zweiten Bestätigungs-Aufruf. Siehe Einen Newsletter senden.
  • Ein Newsletter, der geplant oder gesendet ist, lässt sich nicht ändern (newsletter_locked). Brich ihn zuerst ab.

#Landingpage

  • Du kannst die Landingpage lesen und ihren Entwurf bearbeiten.
  • Den Entwurf live zu schalten braucht ein eigenes Recht, landing:publish. Es sind zwei Aufrufe: eine Vorschau ohne plan_id, dann derselbe Aufruf mit der plan_id der Vorschau. Siehe Die Landingpage bearbeiten.
  • Die Live-Seite wird nie offline genommen. Die vorherige Live-Version bleibt gespeichert und lässt sich mit restore_landing_page zurückholen.
  • Pflichtteile einer Landingpage sind fest. Eine Änderung, die sie entfernen würde, wird abgelehnt (landing_ops_rejected) und nichts wird geändert.

#Vorschau, dann bestätigen

Aufrufe mit großer oder bleibender Wirkung laufen in zwei Schritten. Der erste Aufruf ist eine Vorschau (ein Probelauf): Er ändert nichts und antwortet mit einer plan_id. Der zweite Aufruf trägt die plan_id und erledigt die Arbeit. Ein Plan gilt 10 Minuten, lässt sich einmal nutzen und nur für dieselbe Anfrage. Jeder der beiden Aufrufe hat einen eigenen Idempotency-Key. So laufen das Veröffentlichen der Landingpage, das Einreichen von Vorlagen und das Starten einer Automation von Hand.

#Vorlagen

  • Einen Vorlagen-Entwurf kannst du mit templates:write anlegen und ändern.
  • Eine Vorlage bei WhatsApp zur Genehmigung einzureichen braucht ein eigenes Recht, templates:submit, und nutzt die oben beschriebene Vorschau mit Plan. WhatsApp entscheidet über die Vorlage. Wie lange das dauert, steht nicht fest.