База знаний GetMyBot

Публичный центр помощи

Как сделать сайт помощи для клиентов из ваших статей. Публикация, поиск, языки и подключение собственного домена.

На этой странице

В центре помощи клиенты самостоятельно находят ответы: как оформить заказ, вернуть оплату или настроить продукт. Вы публикуете статьи в базе знаний, а GetMyBot показывает их на отдельном сайте с поиском и навигацией.

Откройте База знаний → Центр помощи и настройте сайт. У статей можно собирать оценки полезности, а для поисковых систем создаётся карта сайта. Внутренние статьи и черновики посетителям не показываются.

У каждого центра помощи есть постоянный адрес вида https://getmybot.dev/help/{ключ}. Вместо {ключ} будет уникальное значение вашего бота, которое покажет GetMyBot. Позже можно добавить собственный домен вроде help.example.com; постоянный адрес продолжит работать.

Что попадает на сайт

Всё решает состояние статьи:

  • Опубликовано: видна на сайте и в его поиске.
  • Внутренняя: доступна только AI-агенту. Она не появляется ни на сайте, ни в поиске, ни в карте сайта, ни в метаданных страниц.
  • Черновик: не публикуется нигде и не участвует даже во внутреннем поиске.

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

Если посетитель откроет ссылку на внутреннюю статью, сайт покажет тот же ответ, что и для несуществующей статьи. Так нельзя узнать названия скрытых материалов.

Оформление и языки

  • Название центра помощи и логотип (изображение до 2 МБ).
  • Акцентный цвет: код цвета вида #2f6df6. Он используется для ссылок и основных кнопок. Собственный CSS, код для оформления сайта, добавить нельзя.
  • Доступные языки и язык по умолчанию. Посетитель может переключать язык; запрос языка, которого нет, отдаёт язык по умолчанию.
  • Ссылка на чат поддержки: адрес за кнопкой «Написать в поддержку». Принимаются только адреса https://.
  • Включить публичный центр помощи: общий выключатель. Пока он выключен, публичные маршруты не отдают ничего.

Поиск и отзывы

Поиск охватывает опубликованные статьи на выбранном языке. Он ищет и в тексте статьи, поэтому вопрос не обязан совпадать с заголовком.

Под каждой статьёй посетитель может ответить на вопрос «Эта статья была полезной?». Один посетитель голосует за статью один раз. Голоса учитываются в аналитике базы знаний, посетителям итоги не показываются. Для защиты от повторных и посторонних голосов сайт использует подписанный файл cookie с флагом HttpOnly, принимает голос только со своих страниц и ограничивает частоту отправки.

Поисковые системы

Переключатель Разрешить поисковым системам индексировать центр помощи управляет robots.txt и картой сайта:

  • Включён: robots.txt разрешает обход и указывает на /help/{ключ}/sitemap.xml, где перечислены главная страница каждого включённого языка и все опубликованные статьи с датой последнего изменения.
  • Выключен: robots.txt запрещает всё, а карта сайта пуста.

Изменение настройки действует при следующем запросе поисковой системы. Внутренние статьи и черновики не попадают ни в карту сайта, ни в сведения о страницах для поисковых систем.

Собственный домен

Для подключения домена нужны две DNS-записи. Это настройки домена у регистратора или провайдера DNS; если ими занимается администратор сайта, передайте ему значения из кабинета.

  1. Введите адрес (например help.example.com) в блоке Собственный домен. Международное имя преобразуется в ASCII-форму. IP-адреса, localhost, имена с *. и только публичный суффикс без вашего имени домена (например, co.uk) не принимаются. Домен example.co.uk допустим.
  2. Интерфейс показывает две записи, которые должны существовать одновременно:
    • TXT на этом имени со значением mybot-help=<токен>;
    • CNAME с этого имени на хост приложения.
  3. Нажмите Проверить DNS. Значение TXT должно совпасть в точности, а домен должен вести на сервер приложения.

Значение TXT показывается один раз, сразу после добавления домена, и хранится только в этом браузере. Если оно потеряно, удалите домен и добавьте заново, чтобы получить новое.

Статусы домена: Ожидает проверки, Проверен, Активен, Проверка не прошла, Отключён. У неудачной проверки сохраняется причина:

  • Значение TXT не совпадает с выданным: опубликован другой или устаревший токен.
  • TXT-запись не найдена в DNS: записи нет или изменение ещё не дошло до серверов DNS. Это может занять до 24 часов.
  • Домен не указывает на нужный адрес: CNAME (или A-записи) ведут в другое место.

HTTPS, маршрутизация и отключение

Для активного проверенного домена GetMyBot получает сертификат HTTPS, чтобы посетители могли безопасно открыть сайт. Для непроверенного или отключённого домена сертификат не выпускается. Перед выпуском веб-сервер проверяет через API, что домен по-прежнему активен у включённого центра помощи.

Пока домен активен, посетитель попадает в центр помощи нужного бота. Адрес статьи и выбранный язык сохраняются. Сопоставление домена с ботом хранится в кэше не дольше 30 секунд, поэтому отключение действует почти сразу.

Отключить выключает и публичный маршрут, и выпуск сертификата, сохраняя саму запись. Отключённый домен нельзя проверить повторно: удалите его и добавьте заново, чтобы получить новое значение TXT. Удалить стирает запись полностью.

Связанные материалы