Увімкніть режим автентифікації користувача через JS API

Знайте все про своїх зареєстрованих клієнтів.
Написано Марина
Оновлено 10 місяців тому

Режим автентифікації користувача забезпечує бездоганний клієнтський досвід на різних пристроях. Він відповідає за безперервність між веб-платформами, пристроями iOS і Android та дозволяє підтримувати всі взаємодії з певним клієнтом в одному профілі незалежно від того, з якого пристрою він увійшов. Режим автентифікації користувача допомагає переконатися, що один користувач не може видати себе за іншого, тому ми наполегливо рекомендуємо всім нашим клієнтам увімкнути цей режим.

Загальне використання

Найпоширенішим прикладом використанням режиму автентифікації користувача є його інтеграція з системою реєстрації/входу. Ви можете встановити віджет чату HelpCrunch на своєму лендингу, щоб спілкуватися з відвідувачами, і всередині свого сервісу, щоб надавати підтримку зареєстрованим користувачам. Коли відвідувач зареєструється/увійде у ваш сервіс і отримає ID користувача у вашій базі даних, ви можете ввімкнути режим автентифікації користувача для цього користувача.

Найпростіший спосіб як це зробити

Приклад повного коду віджета разом із режимом авторизації користувача та власними атрибутами:

<script type="text/javascript">
  window.helpcrunchSettings = {
    organization: 'helpcrunch',
    appId: 'a47f724b-bh1f-4504-7fa7-0fbf7dg84kb0',
    user: {
      user_id: 'userOneHash',
      name: 'User One',
      email: '[email protected]',
      phone: '+380123456789',
      company: 'my company',
      custom_data: {
        is_active: true,
        money_spent: 2500,
        subscription: 'gold',
        accepted_agreement: true,
      },
    },
  };

</script>

<script type="text/javascript">
  (function(w,d){var hS=w.helpcrunchSettings;if(!hS||!hS.organization){return;}var widgetSrc='https://'+hS.organization+'.widget.helpcrunch.com/';w.HelpCrunch=function(){w.HelpCrunch.q.push(arguments)};w.HelpCrunch.q=[];function r(){if (d.querySelector('script[src="' + widgetSrc + '"')) { return; }var s=d.createElement('script');s.async=1;s.type='text/javascript';s.src=widgetSrc;(d.body||d.head).appendChild(s);}if(d.readyState === 'complete'||hS.loadImmediately){r();} else if(w.attachEvent){w.attachEvent('onload',r)}else{w.addEventListener('load',r,false)}})(window, document)
</script>

helpcrunchSettings містить наступні параметри:

  • organization: string (обов'язково)
  • appId: sting
  • user: object (дивитись нижче)

user об’єкт містить наступні параметри

  • user_id: string
  • name: string
  • email: string
  • phone: string
  • company: string

1. Атрибут user_id має бути унікальним (тобто недоступним для інших користувачів), оскільки хтось може отримати доступ до розмови, знаючи його.
2. Щоб впевнитись, що ніхто не замінить user _id для перегляду історії чату іншої особи та спілкування під її іменем, хешуйте свої ідентифікатори користувачів за допомогою hash salt та додайте цей хеш у поле user_id замість справжнього ідентифікатора.

custom data параметри об’єкта:

Тут ви можете надіслати будь-яку додаткову інформацію про користувача, наприклад, тип підписки, кількість платежів, дати реєстрації чи замовлення тощо...

1. Створіть власні атрибути в налаштуваннях HelpCrunch.

2. Оновіть власні атрибути під час автентифікації користувача або пізніше.

Цей пункт є необов’язковий. Не надсилайте ці дані, якщо у вас немає власних атрибутів користувача.
Якщо ввімкнено режим автентифікації користувача, форма чату не відображатиметься.
Якщо ви надішлете лише ім’я користувача та/або електронну адресу користувача без зазначення user_id, режим автентифікації користувача не буде ввімкнено, і відобразиться форма чату з попередньо заповненими полями імені та/або електронної пошти.
Чи була наша стаття корисною?