Biseda dhe Mesazhe

Metodat API për marrjen e meta të dhënave të bisedës ChatHub, menaxhimin e statuseve dhe rishikimin e zinxhirëve historikë të mesazheve.

URL: https://chatapi.smsbat.com

1. Merr të gjitha bisedat

Merrni një listë bisedash me filtrim dhe faqezim dinamik.

kërkesë - ** Metoda: ** MERRNI - URL: /api/chat/chats - Autorizimi: 'Shenja mbajtës' (kërkohet)

Parametrat e pyetjes

Parametri	Lloji	Përshkrimi
`faqe`	`numër i plotë`	Numri i faqes. Parazgjedhja: `1`
`për_faqe`	`numër i plotë`	Artikujt për faqe. Parazgjedhja: `20`
`kërkim`	`varg`	Kërkimi i tekstit (p.sh., emri, telefoni)
`burimi`	`numër i plotë`	Enum burimi i bisedës (p.sh. `1` për Viber Bot, `2` për Telegram)
'data'	'data'	Merr bisedat midis dy datave (kërkon dy çelësa parametrash identikë në URL). Shembull: `?datë=2026-01-28&datë=2026-01-29`
`tg_user_id`	`numër i plotë`	ID e përdoruesit të Telegramit
`telefon`	`varg`	Numri i telefonit
"statusi"	`numër i plotë`	`0` = E re, `1` = Hapur, `2` = Në pritje, `3` = Në pauzë, `4` = Mbyllur
`Id i organizatës`	`numër i plotë`	Ngusht nga organizata
`OperatorId`	`numër i plotë`	Ngushtoni sipas operatorit të caktuar

Përgjigje (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. Ndrysho statusin e bisedës

Përditëson statusin e caktuar të një seance bisede specifike.

kërkesë - Metoda: PUT - URL: /api/chat/status - Autorizimi: Bearer Token - Titujt: Lloji i përmbajtjes: aplikacion/json

Trupi: KODI_BLOCK_1

Vlerat e numrit të statusit: - 0: E re (e krijuar rishtazi) - 1: E hapur (trajtohet në mënyrë aktive nga operatori) - 2: Në pritje (në pritje të përgjigjes së përdoruesit) - 3: Në pauzë (gjendje në pauzë) - 4: E mbyllur (e arkivuar)

3. Fshi një Chat

Fshin përgjithmonë një bisedë përmes ID-së së tij unike.

kërkesë - ** Metoda: ** FSHIJE - URL: /api/chat/chats/{id} - Autorizimi: Bearer Token

Përgjigje (200 OK) Kthen një HTTP 200 për të konfirmuar fshirjen e suksesshme. Trupi zakonisht është bosh ose rreptësisht "OK"".

4. Merr mesazhet e bisedës

Hidh të gjitha mesazhet e dërguara dhe të marra historikisht brenda një bisede të veçantë.

kërkesë - ** Metoda: ** MERRNI - URL: /api/chat/chats/{chatId}/messages - Autorizimi: Bearer Token

Përgjigje (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
  }
]

Autorët: - 0: Operator - 1: Klient - 2: Sistemi Bot - 3: Llogaria e biznesit në Viber

Llojet e mesazheve: - 0: Tekst - 1: Foto - 2: Skedar

5. Përditëso statusin e mesazheve

Shënon një mesazh (ose mesazhe të shumta) brenda një bisede aktive me statuse të reja dërgimi.

kërkesë - Metoda: PUT - URL: /api/chat/messages/status - Autorizimi: Bearer Token - Titujt: Lloji i përmbajtjes: aplikacion/json

Trupi: KODI_BLOCK_3 (Statusi 3 shënon ID-të e mesazhit të dërguar si "Lexo")