> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# actions - Newsletter

> Shopaktionen rund um den Newsletter: Meldungen und E-Mail-Vorlagen für Newsletter-An- und Abmeldungen sowie Einträge in Sperrlisten im WEBSALE Shop.

export const TextbausteinHinweis = () => <>
    Dieser Text wird über einen Textbaustein realisiert.<br />
    Alles zu Textbausteinen in Konfigurationen finden Sie{" "}
    <a href="https://dokumentation.websale.de/konfiguration#verwendung-von-textbausteinen-in-konfigurationen">hier</a>.
  </>;

Diese Seite enthält alle Aktionen, die den Newsletter-Versand betreffen.<br />Hier finden sich alle Meldungen und E-Mail-Vorlagen für Newsletter-An- und Abmeldungen sowie für Einträge in Sperrlisten.

***

## Übersicht der Aktionen

Die hier aufgeführten Aktionen wurden **thematisch gruppiert**, um die zugehörigen Fehlermeldungen und E-Mail-Vorlagen übersichtlich darzustellen.

Aktionen, die inhaltlich zu einem anderen Themenbereich gehören, finden sich in den entsprechenden Abschnitten dieser Dokumentation oder in der [alphabetischen Übersicht der Aktionen](/konfiguration/actions-fehlertexte-e-mails/actions-alphabetische-ubersicht).

#### Auszug der Grundstruktur `actions`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
    "actions": {
      ...
      "blacklistAdd": {...},
      "newsletterSubscribe": {...},
      "newsletterUnsubscribe": {...},
      ...
    }
}
```

#### Aktionsübersicht

| **Aktion**              | **Beschreibung**                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------------ |
| `blacklistAdd`          | Definiert die Fehlermeldungen, die beim Hinzufügen eines Kundenkontos zur Blacklist ausgegeben werden. |
| `newsletterSubscribe`   | Definiert die Fehlermeldungen, die bei der Anmeldung zum Newsletter ausgegeben werden.                 |
| `newsletterUnsubscribe` | Definiert die Fehlermeldungen, die bei der Abmeldung vom Newsletter ausgegeben werden.                 |

***

## `actions.blacklistAdd` - Empfänger einer Blacklist hinzufügen

Mit der Aktion `blacklistAdd` werden die Fehlermeldungen definiert, die beim Hinzufügen einer E-Mail-Adresse zur Blacklist (Sperrliste) ausgegeben werden.

#### Beispielkonfiguration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingEmail": "<Textbaustein>",
    "emailCheckFailed": "<Textbaustein>",
    "actionNotAllowed": "<Textbaustein>"
  }
}
```

#### Parameterübersicht

| **Parameter**      | **Typ** | **Beschreibung**                                                                                                                        |
| ------------------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`       | object  | Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.                                                    |
| `missingEmail`     | string  | Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde. <br /><br /><TextbausteinHinweis />                    |
| `emailCheckFailed` | string  | Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wurde. <br /><br /><TextbausteinHinweis /> |
| `actionNotAllowed` | string  | Fehlermeldung, die ausgegeben wird, wenn die Aktion nicht erlaubt ist. <br /><br /><TextbausteinHinweis />                              |

***

## `actions.newsletter*` - Newsletter

### `actions.newsletterSubscribe` - Newsletteranmeldung

Mit der Aktion `newsletterSubscribe` werden Fehlermeldungen definiert, die bei der Anmeldung zum Newsletter ausgegeben werden.

#### Beispielkonfiguration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingField": "<Textbaustein>",
    "invalidField": "<Textbaustein>",
    "invalidTargetGroupId": "<Textbaustein>",
    "deactivatedTargetGroup": "<Textbaustein>",
    "actionNotAllowed": "<Textbaustein>",
    "emailCheckFailed": "<Textbaustein>",
    "internalError": "<Textbaustein>"
  }
}
```

#### Parameterübersicht

| **Parameter**            | **Typ** | **Beschreibung**                                                                                                                                      |
| ------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`             | object  | Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.                                                                  |
| `missingField`           | string  | Fehlermeldung, die ausgegeben wird, wenn mindestens ein erforderliches Feld nicht ausgefüllt wurde. <br /><br /><TextbausteinHinweis />               |
| `invalidField`           | string  | Fehlermeldung, die ausgegeben wird, wenn ein Feld einen ungültigen Wert enthält. <br /><br /><TextbausteinHinweis />                                  |
| `invalidTargetGroupId`   | string  | Fehlermeldung, die ausgegeben wird, wenn eine ungültige oder unbekannte Newsletter-Zielgruppe übermittelt wurde. <br /><br /><TextbausteinHinweis />  |
| `deactivatedTargetGroup` | string  | Fehlermeldung, die ausgegeben wird, wenn die gewünschte Newsletter-Zielgruppe im System deaktiviert ist. <br /><br /><TextbausteinHinweis />          |
| `actionNotAllowed`       | string  | Fehlermeldung, die ausgegeben wird, wenn die Aktion nicht erlaubt ist. <br /><br /><TextbausteinHinweis />                                            |
| `emailCheckFailed`       | string  | Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wurde. <br /><br /><TextbausteinHinweis />               |
| `internalError`          | string  | Fehlermeldung, die ausgegeben wird, wenn unerwartete Systemfehler während der Anmeldung zum Newsletter auftreten. <br /><br /><TextbausteinHinweis /> |

### `actions.newsletterUnsubscribe` - Newsletterabmeldung

Mit der Aktion `newsletterUnsubscribe` werden die Fehlermeldungen definiert, die bei der Abmeldung vom Newsletter ausgegeben werden.

#### Beispielkonfiguration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingEmail": "<Textbaustein>",
    "missingField": "<Textbaustein>",
    "missingTargetGroupId": "<Textbaustein>",
    "invalidTargetGroupId": "<Textbaustein>",
    "actionNotAllowed": "<Textbaustein>",
    "internalError": "<Textbaustein>"
  }
}
```

#### Parameterübersicht

| **Parameter**          | **Typ** | **Beschreibung**                                                                                                                                      |
| ---------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`           | object  | Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.                                                                  |
| `missingEmail`         | string  | Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde. <br /><br /><TextbausteinHinweis />                                  |
| `missingField`         | string  | Fehlermeldung, die ausgegeben wird, wenn ein erforderliches Feld nicht ausgefüllt wurde. <br /><br /><TextbausteinHinweis />                          |
| `missingTargetGroupId` | string  | Fehlermeldung, die ausgegeben wird, wenn keine Newsletter-Gruppe zur Abmeldung angegeben wurde. <br /><br /><TextbausteinHinweis />                   |
| `invalidTargetGroupId` | string  | Fehlermeldung, die ausgegeben wird, wenn eine ungültige oder unbekannte Newsletter-Zielgruppe übermittelt wurde. <br /><br /><TextbausteinHinweis />  |
| `actionNotAllowed`     | string  | Fehlermeldung, die ausgegeben wird, wenn die Aktion nicht erlaubt ist. <br /><br /><TextbausteinHinweis />                                            |
| `internalError`        | string  | Fehlermeldung, die ausgegeben wird, wenn unerwartete Systemfehler während der Abmeldung vom Newsletter auftreten. <br /><br /><TextbausteinHinweis /> |