Перевірка особи відвідувачів
Повідомте чату через Chatixy.identify(), хто відвідувач, що увійшов, і підпишіть його email на своєму сервері, щоб ваша команда бачила в розмові підтверджену особу.
Як працює перевірка особи
Коли відвідувач увійшов на ваш сайт, сторінка може повідомити чату, хто він, через Chatixy.identify(). Його email, ім'я та телефон з'являються в розмові у вхідних, і чат більше не питає email.
Без підпису identify() працює як форма перед чатом: дані заповнюють лише порожні поля, а розмова позначається як непідтверджена. Додайте підпис, створений на вашому сервері, user_hash, і Chatixy позначить особу як підтверджену: дані замінять те, що ввів відвідувач, а в картці контакту у вхідних з'явиться позначка Підтверджено. Агенту підтримки повідомляють, що особу підтверджено, лише коли це справді так.
Поради
- Діють правила полів форми перед чатом: телефон зберігається, лише якщо чат його запитує, а ім'я - якщо поле імені в чаті не вимкнено.
Де знайти секрет ідентифікації
Кожен чат має власний Секрет ідентифікації. Його бачать лише адміністратори вашого робочого простору.
Кроки
- 1
Відкрийте налаштування чату
У проєкті натисніть Налаштувати біля сайту, потім відкрийте Розширені налаштування.
- 2
Скопіюйте секрет
У розділі Секрет ідентифікації натисніть Показати, потім Копіювати.
- 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 усе одно передає дані відвідувача у вхідні. Вони позначаються як непідтверджені й заповнюють лише ще порожні поля.