Как установить мессенджер Notiondesk на свой сайт

Notiondesk Messenger переносит ваш справочный центр Notiondesk непосредственно на ваш веб-сайт или веб-приложение.

Посетители могут использовать Messenger для поиска информации в вашем справочном центре, чтения статей, общения с вашим ИИ-помощником, просмотра обновлений списка изменений и связи с вашей командой, не покидая ваш веб-сайт.

В этом руководстве объясняется, как установить мессенджер Notiondesk на стандартный веб-сайт.

Прежде чем начать

Перед установкой мессенджера Notiondesk убедитесь, что у вас установлено:

• Центр поддержки Notiondesk

• Мессенджер, настроенный в Notiondesk

• Доступ к коду вашего сайта или к настройкам пользовательского кода, применяемым ко всему сайту.

• Ваш уникальный установочный фрагмент мессенджера Notiondesk

Если вы хотите, чтобы посетители использовали ИИ-помощника в Messenger, настройте также чат-бота с ИИ Notiondesk. См. раздел «Настройка и включение чат-бота с ИИ» .

Выберите способ установки

Используйте способ установки, соответствующий вашему веб-сайту.

Для большинства традиционных веб-сайтов использование фрагмента кода JavaScript является самым простым способом установки.

Установите Messenger на стандартный веб-сайт.

1. Скопируйте код установки Messenger.

Откройте настройки Messenger в Notiondesk и найдите раздел «Установка» .

Скопируйте сгенерированный для вашего Messenger фрагмент кода установки.

Код имеет следующий формат:

YOUR_MESSENGER_ID определяет Messenger, который должен загружаться на вашем веб-сайте.

Скопируйте фрагмент кода со своей панели управления Notiondesk вместо того, чтобы копировать идентификатор Messenger с другого веб-сайта или аккаунта.

2. Добавьте фрагмент кода на свой веб-сайт.

Вставьте фрагмент кода Messenger непосредственно перед закрывающим тегом </body>:

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

Если Messenger должен отображаться только на определенных страницах, включайте фрагмент кода только на этих страницах.

3. Опубликуйте внесенные изменения.

После добавления фрагмента кода сохраните и разверните или опубликуйте свой веб-сайт.

Код Messenger должен присутствовать на опубликованном веб-сайте. Добавление кода только в локальную или неопубликованную версию не сделает Messenger доступным для посетителей.

<script
  async
  src="https://static.notiondesk.help/messenger/widget.js"
  data-messenger-id="YOUR_MESSENGER_ID">
</script>

<body>
  <!-- Your website -->

  <script
    async
    src="https://static.notiondesk.help/messenger/widget.js"
    data-messenger-id="YOUR_MESSENGER_ID">
  </script>
</body>

Проверьте установку.

Откройте опубликованный сайт в своем браузере.

Успешная установка должна загрузить лаунчер Notiondesk Messenger на страницах, содержащих код установки.

Откройте Messenger и убедитесь, что отображается ожидаемое содержимое Notiondesk.

Вы можете протестировать:

• Открытие и закрытие мессенджера

• Поиск в вашем справочном центре

• Открытие статьи

• Начало диалога с ИИ, если чат-бот с ИИ включен.

• Откройте любые другие включенные вами разделы Messenger.

Если Messenger не отображается, откройте инструменты разработчика в браузере и проверьте, успешно ли загружается виджет.

React, Next.js, Vue, Nuxt и SPA

React, Next.js, Vue, Nuxt и другие одностраничные приложения должны использовать официальный пакет @notiondesk-so/messenger-js-sdk вместо ручного добавления стандартного фрагмента скрипта.

Установите пакет с помощью:

Вы также можете установить его с помощью Yarn или pnpm.

SDK предоставляет специализированные интеграции для:

npm install @notiondesk-so/messenger-js-sdk

• JavaScript и TypeScript

• Реакции

• Next.js

• Вью

• Нукст

SDK также предоставляет методы для отображения, скрытия, переключения, настройки и удаления Messenger.

Интеграция с фреймворком требует инициализации Notiondesk Messenger на стороне клиента. Не следует инициализировать SDK Messenger во время рендеринга на стороне сервера.

Не устанавливайте одновременно стандартный фрагмент кода Messenger и SDK в одном и том же приложении, если вы намеренно не управляете отдельными экземплярами Messenger.

Для полной настройки фреймворка см. руководство по установке Notiondesk Messenger с React и Next.js.

Поиск неисправностей