API-scopes beheren
Geef elke integratie alleen de benodigde rechten.
Laatst bijgewerkt · 23 okt 2026
Minimale rechten
Kies scopes bij het aanmaken. Elk endpoint in de API-referentie noemt de vereiste scope. Leesrechten geven geen schrijfrechten. Gesprekstoegang kan klantberichten bevatten; beperk toegang tot vertrouwde serverapplicaties.
Gebruik conversations:read voor gesprekken, contacts:read voor contactgegevens, agents:read voor publieke AI-agentconfiguratie, team:read voor teammetadata en widget:read voor widgetconfiguratie. Beschikbare schrijfacties vereisen hun expliciete schrijf-scope. Een key geeft geen toegang tot platformbeheer, billing, sessie-API’s of Socket.IO.
Rechten veilig veranderen
Maak voor gewijzigde rechten een vervangende key met de nieuwe scopes, werk de integratie bij, test en trek daarna de oude key in. Test zowel een toegestaan verzoek als een verzoek buiten de bedoelde scope; dat laatste hoort 403 te geven. Gebruik aparte keys per integratie zodat één intrekking geen andere diensten onderbreekt.