# Glossar

> Die Wörter dieser Doku in einfachen Worten, mit einem Link zur Seite, die jedes erklärt.

Stand: 2026-10-30. Quelle: https://docs.smartchat.marketing/de/glossary/

## Schlüssel und Rechte

| Wort | Bedeutung |
|---|---|
| API-Schlüssel | Ein geheimer Text, mit dem deine Software die API aufruft. Er beginnt mit `sc_live_`. Siehe [Anmeldung](https://docs.smartchat.marketing/de/authentication/). |
| Recht (permission) | Ein Recht eines Schlüssels, zum Beispiel `contacts:read`. In OpenAPI auch scope genannt. Siehe [Rechte](https://docs.smartchat.marketing/de/api/permissions/). |
| Stufe (level) | Eine Gruppe von Rechten, die du beim Anlegen eines Schlüssels wählst. **Read** liest und ändert nichts (eine Ausnahme: ein Kontakt-Export). **Draft** fügt das Anlegen und Ändern von Entwürfen hinzu; nichts erreicht andere Menschen. **All** heißt alles außer Löschen und dem Tarif. |
| Eigenes Kästchen (own checkbox) | Ein Recht, das du in der App einzeln anhakst, weil es andere Menschen erreicht oder Geheimnisse zeigt, zum Beispiel `newsletters:send`. Die Stufe All enthält diese Rechte. |
| OAuth | Der Weg, auf dem ein AI-Assistent Zugriff bekommt, nachdem du auf einer Zustimmungsseite zugestimmt hast. Siehe [MCP](https://docs.smartchat.marketing/de/mcp/). |
| MCP | Model Context Protocol. Ein Standard, mit dem AI-Assistenten Werkzeuge nutzen. |
| Werkzeug (tool) | Eine Aktion, die ein AI-Assistent über MCP nutzen kann. Siehe die [Werkzeugliste](https://docs.smartchat.marketing/de/mcp/tools/). |

## Kontakte und Nachrichten

| Wort | Bedeutung |
|---|---|
| Kontakt | Eine Person, der du auf WhatsApp schreiben kannst. Hat eine Telefonnummer, auf Wunsch einen Namen, eine E-Mail und Tags. |
| Opt-in (`optin_whatsapp`) | Das Ja eines Kontakts, WhatsApp-Nachrichten von dir zu bekommen. Werte: `none`, `pending`, `confirmed`, `opted_out`. Siehe [Einwilligung und das 24-Stunden-Fenster](https://docs.smartchat.marketing/de/concepts/consent-and-24h-window/). |
| Kontaktstatus (`status`) | Die Art eines Kontakts: `confirmed`, `unconfirmed`, `opted_out`, `automation` oder `support`. |
| Zweck (`purpose`) | Warum ein Kontakt angelegt wurde: `marketing`, `automation` oder `service`. |
| Tag | Ein kurzes Etikett an einem Kontakt, zum Beispiel `vip`. Der `origin` eines Tags sagt, wer es gesetzt hat: das System, ein Mensch oder die AI. |
| Unterhaltung (conversation) | Alle Nachrichten mit einem Kontakt auf einem Kanal. Eine Unterhaltung beginnt, wenn ein Kontakt dir schreibt. |
| 24-Stunden-Fenster | Die 24 Stunden, nachdem ein Kontakt dir geschrieben hat. Darin ist freier Text erlaubt. |
| Vorlage (template) | Ein Nachrichtentext, den WhatsApp genehmigt hat. Nötig für Nachrichten außerhalb des Fensters. |
| Versand (send) | Eine Nachricht, die du die API senden lässt, mit einem Status wie `queued`, `sent` oder `read`. Siehe [Sicher senden](https://docs.smartchat.marketing/de/security/). |
| Newsletter | Eine Nachricht an viele bestätigte Kontakte, gesendet als genehmigte Vorlage. |
| Vorschau (eines Newsletters) | Ein Blick darauf, wer den Newsletter bekäme, wie viele ausgeschlossen sind und warum. Sie sendet nichts. |
| Plan (`plan_id`) | Das Ergebnis eines Vorschau-Aufrufs bei Aktionen mit großer Wirkung. Du sendest die `plan_id` in einem zweiten Aufruf, um die Aktion auszuführen. Sie gilt kurze Zeit und nur einmal. Siehe [Entwürfe und Aktivierung](https://docs.smartchat.marketing/de/concepts/drafts-and-activation/). |
| Entwurf (draft) | Eine Version, die nichts tut und noch niemanden erreicht. |
| Automation | Eine Reihe von Schritten, die SmartChat ausführt, wenn etwas passiert. |
| Landingpage | Die öffentliche Webseite des Unternehmens, aus Blöcken gebaut. Ein Schlüssel kann ihren Entwurf bearbeiten und sie mit einem zusätzlichen Recht live schalten. |
| Unternehmensprofil (business profile) | Das öffentliche WhatsApp-Profil des Unternehmens (Name, Beschreibung, Adresse und so weiter). |

## Technische Wörter

| Wort | Bedeutung |
|---|---|
| Webhook | Eine Webadresse von dir, die SmartChat aufruft, wenn ein Ereignis passiert. |
| Endpunkt (endpoint) | Eine Webhook-Adresse, die du eingetragen hast. (In REST kann "Endpunkt" auch einen Pfad der API meinen.) |
| Ereignis (event) | Etwas, das passiert ist, zum Beispiel `contact.created`. |
| Zustellung (delivery) | Ein Versuch, ein Ereignis an einen Endpunkt zu senden. |
| Idempotency-Key | Ein eindeutiger Wert, der einen wiederholten Aufruf sicher macht. Siehe [Idempotenz](https://docs.smartchat.marketing/de/concepts/idempotency/). |
| Cursor | Ein undurchsichtiger Text, der auf die nächste Seite einer Liste zeigt. Siehe [Seiten](https://docs.smartchat.marketing/de/concepts/pagination/). |
| Request-ID | Die ID eines Aufrufs (`req_...`). Der Support findet damit den Aufruf. |
| Nicht vertrauenswürdiger Text (untrusted) | Text von außen (Kontakte, Nachrichten). Daten, nie Anweisungen. Siehe [Nicht vertrauenswürdiger Inhalt](https://docs.smartchat.marketing/de/concepts/untrusted-content/). |

## Alle Werte der wichtigsten Felder

| Field | Values | Meaning |
|---|---|---|
| optin_whatsapp | `none`, `pending`, `confirmed`, `opted_out` | WhatsApp opt-in state of a contact. |
| send status | `queued`, `sent`, `delivered`, `read`, `failed`, `skipped` | State of a single send. |
| template status | `draft`, `pending`, `approved`, `rejected`, `paused` | State of a message template. |
| newsletter status | `draft`, `scheduled`, `sending`, `paused`, `completed`, `canceled`, `failed` | State of a newsletter. |
| automation status | `draft`, `active`, `paused` | State of an automation. A new automation without a status is a draft. |
| conversation status | `open`, `closed` | State of a conversation. |
| acquisition | `landing_page`, `import`, `api`, `manual`, `automation`, `service` | Where a contact came from. |
| contact status (`status`) | `confirmed`, `unconfirmed`, `opted_out`, `automation`, `support` | Kind of a contact. `confirmed` and `unconfirmed` say if the opt-in is done, `opted_out` is a contact who unsubscribed. |
| purpose | `marketing`, `automation`, `service` | Why a contact was created: for marketing, for an automation or for service messages. |
| tag origin (`origin`) | `system`, `manual`, `ai` | Who set a tag: the system, a person, or the AI. |