Klepeti in sporočila

Metode API-ja za pridobivanje metapodatkov pogovorov ChatHub, upravljanje statusov in pregled zgodovinskih verig sporočil.

URL: https://chatapi.smsbat.com

1. Pridobite vse klepete

Pridobite seznam klepetov z dinamičnim filtriranjem in označevanjem strani.

Zahteva - Metoda: GET - URL: /api/chat/chats - Avtorizacija: Bearer Token (obvezno)

Parametri poizvedbe

Parameter	Vrsta	Opis
`stran`	`celo število`	Številka strani. Privzeto: `1`
`na_stran`	`celo število`	Predmetov na stran. Privzeto: `20`
`iskanje`	`niz`	Besedilno iskanje (npr. ime, telefon)
`vir`	`celo število`	Chat Source Enum (npr. `1` za Viber Bot, `2` za Telegram)
`datum`	`datum-ura`	Pridobi klepete med dvema datumoma (zahteva dva enaka ključa parametrov v URL-ju). Primer: `?datum=2026-01-28&datum=2026-01-29`
`tg_user_id`	`celo število`	ID uporabnika Telegram
`telefon`	`niz`	Telefonska številka
`stanje`	`celo število`	`0` = Novo, `1` = Odprto, `2` = Čakanje, `3` = V premoru, `4` = Zaprto
`ID organizacije`	`celo število`	Ožji po organizaciji
`operatorId`	`celo število`	Zoži glede na dodeljeni operater

Odgovor (200 OK)

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

2. Spremenite status klepeta

Posodobi dodeljeni status določene seje klepeta.

Zahteva - Metoda: PUT - URL: /api/chat/status - Avtorizacija: Bearer Token - Glave: Content-Type: application/json

Telo:

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

Vrednosti Enum stanja: - 0: Novo (na novo ustvarjeno) - 1: Odprto (aktivno upravlja operater) - 2: Čakanje (čakam na odgovor uporabnika) - 3: OnPause (stanje začasne zaustavitve) - 4: Zaprto (Arhivirano)

3. Izbriši klepet

Trajno izbriše klepet prek njegovega edinstvenega ID-ja.

Zahteva - Metoda: DELETE - URL: /api/chat/chats/{id} - Avtorizacija: Bearer Token

Odgovor (200 OK) Vrne HTTP 200 za potrditev uspešnega izbrisa. Telo je običajno prazno ali strogo "OK".

4. Pridobite sporočila klepeta

Izpiše vsa sporočila, poslana in prejeta znotraj določenega klepeta.

Zahteva - Metoda: GET - URL: /api/chat/chats/{chatId}/messages - Avtorizacija: Bearer Token

Odgovor (200 OK)

[
  {
        "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
  }
]

Avtorji: - 0: operater - 1: odjemalec - 2: sistemski bot - 3: poslovni račun Viber

Vrste sporočil: - 0: Besedilo - 1: Fotografija - 2: Datoteka

5. Posodobite status sporočil

Označi sporočilo (ali več sporočil) znotraj aktivnega klepeta z novimi statusi dostave.

Zahteva - Metoda: PUT - URL: /api/chat/messages/status - Avtorizacija: Bearer Token - Glave: Content-Type: application/json

Telo:

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

(Status 3 označuje ID-je poslanih sporočil kot "Prebrano")