Abonnenten zu MailerLite hinzufügen

Die Aktion add subscriber fügt Abonnenten zu MailerLite hinzu. Im Hintergrund ruft diese Aktion den API-Endpoint create subscriber auf. Außerdem möchtest du den Abonnenten möglicherweise zu einer Gruppe hinzufügen.

Das Hinzufügen der Aktion add subscriber in der Datei formspree.json hat denselben Effekt wie das Hinzufügen des MailerLite-Plugins im Formspree-Dashboard. Weitere Informationen findest du im Hilfeartikel zum MailerLite-Plugin.

Formspree.json-Konfiguration

Schlüssel	Typ	Beschreibung
app	String	Muss mailerlite sein
apiKey	String	Dein MailerLite-API-Schlüssel, den du hier findest (muss eine $-Umgebungsvariablen-Referenz sein, erforderlich)
type	String	Muss addSubscriber sein
groupName	String	Optional. Gruppe, zu der Abonnenten hinzugefügt werden. Standard: leer
resubscribe	Boolean	Optional. Reaktiviert den Abonnenten, wenn der Wert true ist. Standard: false
autoresponders	Boolean	Optional. Aktiviert Abonnement-Autoresponder. Wird nur wirksam, wenn groupName nicht leer ist. Standard: false
subscriberStatus	Enum	Optional. Einer von unsubscribed, active, oder unconfirmed. Standard: active
requireOptin	Boolean	Optional. Wenn true, wird das Opt-in-Feld aktiviert: Übermittlungen werden nur an MailerLite gesendet, wenn ein Feld namens _optin mit einem nicht-leeren Wert in den Daten vorhanden ist. Standard: false

Hinweise

autoresponders: Dies wird nur wirksam, wenn eine Gruppe ausgewählt ist. Wenn es aktiviert ist, werden die Autoresponder der ausgewählten Gruppe gesendet.

resubscribe: Wenn es aktiviert ist und die gesendete E-Mail in deiner Abonnentenliste steht, wird der Subscriber Status ignoriert und der Abonnent reaktiviert.
Beachte, dass dies nur für E-Mails funktioniert, die schon einmal zu deiner Abonnentenliste hinzugefügt wurden. Für neue E-Mails wird stattdessen der Subscriber Status verwendet.

requireOptin: Anstatt bei jeder Formularübermittlung einen Kontakt zur MailerLite-Liste hinzuzufügen, prüft die Einstellung Opt-in Checkbox zunächst das Vorhandensein eines speziellen Feldes _optin, um zu bestimmen, ob das Plugin ausgelöst werden soll.

Beispiel

{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "actions": [
        {
          "app": "mailerlite",
          "apiKey": "$MAILERLITE_API_KEY",
          "type": "addSubscriber",
          "groupName": "Formspree Test",
          "resubscribe": false,
          "autoresponders": false,
          "subscriberStatus": "active",
          "requireOptin": false
        }
      ]
    }
  }
}

Validierungsregeln

Die Aktion add subscriber fügt implizit die folgenden Validierungsregeln hinzu:

Feld	Validierungsregel
_replyto oder email	Erforderlich
_replyto	Typ ist email
email	Typ ist email