> For the complete documentation index, see [llms.txt](https://missiveapp.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://missiveapp.com/docs/guides/de/core-features/canned-responses/using-variables.md).

# Variablen verwenden

Verwenden Sie Variablen in Vorlagen für personalisierte, dynamische Vorlagen.

Sie können Ihre Vorlagen ganz einfach mit dynamischen Inhalten wie dem Namen Ihres Empfängers anpassen, indem Sie unsere Vorlagen-Engine für Variablen verwenden.

Eine Vorlage wie diese:

```liquid
Hallo {{ recipient.first_name | default: 'there' }},
```

… wenn es mit einem `recipient.first_name` würde etwa so aussehen

> Hallo Philippe,

… und wenn es nichts Übereinstimmendes gab, etwa so:

> Hallo there,

## Erste Schritte

### Variablen hinzufügen

Das Hinzufügen einer Variable zu einer Vorlage ist so einfach wie das Klicken auf das **{{** Symbol im Vorlagen-Editor:

<div data-with-frame="true"><figure><img src="https://460913488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1If7JwIQhfz5wGM9LiIU%2Fuploads%2Fgit-blob-302b612ded681ae42b9a8cd81adfbf8e05e08d1f%2Ffeatures-add-variable-icone.png?alt=media" alt="Add a variable helper" width="135"><figcaption></figcaption></figure></div>

Es öffnet sich ein neues Modal, in dem Sie Ihre Variable ganz einfach erstellen können, ohne die genaue Syntax zu kennen.

<div data-with-frame="true"><figure><img src="https://460913488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1If7JwIQhfz5wGM9LiIU%2Fuploads%2Fgit-blob-d0baffc270244468cd5def12ba5340cb35efdd15%2Ffeatures-add-variable.png?alt=media" alt="Add a variable helper" width="563"><figcaption></figcaption></figure></div>

Sie können auch eine Vorlage mit dynamischen Inhalten erstellen, die sich vollständig ändern, je nachdem, ob eine Variable vorhanden ist oder nicht.

Das sähe so aus:

```liquid
{% if recipient.first_name == null %}Hallo,
{% else %}Hallo {{ recipient.first_name }},{% endif %}
```

... wenn kein Vorname des Empfängers vorhanden ist, wird es so gerendert:

> Hallo,

... und wenn es einen Vornamen des Empfängers gibt, wird es so gerendert:

> Hallo Philippe,

### Formulare erstellen

Beim Hinzufügen einer Variable müssen Sie keine verwenden, die mit einem von Missive bereitgestellten Datenpunkt übereinstimmt ([Empfänger](#recipient-object), [Benutzer](#user-object)). Sie können eine Variable erstellen, die mit keinen Daten verknüpft ist, wie in diesem Screenshot:

<div data-with-frame="true"><figure><img src="https://460913488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1If7JwIQhfz5wGM9LiIU%2Fuploads%2Fgit-blob-3ec5c40acc44231c3913f55d4724cd65a1f2fd56%2Ffeatures-description.png?alt=media" alt="Add a variable with no related data" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Verwenden Sie unbedingt **Unterstriche** und **Punkte** statt Leerzeichen.
{% endhint %}

Wenn es in einen Entwurf eingefügt wird, fragt ein Formular den Missive-Benutzer, wie der Wert lauten soll:

Anstatt Textplatzhalter zu verwenden, die Sie vielleicht vergessen zu ersetzen, können Sie mit dieser Technik Formulare erstellen, die Ihr Team beim Einfügen einer Vorlage immer ausfüllen muss.

### Liquid.js

Unsere Vorlagen-Engine basiert auf [liquid.js](https://shopify.github.io/liquid/) und unterstützt alle seine [Tags](https://shopify.github.io/liquid/tags/control-flow/) und [Filter](https://shopify.github.io/liquid/filters). Lesen Sie unbedingt die Dokumentation, wenn Sie tiefer einsteigen und komplexe Logik erstellen möchten.

## Objekte

### `Empfänger` **Objekt**

Die Empfängerdaten werden zuerst in den Kontakten des Benutzers anhand der Empfängeradresse der Nachricht abgeglichen, dann anhand der Nachrichtendaten selbst.

#### Labels

Kontakt-Labels können verwendet werden, um die Suche einzugrenzen. Zum Beispiel `{{ recipient.work.phone_number }}` würde nur in Telefonnummern mit dem Label *work*.

| Objektschlüssel                  | Beschreibung                                                                                                                                                                                                | Beispiel                                                                                           |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `recipient.handle`               | Kennung der Empfänger. Das hängt vom Nachrichtentyp ab und kann eine E-Mail-Adresse, eine Telefonnummer usw. sein.                                                                                          | <p><code><frodo@missiveapp.com></code><br><code>+1 (155) 555-555</code><br><code>@frodo</code></p> |
| `recipient.name`                 | Vor- und Nachname(n) Ihrer Empfänger.                                                                                                                                                                       | `Philippe Lehoux`                                                                                  |
| `recipient.first_name`           | Vorname(n) Ihrer Empfänger.                                                                                                                                                                                 | `Philippe`                                                                                         |
| `recipient.middle_name`          | Zweiter Vorname (phonetisch) Ihrer Empfänger.                                                                                                                                                               | `L.`                                                                                               |
| `recipient.last_name`            | Nachname(n) Ihrer Empfänger.                                                                                                                                                                                | `Lehoux`                                                                                           |
| `recipient.email`                | E-Mail-Adresse(n) Ihrer Empfänger.                                                                                                                                                                          | `frodo@missiveapp.com`                                                                             |
| `recipient.phone_number`         | Telefonnummer Ihrer Empfänger.                                                                                                                                                                              | `+1 (155) 555-555`                                                                                 |
| `recipient.url`                  | Mit Ihren Empfängern verknüpfte URL(s).                                                                                                                                                                     | `https://missiveapp.com/`                                                                          |
| `recipient.physical_address`     | Mit Ihren Empfängern verknüpfte physische Adresse(n).                                                                                                                                                       | <p><code>123 Missive Street</code><br><code>Quebec, QC, G1K 3B4</code><br><code>Kanada</code></p>  |
| `recipient.twitter`              | Mit Ihren Empfängern verknüpfte Twitter-Benutzernamen.                                                                                                                                                      | `@frodo`                                                                                           |
| `recipient.facebook`             | Mit Ihren Empfängern verknüpfte Facebook-Benutzernamen.                                                                                                                                                     | `Philippe Lehoux`                                                                                  |
| `recipient.nickname`             | Spitzname Ihrer Empfänger.                                                                                                                                                                                  | `Chewbacca`                                                                                        |
| `recipient.prefix`               | Anrede(n) Ihrer Empfänger.                                                                                                                                                                                  | `Mr.`                                                                                              |
| `recipient.suffix`               | Namenszusatz(e) Ihrer Empfänger.                                                                                                                                                                            | `PhD`                                                                                              |
| `recipient.gender`               | Geschlecht(er) Ihrer Empfänger.                                                                                                                                                                             | `Männlich`                                                                                         |
| `recipient.file_as`              | Wert für „Speichern unter“ Ihrer Empfänger.                                                                                                                                                                 | `ACME`                                                                                             |
| `recipient.phonetic_first_name`  | Vorname (phonetisch) Ihrer Empfänger.                                                                                                                                                                       |                                                                                                    |
| `recipient.phonetic_last_name`   | Nachname (phonetisch) Ihrer Empfänger.                                                                                                                                                                      |                                                                                                    |
| `recipient.phonetic_middle_name` | Zweiter Vorname (phonetisch) Ihrer Empfänger.                                                                                                                                                               |                                                                                                    |
| `recipient.custom.order_amount`  | Greifen Sie auf die benutzerdefinierten Kontaktdaten Ihrer Empfänger zu. Beide Varianten **Bestellbetrag** und **order\_amount** wären über denselben Schlüssel zugänglich: `recipient.custom.order_amount` | `$99`                                                                                              |

### `Benutzer` **Objekt**

Die Daten des Benutzer-Objekts werden mit dem angemeldeten Missive-Benutzer (Ihnen) abgeglichen.

| Objektschlüssel     | Beschreibung                 | Beispiel               |
| ------------------- | ---------------------------- | ---------------------- |
| `user.first_name`   | Vorname des Benutzers        | `Philippe`             |
| `user.last_name`    | Nachname des Benutzers       | `Lehoux`               |
| `user.name`         | Name des Benutzers           | `Philippe Lehoux`      |
| `user.email`        | E-Mail-Adresse des Benutzers | `frodo@missiveapp.com` |
| `user.avatar_url`   | URL des Benutzer-Avatars     | `https://...`          |
| `user.status`       | Status des Benutzers         | `Im Homeoffice`        |
| `user.status_emoji` | Status-Emoji des Benutzers   | 🏠                     |

### `Unterhaltung` **Objekt**

Die Daten des Unterhaltungs-Objekts werden mit der aktuellen Unterhaltung abgeglichen.

| Objektschlüssel   | Beschreibung            | Beispiel                               |
| ----------------- | ----------------------- | -------------------------------------- |
| `conversation.id` | Die ID der Unterhaltung | `d85eed67-5ac2-477b-aa27-521f01eb9783` |

### `Nachricht` **Objekt**

Die Daten des Nachrichten-Objekts werden mit dem aktuellen Entwurf abgeglichen.

| Objektschlüssel           | Beschreibung                                                                                                       | Beispiel                                                                                           |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| `message.id`              | Die ID der Nachricht                                                                                               | `d85eed67-5ac2-477b-aa27-521f01eb9783`                                                             |
| `message.from_handle`     | Kennung des Absenders. Das hängt vom Nachrichtentyp ab und kann eine E-Mail-Adresse, eine Telefonnummer usw. sein. | <p><code><frodo@missiveapp.com></code><br><code>+1 (155) 555-555</code><br><code>@frodo</code></p> |
| `message.from_email`      | E-Mail-Adresse des Absenders                                                                                       | `info@missiveapp.com`                                                                              |
| `message.from_name`       | Name des Absenders                                                                                                 | `Philippe Lehoux`                                                                                  |
| `message.from_first_name` | Vorname des Absenders                                                                                              | `Philippe`                                                                                         |
| `message.from_last_name`  | Nachname des Absenders                                                                                             | `Lehoux`                                                                                           |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://missiveapp.com/docs/guides/de/core-features/canned-responses/using-variables.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
