Интеграции, перенос данных и API-ключи

В разделе Интеграции (/app/integrations) вы подключаете reactive.chat к инструментам, которыми уже пользуется команда. Интеграции действуют во всём рабочем пространстве. Настраивать их могут владельцы и администраторы; администратор с доступом лишь к отдельным проектам этого делать не может.

Эта страница описывает возможности интеграций и работу с ними. Технические подробности, например подпись вебхуков, находятся в разделе Техническая интеграция.

Честно о текущем состоянии

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

Настройка интеграции

1. Откройте Интеграции. Вверху видно, сколько подключено, сколько с ошибкой или приостановлено и есть ли неудачные доставки.
2. Найдите сервис в каталоге (Поиск интеграций, фильтр «Все» или «Не подключены») и нажмите Настроить.
3. Введите запрошенные сервисом учётные данные — обычно API-ключ или токен из вашего аккаунта в этом сервисе.
4. Подключить и активировать сразу проверяет соединение и включает интеграцию. Кнопка Сохранить без активации позволяет отложить это.

Позже интеграцию можно Изменить, Приостановить, Снова активировать или Удалить. Удаление стирает сохранённые учётные данные и необратимо. Учётные данные хранятся в зашифрованном виде.

Кнопка входа в сервис есть только для Google Drive. Во всех остальных случаях вы вводите учётные данные самостоятельно; например, для Slack — данные собственного приложения 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); на странице есть примеры. Работа интерфейса описана в разделе Техническая интеграция.