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

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

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

---

1. Преузмите сва ћаскања

Преузмите листу ћаскања са динамичким филтрирањем и пагинацијом.

Захтев

• Метод: ГЕТ
• УРЛ: /апи/цхат/цхатс
• Овлашћење: Жетон носиоца (обавезно)

Параметри упита

Параметар	Тип	Опис
страница	цео број	Број странице. Подразумевано: 1
по_страници	цео број	Ставке по страници. Подразумевано: 20
тражи	стринг	Претрага текста (нпр. име, телефон)
извор	цео број	Цхат Соурце Енум (нпр. 1 за Вибер Бот, 2 за Телеграм)
датум	датетиме	Преузима разговоре између два датума (захтева два идентична кључа параметара у УРЛ-у). Пример: ?дате=2026-01-28&дате=2026-01-29
тг_усер_ид	цео број	ИД корисника Телеграма
телефон	стринг	Број телефона
статус	цео број	0 = Ново, 1 = Отворено, 2 = Чекање, 3 = Укључена пауза, 4 = Затворено
организатионИд	интегер	Ужи по организацији
операторИд	интегер	Сузи према додељеном оператору

Одговор (200 ОК)

{
  "total": 124,
  "items": [
    {
       "id": 123,
       "theme": "Support Ticket #491",
       "operator": {
           "id": 21,
           "name": "Jane",
           "photo": "url_to_photo.png"
       },
       "chatStatus": 1,
       "countUnread": 3
    }
  ]
}

---

2. Промените статус ћаскања

Ажурира додељени статус одређене сесије ћаскања.

Захтев

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

Тело:

{
  "id": 123,
  "status": 1
}

Вредности набрајања статуса:

• 0: Ново (ново генерисано)
• 1: Отворено (активно управља оператер)
• 2: Чека се (Чека се одговор корисника)
• 3: ОнПаусе (Паузирано стање)
• 4: затворено (архивирано)

---

3. Избришите ћаскање

Трајно брише ћаскање преко његовог јединственог ИД-а.

Захтев

• Метод: ИЗБРИШИ
• УРЛ: /апи/цхат/цхатс/{ид}
• Овлашћење: Токен носиоца

Одговор (200 ОК) Враћа ХТТП 200 да потврди успешно брисање. Тело је обично празно или строго "ОК".

---

4. Преузми поруке ћаскања

Избацује све поруке које су претходно послате и примљене у оквиру одређеног ћаскања.

Захтев

• Метод: ГЕТ
• УРЛ: /апи/цхат/цхатс/{цхатИд}/мессагес
• Овлашћење: Токен носиоца

Одговор (200 ОК)

[
  {
        "id": 1,
        "chatId": 123,
        "message": "Hello, how can I help?",
        "phone": "380936670003",
        "author": 0,
        "status": 3,
        "date": "2025-04-01T09:46:24.687Z",
        "operator": {
          "id": 21,
          "name": "Jane"
        },
        "messageType": 0
  }
]

Аутори:

• 0: Оператор
• 1: Клијент
• 2: Системски бот
• 3: Вибер пословни налог

Типови порука:

• 0: Текст
• 1: Фотографија
• 2: Фајл

---

5. Ажурирајте статус порука

Означава поруку (или више порука) унутар активног ћаскања новим статусима испоруке.

Захтев

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

Тело:

{
  "status": 3,
  "messageIds": [1, 2, 3]
}

(Статус 3 означава ИД-ове послате поруке као “Прочитано”)