Иди на текст

Интеграција виџета

Интегришите ЦхатХуб виџет у своју веб локацију да бисте својим клијентима пружили подршку за ћаскање у реалном времену.

Преглед

ЦхатХуб виџет је ЈаваСцрипт компонента која:

  • Уграђује се у било коју веб локацију
  • Пружа интерфејс за ћаскање у реалном времену
  • Повезује купце са оператерима
  • Захтева токен за аутентификацију оператера
  • Учитава се као ЕС модул

Брзи почетак

1. Набавите токен оператера

Прво набавите токен оператера који прати ток аутентификације:

ЦОДЕ_БЛОЦК_0

2. Угради виџет

Додајте скрипту виџета у свој ХТМЛ:

ЦОДЕ_БЛОЦК_1

Параметри скрипте

| Атрибут | Вредност | Обавезно | Опис | |-----------|-------|-----------------| | тип | модул | Да | Тип ЕС модула | | ид | оператор-цхат-панел-сцрипт | Да | Јединствени идентификатор скрипте | | срц | УРЛ виџета | Да | Локација скрипте виџета | | токен | ЈВТ токен | Да | Токен за аутентификацију оператера |

Методе интеграције

Статички ХТМЛ

За статичне веб локације, уградите директно у ХТМЛ:

ЦОДЕ_БЛОЦК_2

Динамичко убризгавање (ЈаваСцрипт)

За апликације на једној страници, убризгајте динамички:

ЦОДЕ_БЛОЦК_3

Реагуј

ЦОДЕ_БЛОЦК_4

Вуе.јс

ЦОДЕ_БЛОЦК_5

Ангулар

ЦОДЕ_БЛОЦК_6

Токен Манагемент

Генерисање токена на страни сервера

Никада не откривајте акредитиве компаније у коду на страни клијента. Генеришите токене на свом серверу:

ЦОДЕ_БЛОЦК_7

Токен Рефресх

Примените аутоматско освежавање токена:

ЦОДЕ_БЛОЦК_8

Више организација

Учитајте различите виџете за различите организације:

ЦОДЕ_БЛОЦК_9

Најбоље праксе

Сецурити

  • ✅ Генеришите токене на страни сервера
  • ✅ Никада не откривајте акредитиве компаније у коду клијента
  • ✅ Користите ХТТПС за све АПИ захтеве
  • ✅ Имплементација истека токена
  • ✅ Потврдите токене пре употребе
  • ❌ Не чувајте токене у лоцалСтораге без шифровања
  • ❌ Не упућујте токене на контролу верзија

Перформанс

  • ✅ Асинхроно учитајте виџет
  • ✅ Користите ЕС модуле (модерне претраживаче)
  • ✅ Имплементирајте кеширање токена
  • ✅ Грациозно рукујте грешкама
  • ❌ Не блокирајте учитавање странице

Корисничко искуство

  • ✅ Прикажи стање учитавања док се виџет иницијализује
  • ✅ Руковати мрежним грешкама
  • ✅ Обезбедите резервни метод контакта
  • ✅ Тестирајте на различитим претраживачима и уређајима

Обрада грешака

ЦОДЕ_БЛОЦК_10

Решавање проблема

Виџет се не учитава

  1. Проверите да ли је токен оператора важећи
  2. Уверите се да токен није истекао
  3. Уверите се да је УРЛ скрипте тачан
  4. Проверите да ли има грешака на конзоли претраживача
  5. Проверите мрежну повезаност

Токен је истекао

ЦОДЕ_БЛОЦК_11

Више инстанци виџета

Уверите се да се истовремено учитава само један виџет:

ЦОДЕ_БЛОЦК_12

Проблеми са различитим пореклом

Уверите се да је ваш домен на белој листи. Обратите се подршци ако наиђете на ЦОРС грешке.

Тестирање

Локални развој

ЦОДЕ_БЛОЦК_13

Интеграционо тестирање

ЦОДЕ_БЛОЦК_14

Следећи кораци