SupportWhale
← Alle Hilfeartikel
API & Integrationen

API-Scopes verwalten

Gib jeder Integration nur die benötigten Rechte.

Zuletzt aktualisiert · 23.10.2026

Minimale Rechte

Wähle Scopes beim Erstellen. Jeder Endpunkt der API-Referenz nennt den erforderlichen Scope. Leserechte erlauben keine Schreibzugriffe. Gesprächszugriff kann Kundennachrichten enthalten; beschränke ihn auf vertrauenswürdige Serveranwendungen.

Verwende conversations:read für Gespräche, contacts:read für Kontaktdaten, agents:read für öffentliche KI-Agentenkonfiguration, team:read für Teammetadaten und widget:read für Widgetkonfiguration. Verfügbare Schreibaktionen benötigen ihren ausdrücklichen Schreib-Scope. Schlüssel erlauben keinen Zugriff auf Plattformverwaltung, Billing, Sitzungs-APIs oder Socket.IO.

Rechte sicher ändern

Erstelle für geänderte Rechte einen Ersatzschlüssel mit neuen Scopes, aktualisiere die Integration, teste sie und widerrufe dann den alten Schlüssel. Teste eine erlaubte und eine außerhalb des Scopes liegende Anfrage; Letztere sollte 403 liefern. Separate Schlüssel je Integration verhindern, dass ein Widerruf andere Dienste unterbricht.

Brauchst du Hilfe? Kontaktiere uns →