Иди на текст

СМСБАТ ЦхатХуб АПИ

ЦхатХуб РЕСТ АПИ управља Вибер пословним разговорима, разговорима са клијентима и процесима аутоматизације корисничке подршке.

Основни УРЛ

ЦОДЕ_БЛОЦК_0

Сваггер документација

Интерактивна АПИ документација је доступна на:

ЦОДЕ_БЛОЦК_1

Аутентификација

ЦхатХуб користи систем аутентификације заснован на беарер токену са ЈВТ токенима. Токени се могу пренети на два начина:

Метод 1: Заглавље ауторизације

ЦОДЕ_БЛОЦК_2

Метод 2: Заглавље кључа за Кс-ауторизацију

ЦОДЕ_БЛОЦК_3

Ток аутентификације

ЦхатХуб користи систем токена на два нивоа:

  1. Токен компаније – приступни токен на нивоу организације
  2. Токен оператера – Токен за приступ појединачног оператера

Ток рада

ЦОДЕ_БЛОЦК_4

Главне крајње тачке

Метода Крајња тачка Опис
ПОСТ /апи/цомпани/гет-токен Набавите токен ауторизације компаније
ГЕТ /апи/компанија/организација Преузми листу организација
ГЕТ /апи/оператор Листа оператера по организацији
ПОСТ /апи/оператор/синцхронизе Додај нове операторе
ПОСТ /апи/оператор/статус Промени статус оператера
ПОСТ /апи/оператор/гет-токен Генерисање токена оператера (макс. 24х истека)
ПОСТ /апи/оператор/валидате-токен Провери валидност токена

Кључне карактеристике

Управљање токенима компаније

Набавите и управљајте токенима на нивоу организације за приступ АПИ-ју.

Управљање организацијом

  • Наведите све организације
  • Преузмите детаље о организацији
  • Управљајте подешавањима организације

Управљање оператером

  • Наведите оператере по организацији
  • Додајте нове оператере
  • Промените статус оператера (активан/неактиван/избрисан)
  • Генеришите токене специфичне за оператера (максимално 24 сата)
  • Потврдите токене оператера

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

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

Брзи почетак

  1. Аутентификација – Набавите токене своје компаније и оператера
  2. Организације – Управљајте организацијама
  3. Оператори - Додајте оператере и управљајте њима
  4. Интеграција виџета – Интегришите виџет за ћаскање

Формат захтева

Сви захтеви користе ЈСОН формат:

ЦОДЕ_БЛОЦК_5

Формат одговора

Успешни одговори враћају:

ЦОДЕ_БЛОЦК_6

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

ХТТП статусни кодови:

  • 200 ОК - Захтев је успео
  • 400 лоших захтева - Неважећи формат захтева
  • 401 Неовлашћено - Аутентификација није успела
  • 403 Забрањено - Недовољне дозволе
  • 404 Нот Фоунд - Ресурс није пронађен
  • 500 Интерна грешка сервера - Грешка сервера

Истек токена

Токени имају време истека. Када истекне токен:

  1. АПИ ће вратити „401 Неовлашћено“.
  2. Затражите нови токен користећи крајњу тачку за аутентификацију
  3. Ажурирајте своју апликацију новим токеном

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