Как использовать setAttributes() с хешем в JavaScript

Инструкции ниже предназначены только для ПК и ноутбуков.
Функция setAttributes() в нашем API позволяет изменять данные клиентов (например, имя и адрес электронной почты) через чат-виджет tawk.to.
Использование хеша вместе с функцией setAttributes() - это надёжный способ защитить данные клиентов. Хеш представляет собой зашифрованную комбинацию секретного ключа и ID пользователя, которая предотвращает несанкционированный доступ к информации.
В этом руководстве мы покажем, как:
  • получить секретный ключ,
  • сгенерировать хеш,
  • использовать его с функцией setAttributes() в API tawk.to.

    Шаг 1. Получение секретного ключа

    Выполните следующие действия:

    1. Войдите в свой аккаунт tawk.to.
    2. Выберите нужный Проект (Property).
      3. В левом меню навигации нажмите Администрирование.
      4. В левом подменю выберите Обзор.
      5. Прокрутите страницу до раздела JavaScript API.

       6. Включите Безопасный режим.

      7. Нажмите на значок копирования, чтобы сохранить Ключ.

       Этот ключ понадобится на следующем этапе для генерации хеша.

      Шаг 2. Генерация хеша

      Хеш создаётся с помощью сервиса, который принимает комбинацию секретного ключа и ID пользователя, а затем шифрует их в строку символов, недоступную для чтения третьим лицам.
      Вы можете использовать любую библиотеку или сервис шифрования.
      В этом примере используется Crypto.js. Полезные ссылки:

        Шаги по генерации хеша:

        1. Скопируйте предоставленный код и вставьте его в раздел <head> HTML-страницы вашего сайта.

             2. Скопируйте JavaScript-функцию, отвечающую за генерацию значения хеша, в ваш JavaScript-файл.

             3. Замените secretKey на ключ, скопированный из панели управления tawk.to.

          Шаг 3. Использование setAttributes() с хешем

          Теперь используем сгенерированный хеш вместе с функцией setAttributes().

          1. Скопируйте функцию setAttributes() из документации JavaScript API в вашу API-схему.
          Примечание: если вы используете свойство phone в setAttributes(), номер телефона должен быть указан в международном формате E.164 (например, +1234567890).
          2. Вставьте сгенерированный хеш в поле hash.
          3. Убедитесь, что значение в поле userID совпадает с ID пользователя, использованным при генерации хеша.
          Примечание: обновление данных клиента может занять несколько секунд.

          Коды ошибок

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

          Они отображаются в консоли разработчика браузера.
          Следуя этим шагам, вы дополнительно усиливаете безопасность чат-виджета tawk.to, обеспечивая клиентам более защищённый и надёжный опыт.

          Если у вас возникнут сложности или появятся вопросы - пожалуйста, свяжитесь с нами.

          Есть отзывы по этой статье или нужна помощь?

          Эта статья была вам полезна?

          4 из 7 понравилась эта статья