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

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

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

Основни УРЛ

https://chatapi.smsbat.com

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

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

https://chatapi.smsbat.com/index.html

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

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

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

curl -X GET https://chatapi.smsbat.com/api/company/organization \
  -H "Authorization: Bearer your-jwt-token"

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

curl -X GET https://chatapi.smsbat.com/api/company/organization \
  -H "X-Authorization-Key: your-jwt-token"

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

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

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

Ток рада

graph LR
    A[Get Company Token] --> B[List Organizations]
    B --> C[List/Add Operators]
    C --> D[Get Operator Token]
    D --> E[Integrate Widget]

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

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

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

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

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

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

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

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

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

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

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

Брзи почетак

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

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

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

{
  "login": "your-login",
  "password": "your-password"
}

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

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

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiration": "2025-01-24T12:00:00Z"
}

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

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

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

Истек токена

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

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

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