Інтеграції, перенесення та ключі API

У розділі Інтеграції (/app/integrations) ви підключаєте reactive.chat до інструментів, які вже використовує команда. Інтеграції діють на весь робочий простір. Їх можуть налаштовувати власники й адміністратори; адміністратор з доступом лише до окремих проєктів — ні.

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

Відверто про поточний стан

Доступні підключення до понад 30 сервісів. Більшість перевірено на змодельованих відповідниках, але вони ще не працювали зі справжнім сервісом. На сторінці інтеграцій вони мають позначку «Не перевірено зі справжнім сервісом»; деякі — «У роботі». Вебхуки та Slack не мають цієї примітки. Налаштуйте неперевірену інтеграцію, протестуйте її зі справжніми даними та повідомте через Надіслати відгук, якщо щось не так.

Налаштування інтеграції

1. Відкрийте Інтеграції. Угорі видно кількість підключених інтеграцій, інтеграцій із помилкою або на паузі та наявність невдалих доставок.
2. Знайдіть потрібну в каталозі (Пошук інтеграцій, фільтр «Усі» або «Не підключено») та натисніть Налаштувати.
3. Введіть облікові дані, яких потребує сервіс, — зазвичай ключ API або токен із вашого облікового запису там.
4. Підключити й активувати одразу перевіряє з’єднання та вмикає інтеграцію. Через Зберегти без активації це можна відкласти.

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

Кнопка входу в сервіс є лише для Google Drive. Для всіх інших ви самі вводите облікові дані, наприклад дані власного застосунку Slack.

Коли сервіс не відповідає

Кожна інтеграція працює через чергу. Якщо сервіс не відповідає, доставка повторюється кілька разів зі зростанням інтервалів; після повторних збоїв її на деякий час призупиняють («Тимчасово призупинено: сервіс не відповів кілька разів …»). Подія, яку не вдалося доставити приблизно за годину, відкидається. Останні невдалі доставки показано в розділі Невдалі доставки, без їхнього вмісту.

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

Що доступно

Сповіщення команді

• Slack — кожна нова розмова з’являється як гілка в каналі. Ви відповідаєте в гілці, а відвідувач бачить відповідь у чаті. /rc показує стан. Користувачів Slack ви зіставляєте з операторами.
• Microsoft Teams, Discord — сповіщення через адресу вебхука.
• Telegram — сповіщення в чат за токеном бота та ID чату.
• Електронна пошта — сповіщення в поштову скриньку команди.

Автоматизація

• Вебхуки — reactive.chat надсилає підписані події на вибрану вами адресу з https:// на початку: нова розмова, кожне повідомлення, запит передачі людині, виставлення оцінки, нова помилка. Zapier, Make та n8n теж підключаються так. Секрет підпису можна показати, скопіювати й створити заново; новий секрет діє одразу, а старий більше не працює.
• Zapier — через REST hooks інтерфейсу. Готового застосунку для Make та n8n поки немає; використовуйте вебхуки.

Контекст у панелі операторів

Ці інтеграції показують у колонці контексту картки про відвідувача, наприклад його замовлення або контакт у CRM, деякі — з діями:

• CRM — HubSpot, Pipedrive
• Магазин — Shopify, Shopware 6, WooCommerce
• Платежі — Stripe (з обмеженим ключем читання)
• Сайт — WordPress
• Аналітика — Matomo, Plausible, Google Analytics 4
• Помилки — Sentry

Картка позначає відомості, що ґрунтуються на непідписаному твердженні відвідувача. Дії виконуються через Виконати з підтвердженням.

Задачі, зустрічі, телефон

• Zendesk, Freshdesk, Jira, Linear, GitHub — створення звернень або задач із розмови чи помилки.
• Cal.com — показ і бронювання вільного часу, зокрема через ШІ-асистента.
• Twilio — SMS із панелі операторів та шлях надсилання для каналу SMS.

Джерела знань

• Notion, Confluence — додавання вмісту до бази знань.
• Google Drive — у базі знань, «Файли та Google Drive» (див. База знань і центр допомоги).
• KB-Crawler — налаштування обходу вашого сайту.

Канали

• WhatsApp Business, Facebook Messenger, Instagram Direct — див. Канали.

Перехід з іншого сервісу

У розділі Перенесення (/app/migration) ви переносите дані з іншого інструмента чату:

• Intercom і Crisp — через їхній інтерфейс або файл експорту; для Crisp також статті довідки як Markdown,
• Tidio — через файл експорту,
• Zendesk — через повний експорт JSON та експорт центру допомоги.

Порядок дій:

1. Почати нове перенесення та вибрати ціль (До якого проєкту?).
2. Підключитися й переглянути наявне — ви побачите, що є, та зразок.
3. Що перенести? — контакти, розмови, статті.
4. Почати перенесення. Можна Зупинити або Відкинути завдання.

Що варто знати:

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

Через Замінити фрагмент обліковий запис перетворює наявний фрагмент Intercom або Crisp на фрагмент reactive.chat. Команди JavaScript boot, open, identify та track зберігають ті самі назви, що й в Intercom.

Ключі API

У розділі Ключі API (/app/api-keys, власники й адміністратори) ви створюєте ключі для REST-інтерфейсу. Ключ показується рівно один раз; після цього reactive.chat зберігає лише його відбиток. Тому одразу скопіюйте його в безпечне місце.

Під час створення ви обираєте дозволені дії:

• лише читання
• читання й запис
• лише імпорт даних клієнтів — для імпорту, описаного в розділі Дані клієнтів у чаті
• читання + дані відвідувача або читання, запис + дані відвідувача — лише з ними ключ бачить ім’я, електронну пошту й телефон відвідувачів

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

За допомогою ключа можна також підключити reactive.chat до інструментів ШІ, що підтримують Model Context Protocol (MCP); на сторінці є приклади. Роботу інтерфейсу описано в частині Технічна інтеграція.