Ћаскања и поруке
АПИ методе за преузимање метаподатака ЦхатХуб разговора, управљање статусима и преглед историјских ланаца порука.
УРЛ: хттпс://цхатапи.смсбат.цом
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 означава ИД-ове послате поруке као “Прочитано”)