Chatovi i poruke

API metode za dohvaćanje metapodataka ChatHub razgovora, upravljanje statusima i pregled istorijskih lanaca poruka.

URL: https://chatapi.smsbat.com

1. Get All Chats

Dohvatite listu razgovora s dinamičkim filtriranjem i paginacijom.

Zahtjev - Metoda: GET - URL: /api/chat/chats - Ovlašćenje: Token nosioca (obavezno)

Parametri upita

Parametar	Vrsta	Opis
`stranica`	`cijeli broj`	Broj stranice. Zadano: `1`
`po_stranici`	`cijeli broj`	Stavke po stranici. Zadano: `20`
`traži`	`string`	Pretraživanje teksta (npr. ime, telefon)
`izvor`	`cijeli broj`	Chat Source Enum (npr. `1` za Viber Bot, `2` za Telegram)
`datum`	`datum i vrijeme`	Dohvaća razgovore između dva datuma (zahteva dva identična parametarska ključa u URL-u). Primjer: `?date=2026-01-28&date=2026-01-29`
`tg_user_id`	`cijeli broj`	ID korisnika Telegrama
`telefon`	`string`	Broj telefona
`status`	`cijeli broj`	`0` = Novo, `1` = Otvoreno, `2` = Čekanje, `3` = Uključeno, `4` = Zatvoreno
`organizationId`	`integer`	Uži po organizaciji
`operatorId`	`integer`	Suzi prema dodijeljenom operatoru

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. Promijenite status ćaskanja

Ažurira dodijeljeni status određene sesije ćaskanja.

Zahtjev - Metoda: PUT - URL: /api/chat/status - Ovlašćenje: Token nosioca - Zaglavlja: Tip sadržaja: aplikacija/json

Tijelo:

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

Vrijednosti nabrajanja statusa: - 0: Novo (Novo generirano) - 1: Otvoreno (aktivno upravlja operater) - 2: Čeka se (Čeka se odgovor korisnika) - 3: OnPause (Pauzirano stanje) - 4: Zatvoreno (Arhivirano)

3. Izbrišite ćaskanje

Trajno briše chat putem njegovog jedinstvenog ID-a.

Zahtjev - Metoda: IZBRIŠI - URL: /api/chat/chats/{id} - Ovlašćenje: Token nosioca

Odgovor (200 OK) Vraća HTTP 200 za potvrdu uspješnog brisanja. Tijelo je obično prazno ili striktno "OK".

4. Preuzmi poruke ćaskanja

Izbacuje sve poruke koje su prethodno poslane i primljene unutar određenog chata.

Zahtjev - Metoda: GET - URL: /api/chat/chats/{chatId}/messages - Ovlašćenje: Token nosioca

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
  }
]

Autori: - 0: Operater - 1: Klijent - 2: Sistemski bot - 3: Viber poslovni račun

Vrste poruka: - 0: Tekst - 1: Fotografija - 2: Fajl

5. Ažurirajte status poruka

Označava poruku (ili više poruka) unutar aktivnog ćaskanja s novim statusima isporuke.

Zahtjev - Metoda: PUT - URL: /api/chat/messages/status - Ovlašćenje: Token nosioca - Zaglavlja: Tip sadržaja: aplikacija/json

Tijelo:

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

(Status 3 označava ID-ove poslane poruke kao "Pročitano")