Подключите свой сайт
Читайте страницы, товары и заказы прямо из вашей платформы
Обзор
Подключение сайта даёт ИИ ключ к вашей платформе только для чтения. Вместо того чтобы обходить страницы снаружи, мы запрашиваем их прямо у платформы.
Так мы получаем контент, до которого не добраться обходом. Проходят страницы за входом, глубокие страницы, на которые ничего не ссылается, и сайты за защитой от ботов. Цены и остатки остаются актуальными, потому что мы читаем их заново, а не полагаемся на то, что страница сообщала в день обхода.
Три вида данных
Вы выбираете, чем поделиться. Каждый выбор соответствует тому, на что ассистент затем сможет ответить.
| Выбор | Что это даёт | На что ассистент может ответить |
|---|---|---|
| Страницы | Содержимое вашего сайта, синхронизируется автоматически. | Вопросы о ваших правилах, услугах, курсах, руководствах и любой другой текстовой странице. |
| Товары | Актуальные цены, остатки, ссылки и изображения. | Что вы продаёте, сколько это стоит, есть ли в наличии, и ссылку для покупки. |
| Заказы | Проверка статуса заказа для ваших клиентов. | Где заказ клиента, когда его отправили и что в нём было. |
Какие платформы подходят
Все. На чём бы ни был построен ваш сайт, ассистент может отвечать по вашим страницам, товарам и заказам.
Некоторые платформы можно читать напрямую по ключу API. У остальных те же данные поступают через обход, товарный фид, контекст пользователя или ваши собственные инструменты. Разбираться самим не нужно: откройте окно, выберите платформу, отметьте, чем хотите поделиться, и появятся шаги для вашего случая.
Посмотреть шаги для вашей платформы
Как подключить
- Откройте панель и найдите Подключите свой сайт рядом с «Добавить в базу знаний».
- Выберите платформу из списка. Выберите Свой / без CMS, если собрали сайт сами.
- Отметьте, чем хотите поделиться: страницы, товары, заказы или любое сочетание.
- Нажмите Продолжить. Теперь вы увидите шаги настройки, написанные для вашей платформы и вашего выбора.
- Выполните шаги в панели управления вашей платформы, чтобы создать ключ.
- Вставьте ключ в поля внизу того же окна и нажмите «Подключить».
Что происходит при нажатии «Подключить»
Мы проверяем данные до того, как их сохранить. Неверный ключ не сохраняется никогда.
- Мы делаем один настоящий запрос к вашей платформе с вставленными данными.
- Если он не удался, ошибка появится под кнопкой, а поля останутся доступными для правки.
- Если удался, мы сохраняем подключение и начинаем читать ваш контент.
- Затем окно сообщает результат: сколько элементов поступило или что именно пошло не так.
Как поддерживается актуальность
Мы перечитываем ваш контент по расписанию, поэтому изменение цены или новая страница доходят до ассистента без вашего участия.
Переиндексируется только то, что изменилось. Мы сравниваем содержимое каждого элемента с тем, что уже есть, поэтому неизменённая страница ничего не стоит. Также в любой момент можно нажать «Синхронизировать» на странице настроек самой платформы.
Права и доступ
Сколько видит ключ, зависит от платформы, и эта разница важна.
Magento, Shopify, WooCommerce и BigCommerce выдают права по каждому ресурсу. Если отметить только товары, ключ действительно дотянется только до товаров.
WordPress и Moodle устроены иначе. Пароль приложения в WordPress наследует права создавшей его учётной записи, а токен Moodle видит то, что видит его пользователь. Списка для отметок нет. Используйте учётную запись, у которой доступа не больше, чем к контенту, на который вы хотите отвечать, и учтите, что приватные и защищённые паролем записи тоже попадут.
С нашей стороны мы читаем только маршруты с контентом и только методом GET. Мы никогда не пишем.
Подключение без ключа API
У каждого выбора есть и путь, которому ключ не нужен вовсе. Эти способы работают на любой платформе, и окно предлагает их рядом с шагами.
| Вместо | Использовать | Что он делает |
|---|---|---|
| Страницы | Сканирование | Мы читаем весь ваш сайт и храним содержимое в базе знаний. |
| Товары | Поток данных в реальном времени | Укажите нам публичный адрес товарного фида. Оттуда цены и остатки остаются в актуальном состоянии. |
| Заказы | Контекст пользователя или Пользовательские инструменты | Передавайте данные вошедшего клиента со своего сайта или подключите свою конечную точку, которую ассистент сможет вызвать. |
Отключение
Откройте из окна страницу настроек платформы и нажмите «Отключить». Это удаляет сохранённые данные и всё, что этот ключ принёс в вашу базу знаний. Содержимое из других источников не затрагивается.
Ключ также можно отозвать на самой платформе. Тогда следующая синхронизация завершится ошибкой аутентификации, и ничего нового прочитано не будет.
Устранение неполадок
| Что вы видите | Что это обычно значит |
|---|---|
| Ошибка аутентификации | Ключ неверный, просрочен или отозван. В WordPress так бывает и тогда, когда вместо пароля приложения вставлен обычный пароль от входа. |
| Готово, но читать оказалось нечего | Данные работают, но учётная запись за ними не видит никакого контента. Выберите учётную запись с доступом к страницам или товарам, на которые вы хотите отвечать. |
| Подключено, но не удалось прочитать ваш контент | Ключ приняли, а затем чтение не удалось. Точная ошибка от вашей платформы показывается вместе с сообщением. |
| Не хватает права | Ключ создан без одного из ресурсов, перечисленных в шагах. Создайте его заново со всеми правами, которые назвало окно. |