AskAIsОбзор интеграции
Как подключить AskAIs сегодня: сайт, приложение, Telegram и ИИ-клиенты.
Технические имена, такие как
window.SingChat, относятся к виджету и API. Используйте их в коде ровно в таком виде.
AskAIs — облачный сервис: ваша рабочая область, входящие, ИИ-агент и база знаний находятся на askais.com. Клиентов к нему можно подключить способами, описанными ниже, и все диалоги попадают в одни и те же общие входящие, где на них отвечает один и тот же ИИ-агент с теми же знаниями и настройками.
Способы подключения
| Где | Как подключить | Обновления |
|---|---|---|
| Ваш сайт | Один тег <script> | Не нужны: при каждой загрузке страницы подгружается актуальный виджет |
| Ваше приложение на iOS, Android, Flutter, React Native или для компьютера | WebView, который открывает вашу страницу чата | Не нужны: WebView загружает актуальный виджет |
| Telegram | Токен бота в разделе Настройки → Channels | Не нужны |
| Claude Code, Cursor или Gemini CLI (для вашей команды) | MCP-сервер с MCP-ключом | Не нужны |
Ваш сайт
Добавьте этот код перед </body>. App ID можно скопировать в разделе Настройки → Входящие; он публичный, и его можно спокойно публиковать.
<script src="https://askais.com/widget.js"
data-app-id="YOUR_APP_ID"
data-base-url="https://askais.com"
async></script>⚠️ Загружайте widget.js с askais.com
Не скачивайте widget.js и не встраивайте его в свой код. При загрузке с askais.com всегда работает актуальная версия, а копия застывает и не получает ни исправлений, ни новых функций.
Мобильные и десктопные приложения
Устанавливать SDK не нужно. Откройте https://askais.com/api/widget-embed?appId=YOUR_APP_ID в WebView, и ваше приложение покажет тот же чат, что и сайт, на весь экран. Добавьте в URL ID, email и имя авторизованного пользователя, чтобы команда знала, с кем говорит. Полное руководство с кодом для Flutter, iOS, Android и JavaScript — на странице «Чат в приложении».
Авторизованные посетители и подтверждённая личность
Для авторизованных пользователей передавайте externalId, email и name, чтобы их чаты были доступны им на всех устройствах. Чтобы никто не мог выдать себя за другого пользователя, передавайте также hmac: HMAC-SHA256 от externalId, вычисленный на вашем сервере с секретным ключом входящих в качестве ключа. Как это сделать, показано на странице «Веб-виджет».
Telegram
Создайте бота через @BotFather, вставьте его токен в разделе Настройки → Channels и подключите. Сообщения боту попадают в те же входящие, где на них отвечают ИИ-агент и ваша команда.
ИИ-клиенты (MCP)
MCP-сервер позволяет Claude Code, Cursor или Gemini CLI работать с вашей рабочей областью: читать диалоги и отвечать на них, обучать ИИ, редактировать FAQ и смотреть аналитику. Он предназначен для вас и вашей команды, а не для клиентов. MCP-ключ создаёт владелец или администратор рабочей области.
Пока недоступно
- Устанавливаемые SDK-пакеты (npm, pub.dev, CocoaPods, Gradle). На сайте используйте тег script, а в приложениях — страницу для WebView.
- Публичный REST API для вашего бэкенда. API-ключи принимает только MCP-сервер.
- Webhooks для событий диалогов и сообщений. В разделе Настройки → Webhooks можно сохранить эндпоинт и отправить подписанный тестовый пинг, но события пока не доставляются.
- JavaScript-методы, чтобы открыть или закрыть виджет либо слушать его события.
window.SingChat.start()— единственный метод, который предоставляет скрипт.