Перейти до вмісту
Відкрити Entergram

Ключі Public API

Settings → Developers → API: створюйте ключі API, прив’язані до робочого простору, для зовнішніх інтеграцій і керуйте ними.

Використовуйте ключ API, коли інтеграція не є MCP-клієнтом: міст до Zapier, внутрішній сервіс, завдання зі звітності.

PRO access required (потрібен доступ PRO): переведіть цей робочий простір на Pro, перш ніж видавати ключі Public API. Admin access required (потрібні права адміністратора): створювати ключі й керувати ними можуть лише власники та адміністратори робочого простору.


Create key: видайте ключ, прив’язаний до робочого простору, з явними scopes і фіксованою датою закінчення терміну дії.

ПолеПримітки
Key nameНаприклад, Zapier CRM bridge. Обов’язкове
ScopesНадавайте лише мінімальний доступ, потрібний цій інтеграції. Щонайменше один
Expiry dateТермін дії мають усі ключі. Рекомендований проміжок: від 30 до 90 днів
IP allowlistНеобов’язкове. Одна IP-адреса або CIDR на рядок чи через кому, наприклад 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 надсилає повідомлення Telegram від імені ваших акаунтів. Надавайте цей scope лише тоді, коли інтеграції справді потрібно надсилати повідомлення.


Ключ у відкритому вигляді показується один раз:

Store this API key now (збережіть цей ключ API зараз): ключ у відкритому вигляді показується лише один раз. Після закриття цього діалогу буде видно тільки префікс. Збережіть цей ключ у менеджері паролів або менеджері секретів, перш ніж закрити діалог.

Entergram зберігає лише хеш ключа. Опції “показати ключ ще раз” немає.


У списку видно Active keys (активні ключі) і Total keys (усього ключів) зі статусом Active, Expired або Revoked. Show archived ({n}) показує виведені з ужитку ключі.

Для кожного ключа:

Поле
ScopesЩо ключ може робити
Created / Created byПоходження
ExpiresЖорсткий дедлайн
Last usedNever до першого використання
UsageАктивність запитів
Source IPЗвідки надходили виклики
User agentNo requests yet до першого використання
IP allowlistАбо No IP restrictions configured for this key (для цього ключа не налаштовано обмежень за IP)
ДіяРезультат
Copy keyЛише поки відкритий одноразовий діалог
Rotate”The current key will be revoked and replaced with a newly generated key.” (поточний ключ буде відкликано й замінено новим)
Revoke”This key will stop working immediately for all clients using it.” (ключ одразу перестане працювати для всіх клієнтів, які його використовують)
DocsВідкриває довідник API

Події життєвого циклу ключів потрапляють в аудит: Public API key created / rotated / revoked з’являються в Log history.


Ротація відкликає старий ключ у момент видачі нового, тож сплануйте її заздалегідь:

  1. Створіть другий ключ із тими самими scopes.
  2. Розгорніть новий ключ у своїй інтеграції.
  3. Перевірте трафік на новому ключі через Last used / Usage.
  4. Відкличте старий ключ.

Два ключі з відкликанням зайвого надійніші, ніж ротація робочого ключа наввипередки з деплоєм.


  • Один ключ на інтеграцію. Спільні ключі означають, що ви не зможете відкликати один, не зламавши три інші.
  • Термін дії 30-90 днів, як рекомендує застосунок. Сенс саме в примусовій ротації.
  • Завжди налаштовуйте IP allowlist, якщо в того, хто викликає API, стабільна IP-адреса. Тоді витік ключа стає не катастрофою, а дрібною неприємністю.
  • Називайте ключі за системами, а не за людьми.
  • Перевіряйте Last used перед продовженням. Ключ, яким ніхто не користується, це чистий ризик.

ПовідомленняЗначення
PRO access requiredПереведіть робочий простір на вищий тариф
Admin access requiredВи не власник і не адміністратор
Public API key management is temporarily unavailableТимчасова проблема, спробуйте трохи пізніше
Public API hashing not configuredПроблема конфігурації на сервері, зверніться в підтримку
Public API storage not readyОчікує міграція бази даних, зверніться в підтримку