Ауторизација оператера и дубоке везе

Овај водич објашњава како да добијете важећи токен ауторизације за оператере у систему преко АПИ-ја и како да користите дубоке везе за навигацију до панела за ћаскање.

Основни УРЛ АПИ-ја: хттпс://цхатапи.смсбат.цом/ Сваггер: хттпс://цхатапи.смсбат.цом/индек.хтмл

Напомена: Можете да користите заглавље Кс-Аутхоризатион-Кеи са својим токеном (доступно у вашем профилу на контролној табли) уместо овлашћења Носиоца за захтеве на нивоу компаније.

---

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

Да бисте добили токен компаније, пошаљите ХТТП ПОСТ захтев на /апи/цомпани/гет-токен који садржи акредитиве за пријаву компаније.

Захтев

• Метод: ПОСТ
• УРЛ: хттпс://цхатапи.смсбат.цом/апи/цомпани/гет-токен
• Заглавља: Тип садржаја: апликација/јсон

Тело:

{
  "login": "string",
  "password": "string"
}

Одговор

• Код статуса: 200 (ОК)
• Тело: токен стринга ("ваш_токен_стринг")

Напомена: Сачувајте примљени токен за наредне захтеве.

---

2. Преузми листу организација

Пошаљите ГЕТ захтев на /апи/цомпани/организатион користећи токен компаније да бисте навели своје организације.

Захтев

• Метод: ГЕТ
• УРЛ: хттпс://цхатапи.смсбат.цом/апи/цомпани/организатион
• Заглавља:
  • Овлашћење: носилац {токен}
  • Прихвати: текст/обично

Одговор

• Код статуса: 200 (ОК)
• Тело:

[
  {
    "id": 6,
    "name": "string"
  }
]

---

3. Преузми оператере по организацији

Пошаљите ГЕТ захтев на /апи/оператор користећи параметар организатионИд.

Захтев

• Метод: ГЕТ
• УРЛ: хттпс://цхатапи.смсбат.цом/апи/оператор?организатионИд={ид}
• Заглавља:
  • Овлашћење: носилац {токен}
  • Прихвати: текст/обично

Одговор

• Код статуса: 200 (ОК)
• Тело:

[
  {
    "id": 21,
    "name": "string",
    "status": 1,
    "organization": {
      "id": 24,
      "name": "test_costs"
    }
  }
]

---

4. Додајте оператере у систем

Користите токен компаније да приступите овој крајњој тачки и синхронизујете оператере са системом.

Захтев

• Метод: ПОСТ
• УРЛ: хттпс://цхатапи.смсбат.цом/апи/оператор/синцхронизе
• Заглавља:
  • Овлашћење: носилац {токен}
  • Тип садржаја: апликација/јсон

Тело:

[
  {
    "organizationId": 24,
    "name": "string"
  }
]

Одговор

• Код статуса: 200 (ОК)
• Тело:

[
  {
    "id": 21,
    "status": 0,
    "name": "string"
  }
]

Могући статуси оператера:

• Активан: 0
• Неактивно: 1
• Избрисано: 2

---

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

Овластите токеном компаније да добијете токен за одређеног оператера.

Захтев

• Метод: ПОСТ
• УРЛ: хттпс://цхатапи.смсбат.цом/апи/оператор/гет-токен
• Заглавља:
  • Овлашћење: носилац {токен}
  • Тип садржаја: апликација/јсон

Тело:

{
  "id": 0,
  "expiresAt": "2025-01-20T14:33:34.147Z"
}

екпиресАт је обавезан и одређује трајање сесије оператера (максимално +24 сата).

Одговор

• Код статуса: 200 (ОК)
• Тело: токен низа

---

6. Потврдите токен оператера

Проверите валидност токена оператера.

Захтев

• Метод: ПОСТ
• УРЛ: хттпс://цхатапи.смсбат.цом/апи/оператор/валидате-токен
• Заглавља:
  • Овлашћење: носилац {токен}
  • Тип садржаја: апликација/јсон

Тело: "оператор_токен_стринг"

Ваљан одговор (200 ОК):

{
  "isValid": true,
  "operatorId": 0,
  "clientId": 0,
  "expiresAt": "2024-12-28T14:04:15.861Z",
  "error": null
}

---

7. Дубоко повезивање са панелом за ћаскање оператера

Спољни системи (ЦРМ, ЕРП, интерни веб-сајтови) могу директно да отворе панел за ћаскање користећи дубоке везе прослеђивањем токена ЈВТ оператера као параметра. Ако је токен неважећи или истекао, корисник ће бити преусмерен на интерфејс за пријаву.

Формат 1: По ИД-у ћаскања

https://chat.smsbat.com/?chat_raw_id=<chat_id>&token=<jwt_token>

Формат 2: По броју телефона

https://chat.smsbat.com/?phone=<phone_number>&token=<jwt_token>

Број телефона мора бити у међународном формату Е.164.

Формат 3: Алфа именом и телефоном

https://chat.smsbat.com/?from=<bm_id>&phone=<phone_number>&token=<jwt_token>

Формат 4: Комплетни детаљи циља

Наведите тачно из ког извора желите да пресретнете поруке:

https://chat.smsbat.com/?source=<sourceId>&from=<bm_id>&phone=<phone_number>&token=<jwt_token>

Извори ћаскања:

• 0 - Вибер
• 1 - ВиберБот
• 2 - ТелеграмБот
• 3 - Вхатсапп
• 4 - Виџет
• 5 - Розетка
• 6 - Фејсбук
• 7 - Инстаграм