Интеграции | Napulse

Интеграции

«Интеграции» — каталог внешних подключений проекта. Здесь подключают каналы общения через Umnico (WhatsApp, Instagram и другие), внешнего ИИ-ассистента через MCP (например, Claude или другое приложение, которое умеет работать с MCP) и выпускают API-ключи для собственных программ. Раздел нужен владельцу школы и техническому специалисту; подключить ИИ «для себя» может и менеджер, если ему выдано право.

Где найти: меню → «Интеграции». Кто видит: каталог и Umnico — право «Интеграции: просмотр». Подключать свой ИИ через MCP и выпускать ключи — «Подключать ИИ (MCP)»; видеть и отключать подключения всех сотрудников и выключать MCP в проекте — «Управлять подключениями ИИ». Эти два права не зависят от «Интеграции: просмотр». Владелец проекта имеет их всегда.

Как устроен экран

Каталог интеграций
Рис. 1. Пункт «Интеграции» и три карточки: Umnico, MCP, API

  1. Название проекта — подключения всегда относятся к текущему проекту.
  2. «Поиск интеграций» — поиск по названию и описанию.
  3. Карточки — «Umnico» (каналы общения), «MCP» (ИИ-ассистенты), «API» (разработка). Внизу карточки — состояние: «Доступно для настройки» или «Требуется настройка сервиса». Нажмите на карточку, чтобы открыть её настройки; кнопка «Все интеграции» возвращает в каталог.

MCP: как подключить внешнего ИИ-ассистента

MCP позволяет работать с данными школы из привычного ИИ-приложения: попросить «покажи выручку за месяц», «найди в базе знаний скрипт для возражения “дорого”», «создай задачу», «подготовь черновик робота». Модель работает на стороне вашего приложения. Подключение действует от вашего имени: ИИ видит только то, что видите вы, и не получает больше ваших прав.

Страница MCP
Рис. 2. Страница «Подключите AI к Napulse»

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

Что можно подключить
Рис. 3. Список возможностей подключения

Как подключить ИИ-приложение через вход в браузере

Так подключаются Claude и другие ИИ-приложения, которые умеют работать с удалённым MCP-сервером. Для ChatGPT шаги чуть отличаются — см. «Подключение ChatGPT».

  1. Откройте «Интеграции» → «MCP» и скопируйте адрес сервера из блока «Подключить AI-ассистента».
  2. В своём ИИ-приложении добавьте удалённый MCP-сервер с этим адресом и выберите вход через браузер.
  3. Откроется страница Napulse «Разрешить подключение?». Проверьте название приложения в строке «Приложение «…» запрашивает доступ к Napulse от вашего имени».
  4. Проверьте проект. Если у вас один проект, он указан в строке «Выбранный проект». Если проектов несколько, выберите нужный в списке «Проект подключения» — например, «Звёздный путь» (подробнее — в «Экран согласия»).
  5. Выберите, что сможет ИИ: «Всё, что могу я», «Только просмотр» или «Выбрать вручную».
  6. Посмотрите строку «ИИ получит инструментов: N» и нажмите «Разрешить подключение».
  7. Вернитесь в приложение и задайте первый вопрос — например, из блока «Попробуйте после подключения».

Готово: подключение появится в «Подключения и журнал» → «Мои подключения» с типом «Браузер: <название приложения>». Вход через браузер действует до 30 дней, потом приложение нужно подключить заново.

Экран согласия

Новое с 22.10.2026. Экран «Разрешить подключение?» теперь явно спрашивает проект и заранее показывает, сколько инструментов получит ИИ.

  • Проект. Подключение работает только с одним проектом. Если у вас несколько проектов, Napulse больше не берёт молча последний открытый: в списке «Проект подключения» сначала стоит «Выберите проект», а разрешения и кнопка «Разрешить подключение» недоступны, пока вы не выберете проект. Под списком подсказка: «Выберите проект, к которому подключить приложение. Подключение получит доступ только к нему.» После выбора она меняется на «Подключение получит доступ только к этому проекту. Разрешения и число инструментов ниже посчитаны для него.»
  • Число инструментов. Под разрешениями видна строка «ИИ получит инструментов: N». Инструмент — одно действие, которое ИИ может выполнить в Napulse: прочитать диалог, создать задачу, показать отчёт. Число пересчитывается, когда вы меняете режим или отмечаете разрешения; пока идёт подсчёт, написано «Считаем инструменты…».
  • Ноль инструментов. Если с выбранными разрешениями ИИ не получит ни одного инструмента, появляется предупреждение «С этими разрешениями ИИ не получит ни одного инструмента, и приложение не увидит Napulse. Выберите другие разделы или другой режим.», а кнопка «Разрешить подключение» недоступна. Так бывает, если в «Выбрать вручную» отмечены разделы, к которым у вас нет прав в этом проекте. Выберите другие разрешения или режим «Только просмотр».
  • «Отказать» — закрывает запрос без подключения.

Готово: если число инструментов больше нуля и проект выбран верно, нажимайте «Разрешить подключение» — приложение увидит ровно эти инструменты.

Адрес подключения для одного проекта

Новое с 22.10.2026. У каждого проекта есть номер (начинается с 10000) и свой адрес подключения вида https://napulse.co/mcp/p/10000. Подключение по такому адресу работает только с этим проектом, поэтому проект не перепутается, даже если у вас их несколько. Общий адрес https://napulse.co/mcp работает как раньше: проект выбирается на экране согласия.

  1. Откройте «Интеграции» → «MCP». В блоке адресов есть две строки: «Адрес этого проекта» и «Общий адрес (проект выбирается при подключении)».
  2. Нажмите «Скопировать» у строки «Адрес этого проекта».
  3. В ИИ-приложении добавьте коннектор с этим адресом и назовите его по проекту, например «Napulse — Звёздный путь». Так в приложении будет понятно, какой коннектор к какому проекту ведёт.
  4. На экране согласия вместо выбора проекта будет строка «Проект задан адресом подключения (№ …). Другой проект выбрать нельзя.» Выберите режим и нажмите «Разрешить подключение».

Готово: коннектор всегда работает с одним проектом. Для второго проекта добавьте ещё один коннектор с его адресом.

Если на экране согласия написано, что у вас нет доступа к этому проекту, значит адрес скопирован из чужого проекта. Попросите доступ у владельца проекта или подключите приложение по адресу своего проекта.

Подключения и журнал
Рис. 4. Подсказки запросов и блок «Подключения и журнал»

Подключение ChatGPT

Новое с 21.10.2026. ChatGPT подключается к Napulse так же, как другие ИИ-приложения, — через вход в браузере, и получает все инструменты, которые вы ему разрешили: сделки, диалоги, задачи и доски задач, база знаний, отчёты и другие. Раньше после входа ChatGPT мог показать «Authentication succeeded, action discovery failed» («вход выполнен, но действия не найдены») и не видел ни одного инструмента. Чаще всего это случалось, когда в подключение входили задачи. Причина была на стороне Napulse, сейчас она исправлена.

Подключать коннекторы в ChatGPT можно не на всех тарифах ChatGPT, а названия пунктов меню в нём со временем меняются. Если вы не находите нужный пункт, смотрите справку ChatGPT о подключении своих MCP-коннекторов.

  1. В Napulse откройте «Интеграции» → «MCP» и скопируйте адрес сервера из блока «Подключить AI-ассистента».
  2. В ChatGPT откройте настройки → раздел приложений и коннекторов. Если там есть «Расширенные настройки» с режимом разработчика, включите его: без него свой коннектор не добавить.
  3. Нажмите создание нового коннектора. Впишите название, например «Napulse — Звёздный путь», вставьте адрес сервера из шага 1, в способе входа выберите OAuth и подтвердите, что доверяете этому приложению.
  4. ChatGPT откроет страницу Napulse «Разрешить подключение?». Если у вас несколько проектов, выберите нужный в списке «Проект подключения». Выберите, что сможет ИИ («Всё, что могу я», «Только просмотр» или «Выбрать вручную»), убедитесь, что в строке «ИИ получит инструментов: N» число больше нуля, и нажмите «Разрешить подключение». Новое с 22.10.2026: с нулём инструментов кнопка недоступна — именно такое подключение раньше давало «action discovery failed».
  5. Вернитесь в ChatGPT. В новом чате включите коннектор Napulse и задайте вопрос, например: «Покажи мои задачи на сегодня» или «Сколько оплат было за эту неделю».

Готово: ChatGPT видит инструменты Napulse, а подключение появилось в «Подключения и журнал» → «Мои подключения» с типом «Браузер: ChatGPT» (название может немного отличаться). Каждое действие ChatGPT видно в «Журнале вызовов».

Если ChatGPT всё ещё пишет «action discovery failed»:

  1. Удалите коннектор в ChatGPT и в Napulse нажмите «Отключить» у старого подключения ChatGPT.
  2. Подключите ChatGPT заново по шагам выше: старый коннектор мог запомнить пустой список действий.
  3. Если ошибка повторяется, попробуйте «Только просмотр». Если так подключается, а «Всё, что могу я» — нет, сообщите в поддержку Napulse, какие разрешения вы выбирали.

Что сможет ИИ

  • «Всё, что могу я» — ИИ может всё, что можете вы в этом проекте, включая ответы клиентам и рассылки, если они вам доступны. Если вам добавят или заберут право, ИИ получит или потеряет его со следующего действия.
  • «Только просмотр» — ИИ только читает данные и отчёты, ничего не меняет и не пишет клиентам.
  • «Выбрать вручную» — отметьте только нужные разрешения. Опасные возможности (удаление, секреты каналов, «войти как», пароли, оплата тарифа) показаны отдельной группой «Особые».

Новое с 21.10.2026. Если ИИ попросит сделать то, на что у вас нет права, он получит понятный ответ «Нет права «…»» с названием права, как в «Структуре проекта». ИИ может пересказать его вам — передайте это название руководителю, если право вам нужно для работы.

Подключения и журнал

  • «Мои подключения» — ваши подключения: тип, название, дата создания, «Последнее использование», режим и кнопка «Отключить».
  • «Все подключения проекта» — подключения всех сотрудников (только с правом «Управлять подключениями ИИ»).
  • «Журнал вызовов» — что делал ИИ: время, сотрудник, действие простыми словами («Чтение сообщений диалога», «Создание задачи», «Ответ клиенту»), объект и результат («Выполнено», «Доступ разрешён», «Отказано: нет доступа», «Ошибка»). Записи хранятся 180 дней.
  • Флажок «Показать отключённые» добавляет в список уже отключённые подключения.

Как отключить ИИ

  1. Откройте «Интеграции» → «MCP» или «API».
  2. В «Подключения и журнал» найдите подключение и нажмите «Отключить», затем подтвердите.

Готово: следующие запросы этого подключения будут отклонены. Уже выполненные действия не отменяются.

API: ключ для своей программы

API-ключ нужен, если ваш программист пишет свою интеграцию или ИИ-приложение позволяет задать ключ вместо входа через браузер. Ключ открывает доступ к тем же инструментам MCP по адресу сервера; ко всему остальному в CRM он доступа не даёт. Ключ не истекает и работает, пока вы его не отключите.

Создание API-ключа
Рис. 5. Название ключа, режим «Только просмотр» и кнопка «Создать ключ»

Как выпустить ключ для отчётов владельца

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

Готово: ключ появится в «Подключения и журнал» с типом «API-ключ». Передайте его программисту только через защищённый канал; в приложении он указывается как Authorization: Bearer <ключ>. Чтобы сменить ключ, выпустите новый, обновите настройки программы и отключите старый.

Кнопка «Создать ключ» неактивна, пока администратор сервера не настроил публичный адрес MCP (на странице написано «Внешнее подключение ещё не настроено»). На демо-стенде, где снималась справка, адрес не настроен, поэтому созданного ключа на снимках нет.

У каждого подключения есть лимиты: по умолчанию 120 запросов на чтение и 30 на изменения в минуту. При превышении приложение получит ответ «попробуйте позже».

Подробная техническая справка для программиста — примеры запросов, список инструментов, ошибки — открывается по ссылке «Документация API и примеры запросов» на странице API.

Umnico: WhatsApp, Instagram и другие каналы

Umnico — внешний сервис, который собирает мессенджеры (WhatsApp, WhatsApp Business, Instagram, Facebook Messenger, Telegram, VK) в одном месте. Интеграция переносит переписку из выбранных каналов Umnico в чаты CRM.

Umnico
Рис. 6. Карточка Umnico и кнопка «Подключить Umnico»

  1. Сначала добавьте нужные мессенджеры в самом Umnico.
  2. В CRM откройте «Интеграции» → «Umnico» и нажмите «Подключить Umnico».
  3. Введите API-токен своего аккаунта Umnico и проверьте подключение.
  4. Выберите каналы, сообщения которых должны приходить в этот проект, и подтвердите.

Готово: новые входящие из выбранных каналов создают контакты и диалоги в «Клиентах», менеджеры отвечают из CRM. Историю старой переписки интеграция не переносит. Один канал Umnico можно закрепить только за одним проектом. Если на странице написано «Подключение Umnico пока недоступно», интеграцию ещё не включил администратор сервиса.

На телефоне

Интеграции на телефоне
Рис. 7. Каталог интеграций на телефоне

API на телефоне
Рис. 8. Страница API на телефоне

На телефоне карточки идут одной колонкой. Посмотреть и отключить подключения можно и с телефона; журнал вызовов показан карточками.

Частые вопросы

ИИ увидит диалоги, которые мне не видны? Нет. Подключение видит ровно то, что видите вы в CRM, и только в этом проекте.

ИИ сам начнёт отвечать клиентам? Нет. Подключение ничего не делает в фоне: ИИ выполняет действие, только когда вы его попросите в своём приложении. Отправка ответа клиенту — реальное сообщение, поэтому называйте получателя и текст точно.

ChatGPT пишет «Authentication succeeded, action discovery failed». Новое с 21.10.2026. Это была ошибка Napulse, она исправлена. Удалите коннектор в ChatGPT, отключите старое подключение в «Подключения и журнал» и подключите ChatGPT заново (см. «Подключение ChatGPT»).

ИИ ответил «Нет права «…»». У вас нет этого права в проекте, а ИИ действует только в пределах ваших прав. Попросите руководителя выдать право, названное в кавычках (см. Управление).

Подключение перестало работать через месяц. Вход через браузер действует до 30 дней — подключите приложение заново. API-ключ не истекает.

ChatGPT просит подключиться заново через несколько часов или дней. Новое с 22.10.2026. Раньше так бывало, когда ChatGPT повторял обновление входа (например, ответ потерялся по сети): Napulse принимал повтор за кражу и отключал подключение. Теперь повтор в течение минуты считается нормальным, а вход обновляется реже — раз в час. Если подключение уже отключилось, подключите ChatGPT заново. Кнопка «Отключить» по-прежнему останавливает подключение сразу.

ИИ не видит выбранный проект или видит не тот. Новое с 22.10.2026. Подключение работает только с проектом, выбранным на экране согласия. Чтобы подключить другой проект, подключите приложение ещё раз и выберите его в «Проект подключения».

На экране согласия «ИИ получит инструментов: 0» и кнопка не нажимается. Новое с 22.10.2026. С выбранными разрешениями у вас нет доступных действий в этом проекте. Выберите другой режим или другие разделы; если нужных прав нет, попросите руководителя (см. Управление).

Меня удалили из проекта — ключ продолжит работать? Нет. Удаление из проекта или отзыв подключения закрывает доступ для следующих запросов.

Где ввести ключ ИИ-модели для автодиалогов? Не здесь. Модели для встроенных ИИ-функций назначает администратор платформы; раздел «Интеграции» — для подключения вашего внешнего ИИ к CRM.

Связанные разделы

Предыдущая
Сводные таблицы
Следующая
Umnico: каналы мессенджеров