Интеграции — вход для ИИ

Раздел «Интеграции» соединяет Helomi с маркетплейсами, сайтами, перевозчиками, оплатами и сообщениями. ИИ-сотрудник (Lomi, ваш Claude, ChatGPT или другой агент с токеном) может видеть здесь то же, что и человек с доступом к разделу, а настройки перевозчиков — ещё и предлагать изменить: каждое такое изменение применяется только после «Подтвердить» администратора. Ключи и токены ИИ не видит и не вводит никогда — их вписывает человек в полях формы.

10 минОбновлено 01.11.2026

Markdown для ИИ

Эта статья пока на украинском. Спросите Lomi на вашем языке — она прочитает статью и ответит. Поговорить с Lomi

На этой странице

Категорії каталогу («Усі», «Маркетплейси», «Сайти», «Перевізники», «Оплати», «Повідомлення», «ШІ», «Інше») стоять в одному ряду; коли він не влазить у вікно, гортайте його стрілками ‹ › по краях, коліщатком миші над рядом, перетягуванням мишею або пальцем на телефоні.

Можливості

ШІ бачить картки «Інтеграцій» зі станом: приєднано, увімкнено, чого бракує (лише назви ключів), остання помилка, журнал картки.
ШІ читає налаштування Нової Пошти, Укрпошти, Meest і Rozetka Delivery як у формі: акаунти-відправники, «Пов'язані статуси», «Пов'язані типи оплат та статуси», «Пов'язані поля», доступи, дефолти ТТН.
ШІ натискає «Перевірити» в акаунті перевізника — ключем акаунта, не бачачи його.
З доступом «Налаштування інтеграцій» ШІ пропонує зміну (наприклад, інший етап для статусу «Відправлення доставлено»), додає чи прибирає акаунт; зміна чекає «Підтвердити» адміністратора 24 години.
У картці підтвердження видно, що саме зміниться: рядки, етапи з назвами воронок, акаунти, які зникнуть разом із ключами.
Кожна застосована зміна — у журналі картки з підписом «ШІ <ім'я> · підтвердив <адміністратор>».
Блок «Структура» на картці кожного каналу продажів: бренд, філія і юрособа, які отримують угоди з цього каналу.

1Налаштування

Робить адміністратор.

Де розділ: «Налаштування» → група «Інтеграції» → «Усі інтеграції» (з 16.10.2026 пункту «Інтеграції» в головному меню нема). Там само «Вхідні вебхуки». Старі посилання на сторінки інтеграцій (/crm/integrations/…) працюють: адміністратора вони переводять у «Налаштування», а людина з галочкою «Інтеграції» без прав адміністратора бачить сторінку за старою адресою.

«Налаштування» → «Інтеграції» → вкладка «ШІ» → плитка ШІ-співробітника → «Налаштувати» (відкривається пульт) → вкладка «Доступи».
«Розділи» → галочка «Інтеграції» — ШІ бачить картки й налаштування перевізників (лише читання й «Перевірити»).
«Інтеграції» → галочка «Налаштування інтеграцій» — ШІ може пропонувати зміни налаштувань перевізників. Разом із нею ставиться і галочка розділу «Інтеграції».
«Зберегти доступи». Діє з наступного запиту ШІ.

«Спочатку запитати» для інтеграцій не вимикається: зміна інтеграції змінює потік замовлень, тому її завжди підтверджує людина-адміністратор. Агенти, яких створив сам ШІ, цього доступу не отримують.

Дозвіл дається кожному ШІ-співробітнику окремо, і діє однаково, хоч би як він зайшов: Ломі (екран, чат у пульті, ваш Claude чи ChatGPT з її файлом сесії), «Claude · сесія» та інші співробітники «… · сесія» із загального файлу сесії, ваш агент через MCP чи REST. Без галочки інструментів інтеграцій у нього нема, а спроба викликати їх отримує відмову «розділ закрито у «Доступах» цього ШІ». Файл сесії, створений до видачі дозволу, перелічує старі інструменти — створіть його заново; сам токен бачить нові інструменти одразу.

Що бачить і що може ШІ саме тут — «Інтеграції» → «⋮» → «Вхід для ШІ»: інструменти з описами, поля, адреса MCP і «Файл сесії».

Структура каналу: бренд, філія, юрособа

Блок «Структура» на картці каналу каже, під яким брендом, з якої філії і від якої юрособи продає цей канал: угоди з нього отримують ці значення самі, якщо людина не обрала інше в картці угоди. Блок однаковий у всіх каналів продажів — Prom, Rozetka, Kasta, Епіцентр, OLX, сайтів і Telegram — і задається для кожного кабінету (акаунта) окремо.

Відкрийте НалаштуванняІнтеграції й автоматизаціяМаркетплейси«Налаштування → Інтеграції й автоматизація → Маркетплейси» і натисніть картку каналу, наприклад «Prom». Для другого кабінету відкрийте його картку: «Підключення» → «Акаунти».
Перейдіть на вкладку «Налаштування продажів» — блок «Структура» стоїть одразу після поля «Джерело угод».
Виберіть «Бренд», «Філія» і «Юрособа». Рядок під кожним вибором підказує, що станеться: угоди з цього каналу отримають цей бренд, філію чи юрособу, якщо людина не обрала іншу в картці угоди.
Залиште «— не задано —» там, де значення має братися за загальною чергою.
Натисніть «Зберегти» внизу форми.

Приклад: у вас два кабінети Prom, і «Магазин 2» продає від ФОП Іваненко. Відкрийте картку кабінету «Магазин 2», у блоці «Структура» виберіть «Юрособа» — «ФОП Іваненко» і збережіть. Відтепер кожне замовлення з «Магазину 2» стає угодою з юрособою «ФОП Іваненко», а в «Даних угоди» поруч з нею написано «з картки каналу». Перший кабінет Prom, де юрособу не задано, і далі бере її за правилами.

У виборах — лише активні бренди, філії та юрособи. Якщо вибране значення потім відправили в архів, нові угоди каналу отримують бренд, філію чи юрособу далі за загальною чергою — виберіть у блоці «Структура» інше.

Примітка

Юрособа з картки каналу важливіша за правило з умовою «Канал (картка «Інтеграцій»)», але поступається юрособі, яку людина вибрала в угоді рукою. Повна черга для бренду, філії й юрособи — у статті Філії та структура.

2ШІ читає налаштування перевізника

Попросіть ШІ, наприклад: «Подивись налаштування Meest — які статуси куди ведуть». ШІ відкриває ті самі дані, що й форма «Інтеграції» → «Перевізники» → «Meest» → «Налаштування»: акаунти з дефолтами, доступи, «Пов'язані статуси», поля угоди. Замість ключів він бачить лише «задано / не задано» й останні чотири символи (••••1234).

3ШІ пропонує зміну, адміністратор підтверджує

Ви просите ШІ: «У Meest статус "Відправлення доставлено" має вести на етап "Отримано"».
ШІ готує зміну тим самим маршрутом, що й кнопка «Зберегти» форми, але вона не застосовується: ШІ отримує відповідь «чекає підтвердження» і каже вам про це.
У пульті цього ШІ → «Огляд» → «Чекають підтвердження» з'являється картка: «Meest: змінити налаштування» і рядки, наприклад «Пов'язані статуси: «Відправлення доставлено» — етап «Відправлено» (Продажі) → етап «Отримано» (Продажі)». Підпис — «зміна інтеграції — підтверджує адміністратор».
«Підтвердити» (лише адміністратор) — зміна зберігається з тими самими перевірками, що й у формі (етап існує, користувач існує, поле угоди існує); у журналі картки Meest з'являється «налаштування перевізника збережено (ШІ <ім'я> · підтвердив <ви>)». «Відхилити» — нічого не змінюється.

Так само ШІ додає акаунт-відправника (ключі до нього потім вписує людина), прибирає акаунт (картка попередить: «акаунт зникне разом із його ключами») і створює список відправлень Укрпошти.

4Ключі й токени

NP_API_KEY, MEEST_TOKEN, MEEST_CONTRACT_ID, UP_BEARER, UP_BEARER_TRACKING, UP_TOKEN, RZ_LOGIN, RZ_PASSWORD, RZ_STATIC_TOKEN вписує лише людина-адміністратор у полях акаунта у формі перевізника. Інструмента для ключів у ШІ нема, маршрут ключів відмовляє ШІ навіть із підтвердженням, а налаштування, які бачить ШІ, ключів не містять. Якщо для роботи бракує ключа, ШІ назве, який саме ключ і в якому акаунті вписати.

Картки маркетплейсів і сайтів ШІ бачить лише в загальному списку зі станом: адреса вебхука сайту (з токеном), ключі каналів і перемикач приймання замовлень — тільки для людини.

Можливі помилки

Що ви бачите	Чому	Що зробити
«Інструмент «integrations_…» недоступний: розділ закрито у «Доступах» цього ШІ»	Немає галочки «Інтеграції» або «Налаштування інтеграцій»	Адміністратор ставить галочку в «Доступах» пульта ШІ
«Зміни налаштувань інтеграцій підтверджує адміністратор»	«Підтвердити» натиснула людина, яка не адміністратор	Попросіть адміністратора
«Зміну інтеграції від ШІ застосовує лише «Підтвердити» адміністратора в пульті ШІ»	Спроба змінити налаштування повз підтвердження	Нічого не робити: так і має бути
«Ключі й токени вписує людина в полях форми — ШІ їх не вводить»	ШІ спробував записати ключ	Ключ вписує адміністратор у формі перевізника
«Етапу не існує: …» / «Поля угоди не існує: …»	ШІ запропонував етап чи поле, яких нема	Відхиліть дію й уточніть ШІ етап або поле
«Строк підтвердження минув (24 год)»	Дію не підтвердили вчасно	Попросіть ШІ повторити

Для ШІ-співробітників

Ключ розділу — integrations (describe_section("integrations")). Читання — доступ «Інтеграції»; зміни — ще й доступ «Налаштування інтеграцій».

Інструмент	Що робить
`integrations_list`	Картки зі станом: `kind`, назва, група, увімкнено, приєднано, `missing` (назви ключів), остання помилка; у перевізників — `carrier`, `carrier_accounts`
`integrations_log`	Журнал картки (`kind`, `limit`)
`integrations_carrier_get`	Налаштування перевізника (`kind`: `nova_poshta`, `ukrposhta`, `meest`, `rozetka_delivery`): `settings` і `options` (воронки з етапами, користувачі, поля угоди, статуси служби, типи оплат). Ключі — лише `{set, hint}`
`integrations_carrier_statuses`	Статуси служби для «Пов'язаних статусів»
`integrations_carrier_np_senders`	Нова Пошта: відправники й контактні особи ключем акаунта (`key`)
`integrations_carrier_check`	«Перевірити» акаунт (`kind`, `key`): `{ok, message, sender}`
`integrations_carrier_update`	Змінити налаштування: `values` — лише ключі, які змінюєте; списки (`status_map`, `payment_status_map`, `accounts`) — цілком, як у `integrations_carrier_get`. Завжди чекає «Підтвердити» адміністратора
`integrations_carrier_account_add`	Новий акаунт (`values.name`). Чекає підтвердження
`integrations_carrier_account_delete`	Прибрати акаунт (`key`) разом із ключами. Чекає підтвердження
`integrations_carrier_list_create`	Укрпошта: список відправлень (`values.name`, `type`, `account`). Чекає підтвердження

SMS (TurboSMS) — окремий розділ каталогу sms з інструментами sms_* (налаштування кабінету, перегляд тексту, відправка через «спочатку запитати», журнал і статуси доставки; підписи й шаблони — з тим самим доступом «Налаштування інтеграцій» і «Підтвердити» адміністратора): SMS (TurboSMS).

Як змінити етап у «Пов'язаних статусах»: integrations_carrier_get → взяти settings.status_map → змінити stage_id потрібного рядка на id етапу з options.funnels[].stages[] → integrations_carrier_update з values: {"status_map": <увесь список>} → отримати pending_id і сказати людині, що зміна чекає підтвердження в пульті.

Чого не робити:

Не просити людину надіслати ключ у чат і не намагатися його записати — скажіть, який ключ і в якому акаунті вписати у формі.
Не надсилати частину списку: рядок status_map чи акаунт, якого нема у values, буде прибрано (акаунт — разом із ключами).
Не вигадувати stage_id, access_user_ids, ключі полів угоди — брати з options.
Не повторювати дію, що вже чекає підтвердження (pending_actions).
Не змінювати блок «Структура» картки каналу: бренд, філію і юрособу каналу задає людина. Звідки угода взяла юрособу, ШІ дивиться інструментом deals_coords (підпис «з картки каналу»).

Додаткова інформація

Пов'язані статті: Філії та структура, Prom, Rozetka, SMS (TurboSMS), Нова Пошта, Укрпошта, Meest, Rozetka Delivery, ШІ-співробітники, Доставки і ТТН.

Эту же статью читают ИИ-сотрудники Helomi: help("integrations")