⌘I

Aggiungere iscritti a MailerLite

Updated July 14, 2023 ·
pluginsformspree-climailerlite

L’azione add subscriber aggiunge iscritti a MailerLite. Dietro le quinte, questa azione chiama l’endpoint API create subscriber. Inoltre, potresti voler aggiungere l’iscritto a un gruppo.

Aggiungere l’azione add subscriber nel file formspree.json ha lo stesso effetto di aggiungere il plugin MailerLite nella dashboard di Formspree. Consulta l’articolo di aiuto sul plugin MailerLite per maggiori informazioni.

Configurazione di Formspree.json

ChiaveTipoDescrizione
appStringDeve essere mailerlite
apiKeyStringLa tua API key di MailerLite, che trovi qui (deve essere un riferimento a una variabile d’ambiente con $, obbligatorio)
typeStringDeve essere addSubscriber
groupNameStringOpzionale. Gruppo a cui verranno aggiunti gli iscritti. Predefinito: vuoto
resubscribeBooleanOpzionale. Riattiva l’iscritto se il valore è true. Predefinito: false
autorespondersBooleanOpzionale. Abilita gli autorisponditori dell’iscrizione. Ha effetto solo se groupName non è vuoto. Predefinito: false
subscriberStatusEnumOpzionale. Uno tra unsubscribed, active, o unconfirmed. Predefinito: active
requireOptinBooleanOpzionale. Se true, abilita il campo opt-in: gli invii verranno inviati a MailerLite solo se nei dati è presente un campo chiamato _optin con un valore non vuoto. Predefinito: false

Note

autoresponders: Ha effetto solo se è selezionato un gruppo. Se è abilitato, verranno inviati gli autorisponditori del gruppo selezionato.

resubscribe: Se è abilitato e l’email inviata è nella tua lista di iscritti, lo Subscriber Status verrà ignorato e l’iscritto verrà riattivato.
Tieni presente che funziona solo per le email che sono già state aggiunte alla tua lista di iscritti. Per le nuove email, verrà invece preso in considerazione lo Subscriber Status.

requireOptin: Invece di aggiungere un contatto alla lista MailerLite ogni volta che il modulo viene inviato, l’impostazione Opt-in Checkbox verificherà prima la presenza di un campo speciale _optin per determinare se il plugin debba essere attivato.

Esempio

{
  "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
        }
      ]
    }
  }
}

Regole di validazione

L’azione add subscriber aggiunge implicitamente le seguenti regole di validazione:

CampoRegola di validazione
_replyto o emailObbligatorio
_replytoIl tipo è email
emailIl tipo è email