Встраивание на сайт

Одна строка script добавляет окно чата на сайт, а также методы и языковые правила, доступные на странице.

Ниже {API} обозначает адрес сервиса; его можно посмотреть на странице «Подключение» в панели управления.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
  • data-key — это публичный Key; скопируйте его на странице «Подключение» в панели управления.
  • На странице «Подключение» укажите сайты, которым разрешено встраивать виджет (например, https://shop.example.com); другие сайты не смогут воспользоваться вашим публичным Key, даже если получат его. Обязательно заполните это перед запуском.
  • Необязательно: data-theme="dark" — использовать тёмное оформление.
  • Необязательно: data-language="de" — если сам сайт многоязычный, передайте язык текущей страницы, и чат поддержки по умолчанию будет использовать этот язык (посетитель всё равно может переключить). Коды поддерживаемых языков см. в обзоре Open API.
  • Необязательно: data-language="auto" — брать <html lang> страницы как язык по умолчанию; когда затем страница меняет язык (атрибут lang изменён; для одностраничного приложения перезагрузка не требуется), окно чата поддержки автоматически переключается вслед за ней.

На странице можно вызывать:

МетодНазначение
AICS.open() / AICS.close() / AICS.toggle()Открывает и закрывает окно чата поддержки; например, можно повесить на кнопку «Связаться с поддержкой»
AICS.identify(userToken)Позволяет после входа покупателя сообщить чату поддержки, кто он (см. Идентификация авторизованных покупателей)
AICS.setLanguage(code)Вызывайте при переключении языка на сайте; окно чата поддержки и последующие ответы переключатся вместе с ним, например AICS.setLanguage("ja"); также поддерживаются варианты вроде zh-Hans и pt-BR
AICS.reset()Вызывайте при выходе покупателя из аккаунта: окно чата поддержки выгружается, текущая сессия сбрасывается; после повторной загрузки скрипта появится новое анонимное окно, и следующий человек не увидит переписку предыдущего

Язык

  • Окно чата поддержки отображается на языке, соответствующем местоположению посетителя (IP), включая текст интерфейса и приветствие; если задан data-language, приоритет отдаётся языку страницы. Если местоположение определить не удаётся, используется «Язык по умолчанию», заданный в панели управления.
  • AI отвечает на языке покупателя; если по содержанию сообщения язык не определить (эмодзи, номер заказа), используется язык, определённый выше.
  • Покупатель может переключить язык в меню в верхней части окна или просто сказать AI: «Отвечай на английском». После этого AI всегда отвечает на этом языке, даже если покупатель пишет на другом.
  • Переключение языка на сайте (вызов AICS.setLanguage или изменение <html lang> при data-language="auto") также считается выбором покупателя; из всех перечисленных способов действует последний. При этом язык по умолчанию, заданный при открытии страницы, не переопределяет язык, выбранный покупателем.
  • В панели управления в разделе «Настройки бота → Язык» можно отключить определение по IP, изменить язык по умолчанию и ограничить список доступных языков.
  • Если сервис развёрнут за обратным прокси или CDN, на сервере нужно настроить TRUSTED_PROXIES или COUNTRY_HEADER, иначе не удастся получить реальный IP посетителя.

Эта страница была полезной?

Обновлено: