Ga naar inhoud
Entergram openen

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.


Create key: geef een sleutel uit die aan de workspace gebonden is, met expliciete scopes en een vaste vervaldatum.

VeldOpmerkingen
Key nameBijvoorbeeld Zapier CRM bridge. Verplicht
ScopesGeef alleen de minimale toegang die deze integratie nodig heeft. Minstens één
Expiry dateAlle sleutels moeten verlopen. Aanbevolen termijn: 30 tot 90 dagen
IP allowlistOptioneel. Eén IP-adres of CIDR per regel, of gescheiden door komma’s, bijvoorbeeld 203.0.113.10, 198.51.100.0/24

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 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.


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
ScopesWat de sleutel mag doen
Created / Created byHerkomst
ExpiresHarde deadline
Last usedNever tot het eerste gebruik
UsageActiviteit van verzoeken
Source IPWaar de aanroepen vandaan kwamen
User agentNo requests yet tot het eerste gebruik
IP allowlistOf No IP restrictions configured for this key
ActieEffect
Copy keyAlleen 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.”
DocsOpent de API-referentie

Gebeurtenissen in de levenscyclus van sleutels worden geaudit: Public API key created / rotated / revoked verschijnen in Log history.


Bij rotatie wordt de oude sleutel ingetrokken op het moment dat de nieuwe wordt uitgegeven. Plan daar dus op:

  1. Maak een tweede sleutel aan met dezelfde scopes.
  2. Zet de nieuwe sleutel in je integratie.
  3. Controleer het verkeer op de nieuwe sleutel via Last used / Usage.
  4. 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.


  • 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.

MeldingBetekenis
PRO access requiredZet de workspace over op Pro
Admin access requiredJe bent geen eigenaar of beheerder
Public API key management is temporarily unavailableTijdelijk probleem, probeer het zo opnieuw
Public API hashing not configuredConfiguratieprobleem aan de serverkant, neem contact op met support
Public API storage not readyEr staat een databasemigratie open, neem contact op met support