Ћаскања и поруке
АПИ методе за преузимање метаподатака ЦхатХуб разговора, управљање статусима и преглед историјских ланаца порука.
УРЛ: хттпс://цхатапи.смсбат.цом
1. Преузмите сва ћаскања
Преузмите листу ћаскања са динамичким филтрирањем и пагинацијом.
Захтев
- Метод: ГЕТ
- УРЛ: /апи/цхат/цхатс
- Овлашћење: Жетон носиоца (обавезно)
Параметри упита
| Параметар | Тип | Опис |
|---|---|---|
страница |
цео број |
Број странице. Подразумевано: 1 |
по_страници |
цео број |
Ставке по страници. Подразумевано: 20 |
тражи |
стринг |
Претрага текста (нпр. име, телефон) |
извор |
цео број |
Цхат Соурце Енум (нпр. 1 за Вибер Бот, 2 за Телеграм) |
датум |
датетиме |
Преузима разговоре између два датума (захтева два идентична кључа параметара у УРЛ-у). Пример: ?дате=2026-01-28&дате=2026-01-29 |
тг_усер_ид |
цео број |
ИД корисника Телеграма |
телефон |
стринг |
Број телефона |
статус |
цео број |
0 = Ново, 1 = Отворено, 2 = Чекање, 3 = Укључена пауза, 4 = Затворено |
организатионИд |
интегер |
Ужи по организацији |
операторИд |
интегер |
Сузи према додељеном оператору |
Одговор (200 ОК) ЦОДЕ_БЛОЦК_0
2. Промените статус ћаскања
Ажурира додељени статус одређене сесије ћаскања.
Захтев
- Метод: ПУТ
- УРЛ: /апи/цхат/статус
- Овлашћење: Токен носиоца
- Заглавља: Тип садржаја: апликација/јсон
Тело: ЦОДЕ_БЛОЦК_1
Вредности набрајања статуса:
- 0: Ново (ново генерисано)
- 1: Отворено (активно управља оператер)
- 2: Чека се (Чека се одговор корисника)
- 3: ОнПаусе (Паузирано стање)
- 4: затворено (архивирано)
3. Избришите ћаскање
Трајно брише ћаскање преко његовог јединственог ИД-а.
Захтев
- Метод: ИЗБРИШИ
- УРЛ: /апи/цхат/цхатс/{ид}
- Овлашћење: Токен носиоца
Одговор (200 ОК)
Враћа ХТТП 200 да потврди успешно брисање. Тело је обично празно или строго "ОК".
4. Преузми поруке ћаскања
Избацује све поруке које су претходно послате и примљене у оквиру одређеног ћаскања.
Захтев
- Метод: ГЕТ
- УРЛ: /апи/цхат/цхатс/{цхатИд}/мессагес
- Овлашћење: Токен носиоца
Одговор (200 ОК)
ЦОДЕ_БЛОЦК_2
Аутори:
- 0: Оператор
- 1: Клијент
- 2: Системски бот
- 3: Вибер пословни налог
Типови порука:
- 0: Текст
- 1: Фотографија
- 2: Фајл
5. Ажурирајте статус порука
Означава поруку (или више порука) унутар активног ћаскања новим статусима испоруке.
Захтев
- Метод: ПУТ
- УРЛ: /апи/цхат/мессагес/статус
- Овлашћење: Токен носиоца
- Заглавља: Тип садржаја: апликација/јсон
Тело:
ЦОДЕ_БЛОЦК_3
(Статус 3 означава ИД-ове послате поруке као "Прочитано")