Help Center Ћаскања и поруке

Ћаскања и поруке

АПИ методе за преузимање метаподатака ЦхатХуб разговора, управљање статусима и преглед историјских ланаца порука.

УРЛ: хттпс://цхатапи.смсбат.цом


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 означава ИД-ове послате поруке као “Прочитано”)