Ключі 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 |
Доступні scopes
Розділ під назвою «Доступні 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 надсилає повідомлення 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 used | Never до першого використання |
| Usage | Активність запитів |
| Source IP | Звідки надходили виклики |
| User agent | No 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.
Ротація без простою
Розділ під назвою «Ротація без простою»Ротація відкликає старий ключ у момент видачі нового, тож сплануйте її заздалегідь:
- Створіть другий ключ із тими самими scopes.
- Розгорніть новий ключ у своїй інтеграції.
- Перевірте трафік на новому ключі через Last used / Usage.
- Відкличте старий ключ.
Два ключі з відкликанням зайвого надійніші, ніж ротація робочого ключа наввипередки з деплоєм.
Добрі практики
Розділ під назвою «Добрі практики»- Один ключ на інтеграцію. Спільні ключі означають, що ви не зможете відкликати один, не зламавши три інші.
- Термін дії 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 | Очікує міграція бази даних, зверніться в підтримку |
Пов’язані статті
Розділ під назвою «Пов’язані статті»- MCP-конектори, для AI-клієнтів
- Чекліст конфіденційності
Налаштування файлів cookie
Ми поважаємо ваше право на приватність. Оберіть, які файли cookie дозволити, ваш вибір діє на всьому сайті. Політика щодо файлів cookie
Потрібні для роботи сайту, зокрема для збереження ваших налаштувань приватності. Завжди увімкнені.
Допомагають зрозуміти, як використовують сайт, і пов'язати реєстрації з партнерами-рекомендувачами. Необов'язкові.