# Vorlagenversionen

> Versionen teilen sich einen Alias, damit Sie ein neues Design entwerfen, testen und veröffentlichen können, ohne Code zu ändern. So funktioniert das Veröffentlichen in der Weboberfläche und per API.

Mit Versionen ändern Sie eine Vorlage, ohne den Code anzufassen, der sie sendet. Alle Versionen einer Vorlage teilen sich einen Alias, und höchstens eine davon ist veröffentlicht. Versände per Alias verwenden immer die veröffentlichte Version. So können Sie ein neues Design entwerfen, testen und mit einem Klick darauf umstellen.

## So funktionieren Versionen

Jede Vorlage ist eine Version mit eigener `tem_`-ID, eigenem Namen, Betreff, eigener Absenderadresse, eigenem Editor und Inhalt. Versionen mit demselben Alias bilden eine Gruppe:

```text
welcome-email
├── Welcome email v3   tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh   Draft
├── Welcome email v2   tem_33Vd8Hq3Ws5NzK1xR7cM2pLbYte   Published   ← sends by alias use this one
└── Welcome email      tem_33TfB6yN4qJ8kV2mX9wR1cHsDua   Draft
```

| Wie Sie auf die Vorlage verweisen | Welche Version verwendet wird |
| --- | --- |
| Alias, etwa `"template": "welcome-email"` | Die veröffentlichte Version. Ist keine veröffentlicht, schlägt der Versand mit `404 Template not found` fehl. |
| `tem_`-ID, etwa `"template": "tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh"` | Genau diese Version, ob veröffentlicht oder nicht |

Dieselben Regeln gelten für den Schritt **Send email** in [Automatisierungen](/de/docs/automations/steps/). In der Weboberfläche zeigt die Vorlagenliste nur die veröffentlichte Version jedes Alias. Entwürfe erscheinen im Bereich **Versions** der Vorlagenseite.

## Neue Version erstellen

1. **Vorlage öffnen.** Öffnen Sie **Email Marketing → Templates** und wählen Sie die Vorlage.

2. **Version beginnen.** Wählen Sie im Bereich **Versions** die Option **New Version**.

3. **Quelle auswählen.** Wählen Sie im Dialog **Create New Version** unter **Copy from** die Version, von der Sie ausgehen möchten, und dann **Create Version**. Emailit kopiert Betreff, From, Reply-To, Editor und Inhalt in einen neuen Entwurf, der nach der Quelle benannt ist, etwa `Welcome email v3`.

4. **Entwurf bearbeiten.** Wählen Sie **Open Editor** und nehmen Sie Ihre Änderungen vor. Die veröffentlichte Version wird weiter gesendet, bis Sie den Entwurf veröffentlichen.

Eine neue Version entsteht auch immer dann, wenn Sie eine Vorlage mit einem bereits vorhandenen Alias hinzufügen, ob mit **Add template**, **Duplicate Template**, **Import** oder **Save as template** bei einer Kampagne. Die neue Vorlage wird als Entwurf gespeichert. Die Dialoge **Add template**, **Duplicate Template** und **Save as template** warnen Sie mit **Alias already exists**, **Import** nicht.

## Entwurf testen

Senden Sie den Entwurf vor dem Veröffentlichen über seine `tem_`-ID an sich selbst. Kopieren Sie die ID von der Vorlagenseite.

```bash
curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "you@acme.com",
    "template": "tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh",
    "variables": { "first_name": "Ada", "plan": "Pro" }
  }'
```

## Version veröffentlichen

Durch das Veröffentlichen wird eine Version zur aktiven Version ihres Alias. Die zuvor veröffentlichte Version wird zum Entwurf, sodass immer nur eine Version veröffentlicht ist.

**Weboberfläche**

  Öffnen Sie den Entwurf und wählen Sie **Publish**, oder wählen Sie das Veröffentlichen-Symbol daneben im Bereich **Versions**. Der Dialog **Publish template** warnt, dass das Veröffentlichen die aktuelle Live-Version ersetzt. Wählen Sie zur Bestätigung **Publish**.

**API**

  Rufen Sie [Vorlage veröffentlichen](/de/docs/api-reference/templates/publish/) (`POST /templates/{id}/publish`) mit der `tem_`-ID der Version und einem Schlüssel mit **Full Access** auf.

**cURL**

```bash
curl -X POST https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

**Node.js**

```javascript
const res = await fetch(
  'https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish',
  { method: 'POST', headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}` } },
);
const { data } = await res.json();
```

**Python**

```python
import os
import requests

res = requests.post(
    "https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
)
template = res.json()["data"]
```

**PHP**

```php
$ch = curl_init('https://api.emailit.com/v2/templates/tem_33W1rXk9Pd2LmQ7vB4nC8sTyFgh/publish');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('EMAILIT_API_KEY')],
]);
$template = json_decode(curl_exec($ch), true)['data'];
```

Das Veröffentlichen löst `template.updated` für die neu veröffentlichte Version und für die zurückgezogene Version aus. Für ein Rollback veröffentlichen Sie die vorherige Version erneut.

## Veröffentlichte Version bearbeiten oder löschen

- **Änderungen gelten sofort.** Wenn Sie Änderungen an der veröffentlichten Version speichern, ändert sich ab diesem Moment, was Versände per Alias verwenden. Der Dragit-Editor speichert beim Arbeiten automatisch, seine Änderungen werden also sofort live. Um Änderungen vorzubereiten, erstellen Sie stattdessen eine neue Version.
- **Löschen macht keine andere Version zur veröffentlichten.** Wenn Sie die veröffentlichte Version löschen, hat der Alias keine veröffentlichte Version mehr, und Versände und Automatisierungen, die den Alias verwenden, schlagen fehl, bis Sie eine andere veröffentlichen. Gelöscht wird nur diese Version; die anderen bleiben erhalten.

## Versionen in der API

| Aktion | Verhalten |
| --- | --- |
| [Vorlage erstellen](/de/docs/api-reference/templates/create/) mit einem neuen Alias | Die Vorlage wird automatisch veröffentlicht. |
| [Vorlage erstellen](/de/docs/api-reference/templates/create/) mit einem bestehenden Alias | Die Vorlage wird als unveröffentlichte Version angelegt, mit `published_at` auf `null`. |
| [Vorlagen auflisten](/de/docs/api-reference/templates/list/) | Gibt nur veröffentlichte Versionen zurück, eine pro Alias, jeweils mit `total_versions`. |
| [Vorlage abrufen](/de/docs/api-reference/templates/get/) | Gibt die Version zurück, dazu `versions`: die anderen Versionen des Alias mit `id`, `name`, `published_at`, `created_at` und `updated_at`, die neuesten zuerst. |
| [Vorlage aktualisieren](/de/docs/api-reference/templates/update/) | Ändert die Felder der Version, ohne zu ändern, ob sie veröffentlicht ist. Eine Änderung des Alias auf einen bereits verwendeten schlägt mit `Alias already exists` fehl. |
| [Vorlage veröffentlichen](/de/docs/api-reference/templates/publish/) | Veröffentlicht diese Version und zieht die Veröffentlichung jeder anderen Version des Alias zurück. |
| [Vorlage löschen](/de/docs/api-reference/templates/delete/) | Löscht nur diese Version. |

## Siehe auch

- [Vorlagen erstellen und bearbeiten](/de/docs/templates/editors/)
- [Mit einer Vorlage senden](/de/docs/email-api/send-email/#send-with-a-template)
- [API-Referenz für Vorlagen](/de/docs/api-reference/templates/)

---
Quelle: https://emailit.com/de/docs/templates/versions/