Glossar
#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. |
| Recht (permission) | Ein Recht eines Schlüssels, zum Beispiel contacts:read. In OpenAPI auch scope genannt. Siehe Rechte. |
| 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. |
| 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. |
#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. |
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. |
| 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. |
| 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. |
| Cursor | Ein undurchsichtiger Text, der auf die nächste Seite einer Liste zeigt. Siehe Seiten. |
| 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. |
#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. |