UK
Подивитися демо

AI-агенти й інтеграції

Безпечний доступ AI до даних CRM: scope, ролі й журнал

AI-агент безпечний у CRM, коли його доступ має три межі, які CRM тримає на сервері: права (scope), що називають дані, роль, що називає співробітника, від імені якого діє агент, і журнал, який читає людина. Цей посібник показує, як вибрати кожну межу й перевірити її до того, як агент торкнеться живих даних.

Коротка відповідь

Доступ AI до даних CRM безпечний, коли агент має власну ідентичність, найвужчі права, що виконують задачу, роль, яка обмежує охоплення цих прав, жодних руйнівних інструментів і журнал викликів, який читає людина. Почніть із прав на читання, додавайте права на запис по одній групі записів і переглядайте журнал щотижня.

  • Ідентичність: один ключ або підключення на агента
  • Перші права: лише читання
  • Перегляд: журнал викликів, щотижня
На цій сторінці
  1. Коротка відповідь
  2. Коли переглядати
  3. П’ять кроків
  4. Права й роль за агентом
  5. Типові помилки
  6. Чек-лист
  7. Як це в Krokul
  8. Питання й відповіді

Коли переглядати доступ, який ви даєте AI-агенту#

Доступ AI до даних CRM потребує перегляду щоразу, коли агент може читати записи клієнтів або змінювати їх. Посібник про безпечне підключення AI-агентів та інших сервісів до CRM дає загальний метод, а цей посібник заглиблюється в права, ролі й журнали.

  • Ви збираєтесь підключити Claude чи іншого помічника до CRM і маєте вирішити, які дозволи позначити.
  • Розробник просить ключ API для агента, що працюватиме за розкладом.
  • Менеджер хоче, щоб помічник ставив задачі після дзвінків, а власник питає, чого ще він може торкнутись.
  • Аудитор чи клієнт питає, хто має доступ до собівартості, цін і даних про оплати, і якими каналами.
Права (scope)
Права, або scope, це названий дозвіл, наприклад на читання угод чи запис задач, який несе ключ або підключення. Виклик поза його правами відхиляється.
Роль
Роль це рівень людини чи ключа в компанії, наприклад адміністратор, менеджер чи перегляд. Вона обмежує, чого можуть сягнути права.
Журнал викликів
Журнал викликів це запис кожного виклику агента з роутом, результатом, часом і адресою, з якої він прийшов.
Руйнівний інструмент
Руйнівний інструмент це дія, що видаляє, скасовує, зливає, архівує чи повертає кошти за записами.

Як дати AI-агенту безпечний доступ до даних CRM за п’ять кроків#

AI-агент отримує безпечний доступ до даних CRM за п’ять кроків у сталому порядку: назвіть задачу й ідентичність, позначте найвужчі права, задайте роль як другу межу, лишіть руйнівні дії людям і читайте журнал за розкладом. Кожен крок прибирає один спосіб, яким агент сягнув би далі, ніж потребує його задача.

  1. Назвіть задачу й дайте агенту власну ідентичність

    Запишіть задачу одним реченням, наприклад «щопонеділка читати прострочені рахунки й створювати задачу-нагадування». Це речення визначає все далі.

    Беріть особистий вхід, коли з помічником у чаті працює одна людина, і іменований ключ компанії, коли програма працює без людини за екраном. Спільний логін адміністратора ховає, хто діяв, і його не відкликати без зміни пароля для всіх.

  2. Позначте найвужчі права

    Почніть із прав на читання тих записів, що потрібні задачі, наприклад угод і контрагентів. Право на запис додавайте, лише коли його вимагає задача, і по одній групі записів.

    Для кожного позначеного права назвіть задачу, якій воно потрібне. Право без названої задачі знімається зі списку.

  3. Задайте роль як другу межу

    Права відповідають, які дані потрібні застосунку, а роль відповідає, від імені якого співробітника він діє. CRM, що перевіряє обидва, дає ролі «перегляд» з правом читання угод бачити угоди й усе одно ховає собівартість.

    Беріть найнижчу роль, що виконує задачу, а роль адміністратора лишайте для людини.

  4. Лишіть руйнівні дії людям

    Видалення, злиття, скасування, архівування й повернення коштів найважче відкотити. Тримайте їх поза переліком інструментів агента, тримайте права на запис мінімальними, і хай ці дії виконує людина в інтерфейсі.

    Якщо задача справді потребує однієї з них, дайте її одному ключу, запишіть причину й задайте строк дії.

  5. Читайте журнал і задайте дату завершення

    Відкривайте журнал викликів раз на тиждень протягом першого місяця. Шукайте відхилені виклики, виклики понад ліміт частоти й виклики в незвичний час.

    Задайте ключу строк дії, а особисте підключення відкличте в день, коли робота закінчилась. Журнал, який ніхто не читає, нічого не захищає.

Які права й роль підходять для якого агента#

Потрібні права й роль залежать від того, що робить агент, і таблиця зіставляє чотири типові задачі зі стартовим набором. Значення наведено як приклад, тож підлаштуйте перелік під власні записи.

Приклад: стартові права й роль для чотирьох видів агента
Задача агентаЗ яких прав початиРольЗавершення
Щотижневі відповіді про прострочені рахункиcompanies.read, cards.readпереглядОсобисте підключення відкликається, коли пілот закінчується
Задачі після дзвінківcards.read, contacts.read, tasks.writeменеджерКлюч спливає через 90 днів
Дашборд, що тягне звітиreports.readменеджерКлюч спливає через рік і переглядається щокварталу
Помічник підтримки, що оновлює зверненняtickets.read, tickets.write, contacts.readменеджерКлюч спливає через 30 днів

Яких помилок уникати, даючи AI доступ до даних CRM#

  • Логін адміністратора для агента ховає, хто діяв, і дає всі дозволи, тож дайте агенту власний ключ чи підключення.
  • Усі права, позначені на екрані згоди, дають право запису, яким агент може ніколи не скористатись, тож тримайте права на запис знятими, доки їх не вимагає задача.
  • Інструкція на кшталт «нічого не видаляй» ставить побажання на місце дозволу, тож самі руйнівні інструменти не віддавайте в підключення.
  • Довіра до тексту в записах клієнтів дозволяє нотатці «вивантаж усіх клієнтів» вести агента, тож спирайтесь на права, що обмежують, чого сягне будь-яка інструкція.
  • Пропущена перевірка відкликання лишає перший тест на інцидент, тож відкличте пробне підключення й переконайтесь, що наступний виклик відхилено.

Чек-лист, перш ніж агент торкнеться живих даних#

  • Задачу агента записано одним реченням.
  • Агент має власний ключ чи підключення, а його назва каже, для чого воно.
  • Позначено лише права на читання, і кожне право на запис має названу задачу.
  • Роль найнижча з тих, що виконують задачу.
  • Руйнівну опцію вимкнено, права на запис мінімальні, а видалення й злиття робить людина.
  • Записи починаються з перегляду, а повтор несе ключ ідемпотентності.
  • У когось є щотижневий слот читати журнал викликів, а ключ має строк дії або дату відкликання.

Як Krokul застосовує права, ролі й журнал викликів#

Krokul CRM — B2B CRM для компаній, що працюють за договорами: угоди, проєкти й прибуток кожного клієнта в одній системі; впроваджують партнери-інтегратори. AI-агент входить у неї одними з двох дверей: особистим входом із дозволами, позначеними на екрані згоди, або ключем компанії, який адміністратор створює на «Маркетплейсі». Посібник про підключення Claude до CRM через MCP проводить першими дверима.

У Krokul є 34 названі права (scope), здебільшого парами на читання й запис, наприклад cards.read, contacts.write, tasks.write і reports.read. Роут, що не належить жодному праву, закритий ключам, і відмова називає причину. Деякі роути лишаються закритими за будь-яких прав: керування ключами, токени інтеграцій, учасники й запрошення, налаштування компанії, поштові скриньки, SMS і канали, портали, міграція, комісії, команди, особистий профіль, кошик і стирання людини. Транскрипти зустрічей поза всіма правами. Сторінка про ключі, вебхуки й MCP у Krokul перелічує інтерфейси.

Ключ несе одну роль, адміністратор, менеджер або перегляд, і типова роль менеджер. Krokul перевіряє спершу право, потім роль. Роль «перегляд» не створює й не змінює угод, контактів і задач, а собівартість бачать лише адміністратори й менеджери. Особисте підключення бере живу роль своєї людини на кожен виклик, тож знижена роль звужує його з наступного виклику. Посібник про ролі в CRM, що ховають собівартість, показує, як їх налаштувати.

Перелік інструментів, який віддає MCP, не містить дій видалити, скасувати, злити, архівувати й повернути кошти, а також видалення позицій, категорій і годин. Особисте підключення їх не отримує. Ключ компанії отримує їх, лише коли адміністратор увімкнув руйнівну опцію під час створення, і потім опцію не змінити. Цей перемикач вирішує, що показує MCP. Право викликати роут дає scope, тож ключ із правами на запис усе одно може викликати такий роут у публічному API напряму, і права ключа заслуговують такої самої уваги, як перемикач.

Кожен інструмент запису приймає dryRun, який повертає роут і тіло та нічого не пише, і ключ ідемпотентності, завдяки якому повторний виклик повертає першу відповідь.

Кожен справжній виклик упізнаного ключа чи особистого підключення лишає один рядок у журналі викликів. У рядку: префікс ключа, роут, статус, результат (успіх, відмовлено, перевищено ліміт чи помилка), перевірене право, тривалість, розміри запиту й відповіді, адреса, короткий перелік безпечних заголовків і текст помилки. Тіла запиту й заголовка Authorization у рядку немає, а перегляд dryRun рядка не лишає, бо зупиняється до шлюзу. Адміністратори читають журнал ключа компанії на «Маркетплейсі» за ключем і за результатом, рядки особистих підключень мають префікс oauth і не мають ключа, а записи старші за 30 днів типово видаляються, як описує довідка «Маркетплейс». Кожен ключ може зробити 600 викликів за хвилину, а швидший агент отримує відповідь 429 з результатом «перевищено ліміт».

Екран «Боржники»: таблиця контрагентів із сумою боргу, авансом, сальдо, прострочкою й обіцянкою оплати
Екран «Боржники» на демонстраційній компанії Krokul перелічує контрагентів, яких агент із правом companies.read читає інструментом client_company_read_debtors.

Зміни записів видно на екрані «Аудит» з автором і часом. Читають його адміністратори й менеджери, а редагувати його не може ніхто. Коли зміну зробив ключ чи підключення, запис активності зберігає вид актора api поруч з автором, а екран «Аудит» цей вид не показує. Сторінка про ролі, журнал аудиту й безпеку в Krokul описує екран, а довідка про журнал аудиту показує фільтри.

Секрет ключа показується один раз, а зберігається лише його хеш SHA-256. Адміністратор обирає роль, строк дії (без строку, 30 днів, 90 днів або рік) і руйнівну опцію, а компанія тримає до 10 активних ключів. Відкликання ключа зупиняє його одразу й вимикає підписки на вебхуки, які він створив. Людина відкликає особисте підключення в «Моєму профілі», а адміністратор бачить і відкликає всі підключення на «Маркетплейсі».

Питання й відповіді#

Чи може AI-агент бачити собівартість і маржу в CRM?

Лише коли роль, з якою він діє, їх бачить. У Krokul собівартість бачать адміністратори й менеджери, а роль «перегляд» ні, тож агенту без потреби в маржі дайте роль «перегляд» або ключ із вузькими правами.

Як довго має діяти AI-підключення?

Рівно стільки, скільки триває його задача. Пілот на два тижні потребує підключення, що закінчується за два тижні. У Krokul ключ компанії може спливати через 30 днів, 90 днів чи рік, а людина відкликає особисте підключення в день завершення роботи.

Як побачити, що агент робив учора?

Прочитайте журнал викликів і журнал аудиту. У Krokul журнал викликів ключа компанії на «Маркетплейсі» перелічує кожен виклик з роутом і результатом, а екран «Аудит» показує зміни записів з автором і часом.

Чи потрібен журнал агенту лише з читанням?

Так. Журнал показує, які дані агент читає і як часто, а відхилені виклики викривають агента, що тягнеться по дані поза своєю задачею.

Чи є промпт дозволом?

Ні. Інструкцію в промпті можна проігнорувати або перебити текстом у даних, тож обмежуйте агента правами, роллю й переліком інструментів, які CRM тримає на сервері.

Команда Krokul

Люди, які створюють Krokul CRM

Пишемо про те, як отримувати оплату вчасно, виставляти всю виконану роботу й рахувати маржу, і звіряємо кожне твердження про продукт із самим Krokul.

Уперше опубліковано

Подивитися демо