KeyCRM популярна серед українських інтернет-магазинів і сервісного бізнесу, і рано чи пізно власник питає: «А можна, щоб воно саме?». Можна, але до певної межі. Розбираємо, що публічне API KeyCRM дає автоматизувати, де воно зупиняється і що робити, коли потрібне саме те, чого в API немає.
Ми вивчили офіційну специфікацію API повністю, 7 983 рядки, коли будували AI-агента для DocumentPassport. Нижче висновки з цієї роботи.
Що вміє публічне API KeyCRM
Доступ до API дає ключ, який адміністратор створює в налаштуваннях акаунта. Запити підписуються цим ключем і відправляються з вашого сервера, а не з браузера.
Через API можна працювати з:
- картками у воронках: створювати, оновлювати, переносити між статусами;
- кастомними полями: записувати будь-які дані, які ви додали до картки;
- покупцями: контакти, телефони, історія;
- замовленнями: створення й оновлення з сайту чи іншого сервісу.
Цього достатньо для більшості типових зв'язок.
Що зазвичай автоматизують
Заявка з сайту чи лендінгу. Форма надсилає дані, і в KeyCRM одразу створюється картка з потрібними полями. Менеджер не переносить нічого вручну.
Статуси з зовнішнього сервісу. Оплата пройшла, запис підтвердився в календарі, і картка сама переходить на наступний етап.
Дані від AI-агента. Бот поспілкувався з клієнтом і записав у кастомні поля обрану послугу, телефон, дату, а в окреме поле короткий підсумок розмови. Менеджер відкриває картку і бачить готову заявку.
Статус як команда. Зовнішня система читає статус картки й поводиться відповідно. У проєкті DocumentPassport бот відповідає клієнтам лише тоді, коли картка в статусі «Новий лід» або «AI спілкується». Менеджер переводить картку в «Менеджер спілкується», і бот замовкає.
Частину простих сценаріїв KeyCRM закриває власними тригерами всередині воронок, без стороннього коду. API потрібне, коли в процесі бере участь ваша система або бот.
Чого API не вміє: чати
Ось тут межа. У публічному API KeyCRM немає жодного методу, щоб прочитати повідомлення з чату або надіслати туди нове. Картки, поля, покупці, замовлення є. Переписки немає.
Ми перепитали підтримку KeyCRM. Відповідь була письмова: передавати чати зі сторонніх платформ у KeyCRM поки неможливо, для цього потрібні нові методи в API.
Для бізнесу з чат-ботом наслідок відчутний. Бот відповідає клієнтам, а менеджер у KeyCRM цієї розмови не бачить. Щоб зрозуміти, про що бот уже домовився, треба відкривати окрему панель, а туди, як показує досвід, ніхто не ходить.
Як ми це вирішили
Для DocumentPassport ми знайшли спосіб показати розмову бота прямо в чаті KeyCRM, хоча офіційно сервіс такого не підтримує. Технічних подробиць не розкриваємо. Результат:
- повідомлення клієнта з'являються в чаті KeyCRM;
- відповіді бота мають мітку «🤖 Надія», людину від бота видно одразу;
- менеджер відповідає з того самого вікна KeyCRM, і клієнт отримує повідомлення в Telegram.
На 26 вересня 2026 року система продублювала в KeyCRM 125 повідомлень із 125 без збою і автоматично створила 96 карток. Детально про агента: AI-агент у KeyCRM: бот консультує в Telegram, менеджер бачить переписку в CRM.
Ризик, про який треба знати
Коли інтеграція спирається на недокументовану поведінку сервісу, сервіс може її змінити без попередження. Ми виходимо з того, що колись це станеться.
Тому переписку в чат KeyCRM у нас веде окремий модуль, який вимикається одним налаштуванням. Якщо він зламається, бот далі консультує клієнтів, а картки й статуси оновлюються через офіційне API. Команда на якийсь час втратить переписку в CRM, але не втратить заявки.
Питайте про це кожного, хто пропонує вам схожу інтеграцію. Відповідь «нічого не зламається» має насторожити.
Чекліст перед інтеграцією з KeyCRM
- Випишіть статуси воронки і для кожного вирішіть, чи може в ньому відповідати бот.
- Визначте поля, які бот має заповнити до передачі менеджеру.
- Домовтеся, хто в команді перемикає статус, коли забирає розмову.
- Вирішіть, де лежать ціни й відповіді: Google-таблиця, яку веде ваша людина, зручніша за промпт, який править розробник.
- Запитайте підрядника, що станеться з заявками, якщо KeyCRM змінить свою систему.
Скільки коштує
Підключення AI-агента до чатів KeyCRM коштує $500. Повний розбір проєкту: кейс DocumentPassport.
Маєте іншу задачу з API KeyCRM? Напишіть нам і опишіть процес, скажемо, що з нього можна автоматизувати.