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

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

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” အဖြစ် အမှတ်အသားပြုသည်)