Chatovi i poruke

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

URL: https://chatapi.smsbat.com

---

1. Dobijte sve razgovore

Dohvatite popis razgovora s dinamičkim filtriranjem i označavanjem stranica.

Zahtjev

• Metoda: GET
• URL: /api/chat/chats
• Autorizacija: Bearer Token (obavezno)

Parametri upita

Parametar	Upišite	Opis
stranica	cijeli broj	Broj stranice. Zadano: 1
po_stranici	cijeli broj	Stavki po stranici. Zadano: 20
tražiti	niz	Pretraživanje teksta (npr. ime, telefon)
izvor	cijeli broj	Chat Source Enum (npr. 1 za Viber Bot, 2 za Telegram)
datum	datumvrijeme	Dohvaća razgovore između dva datuma (zahtijeva dva identična ključa parametra u URL-u). Primjer: ?datum=2026-01-28&date=2026-01-29
tg_korisnički_id	cijeli broj	Telegram korisnički ID
telefon	niz	Broj telefona
status	cijeli broj	0 = Novo, 1 = Otvoreno, 2 = Čekanje, 3 = Pauza, 4 = Zatvoreno
ID organizacije	cijeli broj	Suzi prema organizaciji
Id operatera	cijeli broj	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 razgovora

Ažurira dodijeljeni status određene sesije razgovora.

Zahtjev

• Metoda: PUT
• URL: /api/chat/status
• Autorizacija: Bearer Token
• Zaglavlja: Content-Type: application/json

Tijelo:

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

Status Enum vrijednosti:

• 0: Novo (novo generirano)
• 1: Otvoreno (aktivno upravlja operater)
• 2: Čeka se (čeka se odgovor korisnika)
• 3: OnPause (Stanje pauze)
• 4: Zatvoreno (Arhivirano)

---

3. Izbrišite chat

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

Zahtjev

• Metoda: DELETE
• URL: /api/chat/chats/{id}
• Autorizacija: Bearer Token

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

---

4. Dohvati chat poruke

Izbacuje sve povijesno poslane i primljene poruke unutar određenog chata.

Zahtjev

• Metoda: GET
• URL: /api/chat/chats/{chatId}/messages
• Autorizacija: 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
  }
]

Autori:

• 0: Operator
• 1: Klijent
• 2: System Bot
• 3: Viber poslovni račun

Vrste poruka:

• 0: Tekst
• 1: Fotografija
• 2: Datoteka

---

5. Ažurirajte status poruka

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

Zahtjev

• Metoda: PUT
• URL: /api/chat/messages/status
• Autorizacija: Bearer Token
• Zaglavlja: Content-Type: application/json

Tijelo:

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

(Status 3 označava ID-ove poslanih poruka kao “Pročitano”)