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

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

Як безпечно підключити AI-агентів та інші сервіси до CRM

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

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

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

  • Кроків: шість
  • Перші права: лише читання
  • Кожна зміна: спершу в перегляді
На цій сторінці
  1. Коротка відповідь
  2. Навіщо окремі двері
  3. Шість кроків
  4. Який канал обрати
  5. Підключити Claude через MCP
  6. Безпечний доступ AI
  7. Що таке MCP
  8. Приклади автоматизацій CRM
  9. Вебхуки
  10. Власні правила інтеграцій
  11. Синхронізація з обліком
  12. Zapier, Make і n8n
  13. Ролі для собівартості й маржі
  14. Налаштувати з помічником
  15. Початкове налаштування
  16. Типові помилки
  17. Чек-лист
  18. Питання й відповіді

Навіщо агентові чи сервісу власні двері в CRM#

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

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

AI-агент
AI-агент є програмою, якою керує мовна модель: вона викликає інструменти іншої системи, щоб читати дані чи вносити зміни від імені людини.
MCP
MCP (Model Context Protocol) є стандартом, за яким AI-клієнт, як-от Claude, викликає інструменти іншої системи через одну адресу.
Вебхук
Вебхук є HTTP-викликом, який система надсилає на вашу адресу, коли стається подія, наприклад коли угоду виграно.
Ключ API
Ключ API є секретом, що впізнає програму в API системи й несе роль, права та строк дії.
Пробний прогін
Пробний прогін є спробою зміни чи правила, що показує, що сталося б, і нічого не записує.

Шість кроків безпечного підключення агента чи сервісу#

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

  1. Визначте одну задачу підключення

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

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

  2. Дайте підключенню власний доступ

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

    Тоді CRM покаже підключення за імʼям у журналі й відкличе його, не чіпаючи нікого іншого.

  3. Спершу видайте доступ на читання

    Почніть із прав на читання, проведіть перші проби й додавайте права на зміну записів по одній родині. Видалення й злиття лишайте людям.

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

  4. Перегляньте кожну зміну до запису

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

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

  5. Читайте журнал за розкладом

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

    Журнал, якого ніхто не читає, нічого не захищає.

  6. Задайте строк і спосіб відкликання

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

Який канал підходить до якої задачі#

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

Який канал підходить до якої задачі
ЗадачаКаналНапрямокПосібник
Питати Claude про угоди, боржників чи звіти з чатуПідключення MCP з особистим входомЛюдина до CRMПідключити Claude через MCP
Запустити агента, коли за екраном нікого немаєАдреса MCP з ключем API компаніїАгент до CRMБезпечний доступ AI до даних CRM
Створити задачу чи надіслати повідомлення, коли щось стаєтьсяПравило автоматизації з тригером і діямиУсередині CRMПриклади автоматизацій CRM
Передавати події CRM у власну системуВихідний вебхукCRM у вашу системуВебхуки CRM
Приймати події від сервісу без конектораВласне правило інтеграції з окремою адресоюСервіс до CRMВласні правила інтеграцій
Тримати рахунки й оплати в ладу з облікомЧерга синхронізації й журнал для облікової системи (QuickBooks ще не звірено живим акаунтом)ЗапланованоСинхронізація з QuickBooks Online
Підключити Zapier, Make чи n8nВебхуки й APIВ обидва бокиZapier, Make і n8n
Налаштувати CRM, описавши бізнесПомічник із кроком підтвердженняЛюдина до CRMНалаштувати CRM з помічником

Як підключити Claude до CRM через MCP#

Krokul CRM — B2B CRM для компаній, що працюють за договорами: угоди, проєкти й прибуток кожного клієнта в одній системі; впроваджують партнери-інтегратори. Його MCP-сервер відповідає за адресою https://app.krokul.com/mcp, і Claude підключається до неї як власний конектор.

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

Перелік інструментів будується з тієї самої специфікації, що й API Krokul, тож інструмент ніколи не робить того, що забороняє API. Інструменти, які створюють чи змінюють записи, приймають пробний прогін, а сторінка про інтеграцію з Claude описує шлях через вхід.

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

Як тримати доступ AI до даних CRM безпечним#

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

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

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

Що таке MCP і що він змінює для даних CRM#

MCP дає AI-клієнтові один стандартний спосіб спитати систему, що вона вміє, і викликати ці інструменти, тож CRM не потребує окремого розширення для кожного асистента. У Krokul назви походять від роутів API, і card_read_list є інструментом для роута card/api-readList.

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

Які автоматизації CRM заощаджують години#

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

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

  • Угода без активності 7 днів створює задачу менеджерові домовитись про наступний крок.
  • Оплата, прострочена на один день, створює задачу нагадати контрагентові.
  • Договір, що спливає за 14 днів, створює задачу домовитись про продовження.
  • Контрагент, що не купував 3 місяці, створює задачу звʼязатися.

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

Як синхронізувати події CRM із власною системою через вебхуки#

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

Кожна доставка може нести підпис, HMAC-SHA256 від мітки часу й тіла, зроблений секретом підписки, та ідентифікатор доставки для дедуплікації. Перевіряйте підпис, перш ніж довіряти тілу. Krokul відхиляє адреси приймача в приватних мережах, а приймач, що відповів 410 Gone, одразу вимикає підписку.

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

Тіло події має поля event, data, entity, companyUuid і sentAt та не несе готового тексту повідомлення. Чат-інструменту, що чекає текст, потрібен один крок посередині. Налаштування крок за кроком описують посібник про вебхуки CRM і довідка про вебхуки.

Як підключити сервіс, для якого в CRM немає конектора#

Власне правило інтеграції підключає CRM до вашого сервісу без програмування: сервіс надсилає подію на адресу, а правило каже, як знайти запис і що створити. У Krokul кожне правило має власну адресу виду /ingress/rule/ із токеном, і правило може вимагати підпис HMAC-SHA256.

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

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

Як синхронізувати рахунки CRM із обліковою системою#

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

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

Порада. Спершу надішліть кілька рахунків і порівняйте підсумки в обох системах, перш ніж синхронізація охопить усе.

Як підключити CRM до Zapier, Make чи n8n#

CRM підключається до Zapier, Make чи n8n вебхуком в один бік і API в інший. Вебхук Krokul надсилає події на адресу «Catch Hook» сценарію, а HTTP-модуль платформи викликає API Krokul із ключем.

Дайте платформі власний ключ API з роллю, що відповідає сценарію, і префікс ключа впізнає її виклики в журналі викликів. API відповідає 429 із заголовком Retry-After, коли сценарій шле надто швидко, тож додайте паузу до масових сценаріїв. Кроки показує посібник про підключення CRM до Zapier, Make чи n8n.

Як налаштувати ролі в CRM, щоб собівартість і маржу бачили лише ті, кому треба#

Собівартість і маржа лишаються приватними, коли CRM ховає їх на сервері від кожної ролі без права їх бачити, незалежно від каналу. У Krokul собівартість бачать адміністратори й менеджери, а решта ролей не отримують цих полів ні в інтерфейсі, ні у звітах, ні в API.

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

Як налаштувати CRM, описавши бізнес AI-помічнику#

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

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

Який вигляд має безпечне початкове налаштування#

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

Приклад: три підключення та їхні межі
ПідключенняДоступПраваКінець
Claude для керівника продажівОсобистий вхідЛише читання два тижні, потім створення задачВідкликається в «Моєму профілі», коли пілот закінчиться
Білінговий сервіс, що викликає APIКлюч компанії, створений для сервісуРоль без собівартості, руйнівні інструменти вимкненоСпливає за 90 днів
Вебхук у фінансову системуПідписка із секретомЛише події invoice.paid і payment.receivedВимикається, коли систему замінять

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

Яких помилок уникати, підключаючи агентів і сервіси#

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

Чек-лист перед тим, як вмикати підключення#

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

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

Чи може AI-агент видаляти записи в CRM?

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

Чи безпечно давати AI-асистентові пароль від CRM?

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

Як швидко зупинити AI-підключення?

Відкличте його, і доступ припиниться одразу. У Krokul людина відкликає особисте підключення в «Моєму профілі» в блоці «Підключені застосунки», а адміністратор відкликає будь-яке підключення чи ключ API на «Маркетплейсі».

Як дізнатись, що агент зробив у моїй CRM?

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

Чи потрібен розробник, щоб підключити CRM до інших інструментів?

Чат-асистент підключається без коду, а сервіс, що вміє надсилати JSON на адресу, підключається власним правилом. Розробник допомагає, коли потрібен власний застосунок чи перевірка підпису, а чинний бізнес із даними для перенесення може замовити налаштування в партнера-інтегратора.

Команда Krokul

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

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

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

Статті цієї теми

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

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

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

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

API-ключі й публічний API: що автоматизувати першим

Автоматизуйте через API CRM у такому порядку: спершу ключ лише на читання, що вивантажує угоди чи оплати в таблицю або BI, потім записи, що створюють картки з ваших форм чи продукту, потім оплати з бухгалтерії.

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

Як створити правило автоматизації в Krokul крок за кроком

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

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

Як підключити Claude до CRM через MCP

Щоб підключити Claude до CRM через MCP, додайте адресу MCP-сервера CRM у Claude як власний конектор, увійдіть у CRM, оберіть компанію й дозвольте лише ті права, яких Claude потребує.

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

Як отримувати замовлення WooCommerce чи Shopify у CRM

Щоб отримувати замовлення WooCommerce чи Shopify у Krokul, підключіть картку магазину в Маркетплейсі, скопіюйте адресу, яку дає Krokul, у налаштування вебхука магазину, додайте секрет підпису й оберіть воронку.

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