Publieke API-sleutels
Settings → Developers → API: maak en beheer API-sleutels per workspace voor externe integraties.
Gebruik een API-sleutel als de integratie geen MCP-client is: een Zapier-koppeling, een interne dienst, een rapportagejob.
PRO access required: zet deze workspace eerst over op Pro voordat je publieke API-sleutels uitgeeft. Admin access required: alleen eigenaren en beheerders van de workspace kunnen sleutels aanmaken of beheren.
Een sleutel aanmaken
Sectie met de titel “Een sleutel aanmaken”Create key: geef een sleutel uit die aan de workspace gebonden is, met expliciete scopes en een vaste vervaldatum.
| Veld | Opmerkingen |
|---|---|
| Key name | Bijvoorbeeld Zapier CRM bridge. Verplicht |
| Scopes | Geef alleen de minimale toegang die deze integratie nodig heeft. Minstens één |
| Expiry date | Alle sleutels moeten verlopen. Aanbevolen termijn: 30 tot 90 dagen |
| IP allowlist | Optioneel. Eén IP-adres of CIDR per regel, of gescheiden door komma’s, bijvoorbeeld 203.0.113.10, 198.51.100.0/24 |
Beschikbare scopes
Sectie met de titel “Beschikbare scopes”Workspace access · Members access · Accounts access · Contacts access · Chats access / Chats write · Custom fields read / write · Messages read / Messages write · Tickets read / Tickets write.
Messages write verstuurt Telegram-berichten namens je accounts. Geef deze scope alleen als de integratie echt berichten moet versturen.
De sleutel bewaren
Sectie met de titel “De sleutel bewaren”De sleutel in platte tekst wordt één keer getoond:
Store this API key now: de sleutel in platte tekst wordt maar één keer getoond. Nadat je dit venster sluit, blijft alleen het voorvoegsel zichtbaar. Bewaar deze sleutel in je wachtwoordmanager of secret manager voordat je het venster sluit.
Entergram slaat alleen een hash van de sleutel op. Er is geen optie om de sleutel opnieuw te tonen.
Sleutels beheren
Sectie met de titel “Sleutels beheren”De lijst toont Active keys en Total keys, met de status Active, Expired of
Revoked. Show archived ({n}) toont sleutels die buiten gebruik zijn.
Per sleutel:
| Veld | |
|---|---|
| Scopes | Wat de sleutel mag doen |
| Created / Created by | Herkomst |
| Expires | Harde deadline |
| Last used | Never tot het eerste gebruik |
| Usage | Activiteit van verzoeken |
| Source IP | Waar de aanroepen vandaan kwamen |
| User agent | No requests yet tot het eerste gebruik |
| IP allowlist | Of No IP restrictions configured for this key |
| Actie | Effect |
|---|---|
| Copy key | Alleen zolang het eenmalige venster open is |
| Rotate | ”De huidige sleutel wordt ingetrokken en vervangen door een nieuw gegenereerde sleutel.” |
| Revoke | ”Deze sleutel werkt direct niet meer voor alle clients die hem gebruiken.” |
| Docs | Opent de API-referentie |
Gebeurtenissen in de levenscyclus van sleutels worden geaudit: Public API key created / rotated / revoked verschijnen in Log history.
Rotatie zonder downtime
Sectie met de titel “Rotatie zonder downtime”Bij rotatie wordt de oude sleutel ingetrokken op het moment dat de nieuwe wordt uitgegeven. Plan daar dus op:
- Maak een tweede sleutel aan met dezelfde scopes.
- Zet de nieuwe sleutel in je integratie.
- Controleer het verkeer op de nieuwe sleutel via Last used / Usage.
- Trek de oude sleutel in met Revoke.
Twee sleutels gebruiken en daarna de oude intrekken is beter dan een live sleutel roteren en een wedloop houden met je deploy.
Goede werkwijze
Sectie met de titel “Goede werkwijze”- Eén sleutel per integratie. Bij gedeelde sleutels kun je niet één ding intrekken zonder drie andere te breken.
- Vervaldatum van 30 tot 90 dagen, zoals de app aanraadt. Gedwongen rotatie is precies de bedoeling.
- Stel altijd een IP-allowlist in als de aanroeper een vast IP-adres heeft. Dan is een gelekte sleutel geen ramp meer, maar alleen lastig.
- Geef sleutels de naam van systemen, niet van mensen.
- Controleer Last used voordat je verlengt. Een sleutel die niemand gebruikt, is puur risico.
Problemen oplossen
Sectie met de titel “Problemen oplossen”| Melding | Betekenis |
|---|---|
| PRO access required | Zet de workspace over op Pro |
| Admin access required | Je bent geen eigenaar of beheerder |
| Public API key management is temporarily unavailable | Tijdelijk probleem, probeer het zo opnieuw |
| Public API hashing not configured | Configuratieprobleem aan de serverkant, neem contact op met support |
| Public API storage not ready | Er staat een databasemigratie open, neem contact op met support |
Gerelateerd
Sectie met de titel “Gerelateerd”- MCP-connectors, voor AI-clients
- Privacychecklist
Cookievoorkeuren
We respecteren je recht op privacy. Kies welke cookies je toestaat, je keuze geldt op de hele site. Cookiebeleid
Nodig om de site te laten werken, inclusief het onthouden van je privacykeuzes. Altijd aan.
Helpen ons het sitegebruik te begrijpen en aanmeldingen toe te schrijven aan referralpartners. Optioneel.