Добавьте ассистента на свой сайт

Что нужно перед началом

• Ваш публичный ключ — короткая строка, начинающаяся с az_pk_. Найдёте её на вкладке «Код для вставки» в панели ассистента.
• Домен вашего сайта — адрес, на котором будет работать ассистент (например, example.com).
• Доступ к HTML вашего сайта — редактор темы, поле для собственного кода или плагин.

Установка

1. 1

   Подтвердите домен

   На вкладке «Домены» панели ассистента добавьте домен, на котором будет работать ассистент. Выберите один из двух способов подтверждения: TXT-запись DNS для вашего домена (имя записи имеет вид `_azamol.<ваш-домен>`) или файл подтверждения, загружаемый на сервер (`https://<ваш-домен>/.well-known/azamol-dogrulama.txt`). В обоих случаях нужное значение формирует панель — просто скопируйте его кнопкой копирования.

   Пока домен не подтверждён, ассистент нигде не появится — именно это защищает ваш ключ от использования на чужих сайтах. Если вы используете несколько адресов (например, example.com и www.example.com), добавьте и подтвердите каждый отдельно.

2. 2

   Опубликуйте версию персоны

   На вкладке «Персона» настройте, как будет говорить ваш ассистент, и опубликуйте версию. Без опубликованной версии персоны ассистент не может быть запущен.

3. 3

   Опубликуйте ассистента

   После подтверждения домена и публикации версии персоны нажмите кнопку «Опубликовать» на вкладке «Настройки». Этот шаг переводит ассистента из черновика в рабочий режим — даже если код уже вставлен на сайт, ассистент останется невидимым до публикации.

4. 4

   Вставьте код на свой сайт

   Добавьте строку ниже прямо перед закрывающим тегом </body> вашей страницы. Свой ключ можно скопировать на вкладке «Код для вставки» панели ассистента.

   <script src="https://azamol.ai/embed/v1.js" data-azamol-key="az_pk_XXXX" async></script>

   Копировать

   Код должен быть на каждой странице, поэтому удобнее всего разместить его в подвале (footer) темы. Ниже указано, куда вставлять код в зависимости от платформы.

5. 5

   Обновите страницу и проверьте

   Откройте свой сайт. В правом нижнем углу должна появиться круглая кнопка. При нажатии открывается окно ассистента — он загружается только в этот момент, поэтому посетители, которые его не открывают, не получают лишней нагрузки. При проблемах см. раздел «Решение проблем» ниже.

Что посетитель может отправить ассистенту?

Помимо текста ассистент принимает изображения и голосовые сообщения. Посетителю ничего не нужно устанавливать — всё работает прямо в окне чата.

• Изображения: JPG, PNG, WebP или GIF, до 5 МБ каждое. Посетитель может отправить фотографию товара, снимок экрана или фото документа и задать вопрос по нему.
• Голосовые сообщения: записываются кнопкой микрофона, до 60 секунд. Для тех, кто не хочет печатать или спешит с телефона.
• Одно вложение на сообщение — изображение и звук нельзя отправить вместе.

Сообщение с вложением списывает из вашей квоты всё то же одно сообщение. За фото или запись доплаты нет.

Куда вставлять код в зависимости от платформы

Если ассистент не появляется

Проверьте по порядку следующие пункты. В большинстве случаев причина — одна из первых двух строк.

Если ничего из этого не помогло, откройте консоль браузера (F12) и пришлите нам скриншот строк, начинающихся с [azamol-embed].

Какими ссылками делится ассистент?

Мы обходим ваш сайт при настройке, поэтому ассистент может дать ссылку на страницу, на которой основан ответ — посетителю не придётся спрашивать, где это написано.

• Публикуются только страницы вашего домена, действительно найденные при обходе.
• Если ассистент выдумает или угадает адрес, такая ссылка удаляется на сервере, не доходя до посетителя. Это принудительное правило, а не просьба к модели.
• В одном ответе даётся ссылка не более чем на 2 разные страницы — ответ не превращается в список ссылок.

Ссылки открываются в новой вкладке — посетитель не теряет переписку.

Что добавить в политику конфиденциальности

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

• Укажите, что на сайте работает AI-ассистент и что сообщения обрабатываются.
• Напомните посетителям не вводить ассистенту специальные категории данных — номера документов, сведения о здоровье и подобное.
• Укажите, что содержание переписки не сохраняется — сообщения обрабатываются только для формирования ответа и затем удаляются; Azamol не хранит тексты переписки, и сотрудники не могут их прочитать.
• Сообщите, что сообщения обрабатываются в облачной инфраструктуре за пределами вашей страны, и отразите эту передачу в уведомлении.

Часто задаваемые вопросы