ချတ်များနှင့် မက်ဆေ့ချ်များ

ChatHub စကားဝိုင်း မက်တာဒေတာကို ရယူခြင်း၊ အခြေအနေများကို စီမံခန့်ခွဲခြင်းနှင့် သမိုင်းဝင် မက်ဆေ့ချ်ကွင်းဆက်များကို ပြန်လည်သုံးသပ်ခြင်းအတွက် API နည်းလမ်းများ။

URL- https://chatapi.smsbat.com

1. ချတ်များအားလုံးကို ရယူပါ။

ဒိုင်းနမစ်စစ်ထုတ်ခြင်းနှင့် pagination ဖြင့် ချတ်စာရင်းကို ရယူပါ။

တောင်းဆိုချက် - နည်းလမ်း- ရယူပါ။ - URL: /api/chat/chats - ခွင့်ပြုချက်- Bearer Token (လိုအပ်သည်)

Query Parameters

ကန့်သတ်ချက်	ရိုက်	ဖော်ပြချက်
`page`	`ကိန်းပြည့်`	စာမျက်နှာနံပါတ်။ မူရင်း- `1`
`per_page`	`ကိန်းပြည့်`	စာမျက်နှာအလိုက် ပစ္စည်းများ။ မူရင်း- `20`
`ရှာဖွေ`	`string`	စာသားရှာဖွေမှု (ဥပမာ၊ အမည်၊ ဖုန်း)
`အရင်းအမြစ်`	`ကိန်းပြည့်`	Chat Source Enum (ဥပမာ Viber Bot အတွက် `1`၊ Telegram အတွက် `2`)
`ရက်စွဲ`	`datetime`	ရက်စွဲနှစ်ခုကြားတွင် ချတ်များရယူပါ (URL တွင် တူညီသော ကန့်သတ်ဘောင်ကီးနှစ်ခု လိုအပ်သည်)။ ဥပမာ- `?date=2026-01-28&date=2026-01-29`
`tg_user_id`	`ကိန်းပြည့်`	Telegram အသုံးပြုသူ ID
`ဖုန်း`	`string`	ဖုန်းနံပါတ်
`အဆင့်အတန်း`	`ကိန်းပြည့်`	`0` = အသစ်၊ `1` = ဖွင့်၊ `2` = စောင့်နေသည်၊ `3` = OnPause, `4` = ပိတ်
`organizationId`	`ကိန်းပြည့်`	အဖွဲ့အစည်းအလိုက် ကျဉ်း
`operatorId`	`ကိန်းပြည့်`	တာဝန်ပေးထားသော အော်ပရေတာ

တုံ့ပြန်မှု (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. Chat Status ကို ပြောင်းပါ။

သတ်မှတ်ထားသော ချတ်ဆက်ရှင်တစ်ခု၏ သတ်မှတ်ထားသော အခြေအနေကို အပ်ဒိတ်လုပ်သည်။

တောင်းဆိုချက် - နည်းလမ်း- PUT - URL: /api/chat/status - ခွင့်ပြုချက်- Bearer Token - ခေါင်းစီးများ- အကြောင်းအရာ-အမျိုးအစား- application/json

** ခန္ဓာကိုယ် : **

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

** အခြေအနေ ကိန်းဂဏန်းတန်ဖိုးများ-** - 0: အသစ် (အသစ်ထုတ်လုပ်ပြီး) - 1- ဖွင့်ပါ (အော်ပရေတာမှ တက်ကြွစွာ ကိုင်တွယ်ထားသည်) - 2- စောင့်ဆိုင်းနေသည် (အသုံးပြုသူ တုံ့ပြန်မှုကို စောင့်ဆိုင်းနေသည်) - 3- OnPause (ခေတ္တရပ်ထားသည့်အခြေအနေ) - 4- ပိတ်ထားသည် (မော်ကွန်းတင်ထားသည်)

3. Chat တစ်ခုကို ဖျက်ပါ။

၎င်း၏ထူးခြားသော ID မှတစ်ဆင့် ချတ်ကို အပြီးတိုင်ဖျက်သည်။

တောင်းဆိုချက် - နည်းလမ်း- ဖျက်ပါ။ - URL: /api/chat/chats/{id} - ခွင့်ပြုချက်- Bearer Token

တုံ့ပြန်မှု (200 OK) အောင်မြင်စွာဖျက်ကြောင်းအတည်ပြုရန် HTTP 200 ကို ပြန်ပေးသည်။ ခန္ဓာကိုယ်သည် ပုံမှန်အားဖြင့် ဗလာ သို့မဟုတ် တင်းကြပ်စွာ "OK" ဖြစ်သည်။

4. ချတ်မက်ဆေ့ချ်များကို ရယူပါ။

သီးခြားချတ်တစ်ခုအတွင်း သမိုင်းက ပို့ပြီး လက်ခံရရှိသော မက်ဆေ့ဂျ်အားလုံးကို စွန့်ပစ်ပါ။

တောင်းဆိုချက် - နည်းလမ်း- ရယူပါ။ - URL: /api/chat/chats/{chatId}/messages - ခွင့်ပြုချက်- Bearer Token

တုံ့ပြန်မှု (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
  }
]

ရေးသားသူ- - 0: အော်ပရေတာ - 1: ဖောက်သည် - 2- စနစ် အောက်ခြေ - 3: Viber လုပ်ငန်းအကောင့်

** မက်ဆေ့ခ်ျအမျိုးအစားများ - 0: စာသား - 1: ဓာတ်ပုံ - 2: ဖိုင်

5. မက်ဆေ့ချ်များ အခြေအနေကို အပ်ဒိတ်လုပ်ပါ။

ပေးပို့မှုအခြေအနေအသစ်များဖြင့် လက်ရှိချတ်အတွင်း မက်ဆေ့ချ်တစ်ခု (သို့မဟုတ် မက်ဆေ့ချ်အများအပြား) ကို အမှတ်အသားလုပ်ပါ။

တောင်းဆိုချက် - နည်းလမ်း- PUT - URL: /api/chat/messages/status - ခွင့်ပြုချက်- Bearer Token - ခေါင်းစီးများ- အကြောင်းအရာ-အမျိုးအစား- application/json

** ခန္ဓာကိုယ် : **

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

(အခြေအနေ 3 သည် ပေးပို့ထားသော မက်ဆေ့ချ် ID များကို "Read" အဖြစ် အမှတ်အသားပြုသည်)