Перевірка особи відвідувачів

Повідомте чату через Chatixy.identify(), хто відвідувач, що увійшов, і підпишіть його email на своєму сервері, щоб ваша команда бачила в розмові підтверджену особу.

Як працює перевірка особи

Коли відвідувач увійшов на ваш сайт, сторінка може повідомити чату, хто він, через Chatixy.identify(). Його email, ім'я та телефон з'являються в розмові у вхідних, і чат більше не питає email.

Без підпису identify() працює як форма перед чатом: дані заповнюють лише порожні поля, а розмова позначається як непідтверджена. Додайте підпис, створений на вашому сервері, user_hash, і Chatixy позначить особу як підтверджену: дані замінять те, що ввів відвідувач, а в картці контакту у вхідних з'явиться позначка Підтверджено. Агенту підтримки повідомляють, що особу підтверджено, лише коли це справді так.

Поради

  • Діють правила полів форми перед чатом: телефон зберігається, лише якщо чат його запитує, а ім'я - якщо поле імені в чаті не вимкнено.

Де знайти секрет ідентифікації

Кожен чат має власний Секрет ідентифікації. Його бачать лише адміністратори вашого робочого простору.

Кроки

  1. 1

    Відкрийте налаштування чату

    У проєкті натисніть Налаштувати біля сайту, потім відкрийте Розширені налаштування.

  2. 2

    Скопіюйте секрет

    У розділі Секрет ідентифікації натисніть Показати, потім Копіювати.

  3. 3

    Зберігайте його на сервері

    Збережіть його там, де його може прочитати лише ваш сервер, наприклад у змінній середовища CHATIXY_IDENTITY_SECRET.

Важливо

  • Ніколи не розміщуйте секрет ідентифікації в коді сторінки, у своєму JavaScript чи в публічному репозиторії. Будь-хто, хто його має, може видати будь-який email за підтверджений.
  • Створити заново створює новий секрет, і підписи, зроблені старим, одразу перестають прийматися. Використовуйте це, якщо секрет міг витекти, і одразу встановіть новий на сервері.

Підпишіть email на своєму сервері

Підпис - це HMAC-SHA256 email відвідувача, обчислений із секретом ідентифікації як ключем і записаний у шістнадцятковому вигляді малими літерами: 64 символи.

Підписуйте саме той email, який передаєте в identify(). Chatixy не змінює регістр літер перед перевіркою, тому Ann@Example.com і ann@example.com дають різні підписи. Створюйте підпис на сервері, коли формуєте сторінку або відповідає ваш власний API, і ніколи в браузері.

Node.js

const crypto = require('crypto');

const userHash = crypto
  .createHmac('sha256', process.env.CHATIXY_IDENTITY_SECRET)
  .update(user.email)
  .digest('hex');

PHP

$userHash = hash_hmac('sha256', $user->email, getenv('CHATIXY_IDENTITY_SECRET'));

Python

import hashlib
import hmac
import os

user_hash = hmac.new(
    os.environ['CHATIXY_IDENTITY_SECRET'].encode(),
    user.email.encode(),
    hashlib.sha256,
).hexdigest()

Ruby

require 'openssl'

user_hash = OpenSSL::HMAC.hexdigest('SHA256', ENV.fetch('CHATIXY_IDENTITY_SECRET'), user.email)

Передайте особу в чат

Викличте Chatixy.identify() з email відвідувача та підписом у user_hash; name і phone необов'язкові. Запишіть на сторінку значення, створені вашим сервером - у прикладі нижче показано заповнювачі.

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

HTML

<script>
  window.chatixyAsyncInit = function (Chatixy) {
    Chatixy.identify({
      email: 'ann@example.com',
      name: 'Ann',
      user_hash: 'SIGNATURE_FROM_YOUR_SERVER',
    });
  };
</script>
<script src="https://chatixy.com/source/YOUR_WIDGET_KEY.js" async></script>

Якщо підпис не збігається

Підпис user_hash, що не збігається, нічого не зберігає з цього виклику: ні email, ні імені, ні телефону, ні позначки Підтверджено. Сам чат працює як завжди, і відвідувач не бачить жодної помилки.

Підтверджена розмова лишається підтвердженою: пізніший виклик identify() без підпису не може цього скасувати.

Чому не з'являється позначка Підтверджено?

Перевірте, що ви підписуєте саме той email, який передаєте, літера в літеру; що використовуєте секрет саме цього чату, адже кожен чат має свій; що підпис записано в шістнадцятковому вигляді; і що ніхто не створив секрет заново після того, як ви його скопіювали.

Чи обов'язково підписувати email?

Ні. identify() без user_hash усе одно передає дані відвідувача у вхідні. Вони позначаються як непідтверджені й заповнюють лише ще порожні поля.