Ауторизација оператера и дубоке везе
Овај водич објашњава како да добијете важећи токен ауторизације за оператере у систему преко АПИ-ја и како да користите дубоке везе за навигацију до панела за ћаскање.
Основни УРЛ АПИ-ја: хттпс://цхатапи.смсбат.цом/
Сваггер: хттпс://цхатапи.смсбат.цом/индек.хтмл
Напомена: Можете да користите заглавље
Кс-Аутхоризатион-Кеиса својим токеном (доступно у вашем профилу на контролној табли) уместо овлашћењаНосиоцаза захтеве на нивоу компаније.
1. Набавите токен компаније
Да бисте добили токен компаније, пошаљите ХТТП ПОСТ захтев на /апи/цомпани/гет-токен који садржи акредитиве за пријаву компаније.
Захтев
- Метод: ПОСТ
- УРЛ: хттпс://цхатапи.смсбат.цом/апи/цомпани/гет-токен
- Заглавља: Тип садржаја: апликација/јсон
Тело: ЦОДЕ_БЛОЦК_0
Одговор
- Код статуса: 200 (ОК)
- Тело: токен стринга ("ваш_токен_стринг")
Напомена: Сачувајте примљени токен за наредне захтеве.
2. Преузми листу организација
Пошаљите ГЕТ захтев на /апи/цомпани/организатион користећи токен компаније да бисте навели своје организације.
Захтев
- Метод: ГЕТ
- УРЛ: хттпс://цхатапи.смсбат.цом/апи/цомпани/организатион
- Заглавља:
- Овлашћење: носилац {токен}
- Прихвати: текст/обично
Одговор - Код статуса: 200 (ОК) - Тело: ЦОДЕ_БЛОЦК_1
3. Преузми оператере по организацији
Пошаљите ГЕТ захтев на /апи/оператор користећи параметар организатионИд.
Захтев
- Метод: ГЕТ
- УРЛ: хттпс://цхатапи.смсбат.цом/апи/оператор?организатионИд={ид}
- Заглавља:
- Овлашћење: носилац {токен}
- Прихвати: текст/обично
Одговор - Код статуса: 200 (ОК) - Тело: ЦОДЕ_БЛОЦК_2
4. Додајте оператере у систем
Користите токен компаније да приступите овој крајњој тачки и синхронизујете оператере са системом.
Захтев
- Метод: ПОСТ
- УРЛ: хттпс://цхатапи.смсбат.цом/апи/оператор/синцхронизе
- Заглавља:
- Овлашћење: носилац {токен}
- Тип садржаја: апликација/јсон
Тело: ЦОДЕ_БЛОЦК_3
Одговор - Код статуса: 200 (ОК) - Тело: ЦОДЕ_БЛОЦК_4
Могући статуси оператера:
- Активан: 0
- Неактивно: 1
- Избрисано: 2
5. Набавите токен оператера
Овластите токеном компаније да добијете токен за одређеног оператера.
Захтев
- Метод: ПОСТ
- УРЛ: хттпс://цхатапи.смсбат.цом/апи/оператор/гет-токен
- Заглавља:
- Овлашћење: носилац {токен}
- Тип садржаја: апликација/јсон
Тело:
ЦОДЕ_БЛОЦК_5
екпиресАт је обавезан и одређује трајање сесије оператера (максимално +24 сата).
Одговор - Код статуса: 200 (ОК) - Тело: токен низа
6. Потврдите токен оператера
Проверите валидност токена оператера.
Захтев
- Метод: ПОСТ
- УРЛ: хттпс://цхатапи.смсбат.цом/апи/оператор/валидате-токен
- Заглавља:
- Овлашћење: носилац {токен}
- Тип садржаја: апликација/јсон
Тело: "оператор_токен_стринг"
Ваљан одговор (200 ОК): ЦОДЕ_БЛОЦК_6
7. Дубоко повезивање са панелом за ћаскање оператера
Спољни системи (ЦРМ, ЕРП, интерни веб-сајтови) могу директно да отворе панел за ћаскање користећи дубоке везе прослеђивањем токена ЈВТ оператера као параметра. Ако је токен неважећи или истекао, корисник ће бити преусмерен на интерфејс за пријаву.
Формат 1: По ИД-у ћаскања
ЦОДЕ_БЛОЦК_7
Формат 2: По броју телефона
ЦОДЕ_БЛОЦК_8 Број телефона мора бити у међународном формату Е.164.
Формат 3: Алфа именом и телефоном
ЦОДЕ_БЛОЦК_9
Формат 4: Комплетни детаљи циља
Наведите тачно из ког извора желите да пресретнете поруке:
ЦОДЕ_БЛОЦК_10
Извори ћаскања:
- 0 - Вибер
- 1 - ВиберБот
- 2 - ТелеграмБот
- 3 - Вхатсапп
- 4 - Виџет
- 5 - Розетка
- 6 - Фејсбук
- 7 - Инстаграм