Подключите свою систему

Обзор

Каналы и интеграции → Собственная система (/ru/integrations/own-system) предназначен для магазинов, которые хранят учетные записи клиентов в своей системе (например, в логистическом портале) и не хотят копировать эти данные в OrderInChat.

• Вы встраиваете виджет OrderInChat на свои страницы для авторизованных пользователей.
• Ваш сервер подписывает краткосрочный токен для авторизованного пользователя и передает его виджету.
• Когда этот клиент спрашивает о своей учетной записи (например, "Где моя посылка?"), ИИ вызывает ваши собственные инструменты MCP только для чтения с токеном этого пользователя, как в текстовом чате, так и в голосовых вызовах, инициированных из виджета.
• OrderInChat только проверяет вашу подпись. Он никогда не создает идентификаторы, никогда не читает вашу базу данных и не сохраняет то, что возвращают ваши инструменты.

Доступно на платных планах (Starter, Pro, Ultra). Посетители без действительного токена анонимны: ИИ отвечает на основе вашей базы знаний и просит их войти в систему для вопросов о учетной записи.

Поручите это ИИ вашего разработчика

В блоке Передайте это ИИ вашего разработчика нажмите Скопировать инструкцию и вставьте текст без изменений в ИИ-ассистента ваших разработчиков (Claude Code, Cursor, ChatGPT…). Текст на английском и точно описывает, что нужно сделать — эндпоинт токена, подписанный MCP-сервер и код виджета — с уже подставленными ID магазина и адресами. В конце ИИ должен выдать список значений для этой страницы. Секретов в тексте никогда нет: создайте ключи подписи на этой странице и сами задайте их на своём сервере.

1. Токен входа пользователя

Ваш сервер подписывает JWT для авторизованного пользователя:

Выберите, как OrderInChat будет его проверять:

• JWKS URL (ES256 или RS256) — HTTPS-адрес ваших открытых ключей.
• Открытый ключ (ES256 или RS256) — вставьте PEM открытый ключ.
• Общий секрет (HS256) — не менее 32 символов, хранится в зашифрованном виде.

Вставьте пример токена в разделе Проверка токена, чтобы проверить его перед запуском. Неверный или просроченный токен никогда не приводит к сбою чата — посетитель просто рассматривается как анонимный.

2. Ваш сервер MCP

Введите адрес вашего сервера MCP (Streamable HTTP, tools/list и tools/call). Тест и Живой режимы имеют свои собственные адреса и секреты подписи; Активный режим выбирает, какой из них использует ИИ.

Нажмите Создать, чтобы получить секрет подписи. Он отображается один раз — сохраните его на своем сервере. Отозвать удаляет его сразу (вызовы в этом режиме прекращаются, пока вы не создадите новый).

Каждый запрос, который OrderInChat отправляет на ваш сервер, содержит:

• X-OIC-Timestamp — Unix-секунды
• X-OIC-Signature — v1= + hex HMAC-SHA256 от timestamp.body с вашим секретом подписи
• X-OIC-User-Token — токен пользователя, без изменений (проверьте его самостоятельно и верните только данные этого пользователя)
• X-OIC-Mode — test или live

Отклоняйте запросы, подпись которых не совпадает или временная метка которых старше 5 минут. OrderInChat не имеет фиксированного IP-адреса, поэтому используйте подпись вместо списка разрешенных IP.

3. Инструменты

Нажмите Обнаружить инструменты, чтобы прочитать инструменты, которые перечисляет ваш сервер, затем включите те, которые может использовать ИИ. Разрешайте только инструменты только для чтения. Инструменты, которые появятся позже, будут выключены, пока вы их не включите.

• Текстовый чат: вызов инструмента может занять до 8 секунд.
• Голосовые вызовы: до 3 секунд; помощник сначала говорит короткое "позвольте мне проверить". Если ваш сервер медленный, он говорит, что не может проверить это прямо сейчас.
• То, что возвращают ваши инструменты, рассматривается только как данные, никогда не как инструкции, и не сохраняется в истории чата.

4. Встраивание виджета

<script>
  window.OrderInChatSettings = {
    userToken: "",
    getUserToken: async () => (await fetch("/your/oic-token")).text(),
  };
</script>
<script src="https://app.orderinchat.com/widget/oic-widget.js" data-tenant-id="YOUR-STORE-ID"></script>

getUserToken вызывается, когда токен собирается истечь. После загрузки скрипта вы также можете использовать OrderInChat.setUserToken(token), OrderInChat.clearUserToken() (при выходе) и OrderInChat.onTokenRefresh(fn).

С действительным токеном и включенным голосовым помощником заголовок виджета показывает кнопку телефон. Вызов проходит в виджете и оплачивается из кредитов ИИ, как любой веб-вызов (вызовы инструментов включены в вызов). Аудио веб-вызовов не записывается.

Настроить открывает настройки виджета в новой вкладке. При каждой загрузке страницы код получает внешний вид виджета из OrderInChat (по data-tenant-id), поэтому сохранённые там изменения применяются сразу, без повторной вставки кода. Используется профиль виджета, выбранный для витрины (иначе активный или первый); новый профиль не создаётся.

5. Проверка подключения

Под разделом Инструменты кнопка Проверить подключение выполняет фиксированные проверки вашего тестового MCP-адреса с тестовым секретом подписи. ИИ не используется, ничего не сохраняется. Проверяется, что:

• адрес — публичный https (не localhost и не адрес частной сети);
• правильно подписанный tools/list работает;
• запрос с неверной подписью отклоняется;
• верная подпись с меткой времени старше 5 минут отклоняется;
• tools/call к включённому инструменту без токена пользователя возвращает ошибку и никаких данных;
• с примером токена, вставленным в Проверка токена, tools/call работает — и насколько быстро (больше 2 секунд — слишком медленно для голосовых звонков; они прекращают ожидание через 3 секунды).

Вызываются только найденные и включённые вами инструменты, с пустыми аргументами; пример токена используется только для этой проверки и никогда не сохраняется. Для каждого проваленного пункта указано, как его исправить. Скопировать результаты для разработчика копирует отчёт на английском для вашего разработчика или его ИИ; повторяйте проверку, пока не останется ошибок.

Что видит ваша команда

• Входящие → Веб: имя и электронная почта клиента из токена, или Пользователь #ID, когда вы не отправляете ни одно из них. Каждый ответ ИИ показывает, какие из ваших инструментов он использовал и сработали ли они — никогда не данные.
• Входящие → Вызовы: вызовы виджета появляются под Веб-сайтом магазина и в Живом режиме, пока они идут; транскрипция показывает каждый шаг инструмента (только имя и результат).
• Клиенты: карточка клиента создается или повторно используется для каждого идентификатора пользователя (Идентификатор пользователя магазина), так что чаты и вызовы одного и того же человека связаны.