Meta နှင့် Instagram API ပေါင်းစပ်ခြင်း။

SMSBAT ChatHub Platform တွင် Instagram အက်ပ်တစ်ခု တည်ဆောက်ခြင်းအတွက် ရည်ညွှန်းချက်- စစ်မှန်ကြောင်းအထောက်အထားပြခြင်း၊ Instagram တိုက်ရိုက်စကားပြောဆိုမှုများ၊ ပို့စ်များနှင့် Reels တွင်မှတ်ချက်များ၊ ဇာတ်လမ်းပြန်ကြားချက်များ၊ webhooks နှင့် မဲရုံများ။

---

1. အခြေခံ URL များ

ရည်ရွယ်ချက်	URL
Chat API + Meta API	https://chatapi.smsbat.com
Swagger UI / OpenAPI	https://chatapi.smsbat.com/index.html · …/swagger/v1/swagger.json
REST API (အဖွဲ့အစည်း၊ ပြန်ခေါ် URLs)	https://restapi.smsbat.com
REST API Swagger	https://restapi.smsbat.com/swagger/v1/swagger.json
အော်ပရေတာ ဝဘ်ဘောင်	https://chat.smsbat.com

---

2. စစ်မှန်ကြောင်းအထောက်အထားပြခြင်း။

စစ်ဆေးမှုအစီအစဉ် ** အဆုံးမှတ်အုပ်စု ** ပေါ်တွင်မူတည်သည်။ ၎င်းတို့ကို ရောနှောခြင်းသည် 401 ၏ အဖြစ်အများဆုံး အကြောင်းရင်း ဖြစ်သည်။

အုပ်စု	ခေါင်းစီး
chatapi.smsbat.com/api/meta/* (ပို့စ်များ၊ မှတ်ချက်များ)	X-Authorization-Key: <organization token>
chatapi.smsbat.com/api/chat/*, /api/company/*, /api/operator/*	Authorization: Bearer <JWT>
restapi.smsbat.com/*	X-Authorization-Key · Authorization: Bearer · Basic Auth

X-Authorization-Key အတွက် အဖွဲ့အစည်း တိုကင်ကို Profile အောက်ရှိ အကန့်တွင် ထုတ်ပေးပါသည်။ ကုမ္ပဏီနှင့် အော်ပရေတာ JWT များသည် /api/company/get-token နှင့် /api/operator/get-token တို့မှ လာပါသည်။

2.1 ကုမ္ပဏီ တိုကင်

POST https://chatapi.smsbat.com/api/company/get-token
Content-Type: application/json

{ "login": "company_login", "password": "company_password" }

200 OK သည် တိုကင်ကြိုးအလွတ်တစ်ခုကို ပြန်ပေးသည်။

၂.၂ အဖွဲ့အစည်းများ

GET https://chatapi.smsbat.com/api/company/organization
Authorization: Bearer <company_token>

[ { "id": 24, "name": "My Instagram Store" } ]

2.3 အဖွဲ့အစည်းတစ်ခုရှိ အော်ပရေတာများ

GET https://chatapi.smsbat.com/api/operator?organizationId=24
Authorization: Bearer <company_token>

[
  {
    "id": 21,
    "name": "Jane Doe",
    "status": 0,
    "organization": { "id": 24, "name": "My Instagram Store" }
  }
]

အော်ပရေတာ အခြေအနေများ- 0 အသက်ဝင်သည်၊ 1 မလှုပ်ရှား၊ 2 ဖျက်ထားသည်။

2.4 အော်ပရေတာများကို ပေါင်းထည့်/ထပ်တူပြုခြင်း။

POST https://chatapi.smsbat.com/api/operator/synchronize
Authorization: Bearer <company_token>
Content-Type: application/json

[ { "organizationId": 24, "name": "John Operator" } ]

200 OK → [ { "id": 21, "status": 0, "name": "John Operator" } ]

2.5 အော်ပရေတာ JWT

POST https://chatapi.smsbat.com/api/operator/get-token
Authorization: Bearer <company_token>
Content-Type: application/json

{ "id": 21, "expiresAt": "2026-12-31T23:59:59.000Z" }

200 OK သည် JWT ကို စာတန်းအဖြစ် ပြန်ပေးသည်။

2.6 အော်ပရေတာ တိုကင်တစ်ခုကို အတည်ပြုပါ။

POST https://chatapi.smsbat.com/api/operator/validate-token
Authorization: Bearer <company_token>
Content-Type: application/json

"eyJhbGciOi..."

{
  "isValid": true,
  "operatorId": 21,
  "clientId": 0,
  "expiresAt": "2026-12-31T23:59:59.000Z",
  "error": null
}

မမှန်ကန်သည့်အခါ- { "isValid": false, "error": "Invalid token" }။

2.7 အော်ပရေတာချက်တင်အကန့်ကို မြှုပ်နှံပါ။

<script type="module" id="operator-chat-panel-script"
  src="https://widget.smsbat.com/operator-chat-panel/widget-script.js"
  token="YOUR_OPERATOR_JWT_TOKEN"></script>

---

3. ချက်တင်ဘောင်သို့ နက်နဲသောလင့်ခ်များ ချိတ်ဆက်ပါ။

ပြင်ပစနစ် (CRM၊ ERP၊ ဝဘ်ဆိုဒ်) သည် သီးခြားစကားပြောဆိုမှုကို ဖွင့်နိုင်သည်။ https://chat.smsbat.com/။ အော်ပရေတာအား မေးမြန်းမှု ကန့်သတ်ချက်တစ်ခုအဖြစ် အတည်ပြုထားသော JWT မှ ခွင့်ပြုထားသည်။

https://chat.smsbat.com/?chat_raw_id=<chat_id>&token=<jwt>
https://chat.smsbat.com/?phone=<phone>&token=<jwt>
https://chat.smsbat.com/?from=<bm_id>&phone=<phone>&token=<jwt>
https://chat.smsbat.com/?source=7&from=<bm_id>&phone=<phone>&token=<jwt>

ကန့်သတ်ချက်	ဖော်ပြချက်
chat_raw_id	ချတ် ID
phone	နိုင်ငံတကာဖော်မတ်ရှိ ဖုန်းနံပါတ်
from	ကုန်အမှတ်တံဆိပ်/လုပ်ငန်း အကောင့် သတ်မှတ်သူ (bm_id)
source	ချတ်ရင်းမြစ် — Instagram အတွက် 7၊ §8.1
token	ချတ်များ

မမှန်ကန်သော JWT သည် လည်ပတ်သူအား အော်ပရေတာအကန့်၏ အကောင့်ဝင်ခြင်းစခရင်ပေါ်တွင် နေရာချပေးသည်။

---

4. Instagram တိုက်ရိုက်စကားပြောဆိုမှုများ

4.1 စာရင်းချတ်များ

GET https://chatapi.smsbat.com/api/chat/chats?source=7&page=1&per_page=20
Authorization: Bearer <token>

Query ကန့်သတ်ချက်များ၊ ရွေးချယ်နိုင်သမျှ-

ကန့်သတ်ချက်	ရိုက်	ဖော်ပြချက်
source	ChatSource	7 ရလဒ်များကို Instagram
entityId	int	လုပ်ငန်းအကောင့် ID။ source
instagram_user_id	int	ChatHub
facebook_user_id	int	ChatHub
page / per_page	int	Pagination၊ ပုံသေ 1 / 20
status	ChatStatus[]	ချတ်အခြေအနေ၊ ထပ်ခါတလဲလဲ
search	string	အခမဲ့စာသားရှာဖွေမှု (အမည်၊ ဖုန်း၊ …)
organizationId	int	အဖွဲ့အစည်း ID
operatorId	int[]	သတ်မှတ်ထားသော အော်ပရေတာများ
date	string[]	ဘောင်နှစ်ခု- ?date=…&date=…
isChain	bool	ယခင်ချတ်များမှ မက်ဆေ့ချ်များ
isUnread, starMark, isOperator, isAIAgent	bool	နောက်ထပ် စစ်ထုတ်မှုများ
phone, email, contactId, clientId, tagIds, rate, sortedBy	—	အခြား filters

200 OK ပြန်လာသည် GetChatsResponse

{
  "total": 1,
  "newMessagesCount": 2,
  "items": [
    {
      "id": 1867,
      "theme": null,
      "messSource": 7,
      "chatStatus": 1,
      "countUnread": 2,
      "metaUserId": "1585775752382460",
      "instaAccount": { "id": 12, "name": "my_instagram_shop", "photo": "https://..." },
      "instagramUser": { "id": 123, "name": "marianna_cat", "photo": "https://..." },
      "operator": { "id": 21, "name": "Jane", "photo": "https://..." },
      "client": { "id": 55, "name": "Marianna", "photo": null },
      "textLastMess": "Hello! Is this product available?",
      "timeLastMess": "2026-08-13T10:15:00Z",
      "authorLastMessage": 1,
      "messageStatus": 6,
      "isMedia": false,
      "phone": null,
      "organizationId": 1,
      "createdAt": "2026-08-13T10:14:00Z",
      "isStarred": false,
      "isBlocked": false,
      "tags": []
    }
  ]
}

Instagram အက်ပ်အတွက် အရေးကြီးသော နယ်ပယ်များ-

လယ်	အဓိပ္ပါယ်
instaAccount	Instagram လုပ်ငန်းအကောင့် (ဆိုင်)။ id သည် entityId စစ်ထုတ်မှုတန်ဖိုးဖြစ်သည်။ name သည် Meta
instagramUser	** ဖောက်သည် ** ။ name သည် Instagram လက်ကိုင်ဖြစ်ပြီး id သည် instagram_user_id စစ်ထုတ်မှုတန်ဖိုး
metaUserId	Meta ဘက်မှ (string)
messSource	Instagram
phone	များသောအားဖြင့် Instagram အတွက် null — ၎င်းကို သော့အဖြစ် မသုံးပါနှင့်

ChatDTO olxUser၊ promUser၊ waba၊ rozetkaUser၊ facebookAccount၊ facebookUser၊ viberAccount၊ tgBot၊ tgUser၊ viberBot၊ viberBotUser၊ widget၊ media၊ isConnectedAI၊ isPromo၊ rate၊ rateComment၊ closedBy၊ draft၊ lang၊ starMark၊ contactId၊ contactName၊ block၊ isInStopList၊ stopList၊ isSmsFallbackEnabled နှင့် taggedMessages။

4.2 ချတ်မက်ဆေ့ချ်များ

GET https://chatapi.smsbat.com/api/chat/chats/1867/messages?isChain=false
Authorization: Bearer <token>

200 OK သည် ChatMessageDTO ၏ array တစ်ခုကို ပြန်ပေးသည်-

[
  {
    "id": 9928,
    "chatId": 1867,
    "message": "Hi! Do you have size M in stock?",
    "messageTranslation": null,
    "phone": null,
    "author": 1,
    "source": 7,
    "media": null,
    "replyTo": null,
    "status": 6,
    "date": "2026-08-13T10:14:00Z",
    "operator": null,
    "client": { "id": 123, "name": "marianna_cat", "photo": "https://..." },
    "messageType": 0,
    "isInternal": false,
    "isBroadcast": false,
    "starMark": false,
    "referralGuid": null,
    "postId": null,
    "isConnectedAI": false,
    "organizationId": 1,
    "countUnreadMessages": 0
  }
]

Instagram ပို့စ်တစ်ခု သို့မဟုတ် Story နှင့်ပတ်သက်သည့် မက်ဆေ့ချ်သည် — ကျော်သွားသောအခါ postId ကို ဖြည့်သွင်းသည် Meta API သို့ id / postId အဖြစ် တည့်တည့်ပြန်။ media သည် ChatMediaDTO ဖြစ်သည် { name, format, type, uri, raw, length, isUploaded }။

4.3 စာတိုပေးပို့ပါ (JSON)

POST https://chatapi.smsbat.com/api/chat/1867/message
Authorization: Bearer <token>
Content-Type: application/json

ခန္ဓာကိုယ် — SendChatMessageDTO

{
  "textMessage": "Hello! Yes, size M is available.",
  "author": 0,
  "isInternal": false,
  "replyToMessageId": 9928,
  "appGuid": "550e8400-e29b-41d4-a716-446655440000",
  "media": {
    "name": "item.jpg",
    "format": "image/jpeg",
    "dataBase64": "/9j/4AAQSkZJRg...",
    "type": 1
  }
}

လယ်	ရိုက်	ဖော်ပြချက်
textMessage	string?	မက်ဆေ့ချ်စာသား။ media ရှိနေသောအခါတွင် ဗလာဖြစ်နိုင်သည်။
author	AuthorMessage?	0 အော်ပရေတာ၊ 1 သုံးစွဲသူ
isInternal	bool?	true သည် ဖောက်သည်ထံ ပေးပို့ခြင်းမရှိသော အတွင်းရေးမှတ်စုတစ်ခု အမှတ်အသားဖြစ်သည်။
replyToMessageId	int?	မက်ဆေ့ဂျ်၏ ID ကို
appGuid	uuid?	လမ်းညွှန် GUID
media	MediaDTO?	{ name, format, dataBase64, thumbnail, duration, type }

200 OK → { "id": 9930, "messageStatus": 0 }

လမ်းညွှန် GUID ကို လမ်းကြောင်းတွင် ဖြတ်သန်းနိုင်သည်- POST /api/chat/{chatId}/{referralGuid}/message (ထို့အတူ …/message/v1၊ …/message/v2)။

4.4 ဖိုင် သို့မဟုတ် ဗီဒီယို ပေးပို့ပါ (အပိုင်းများစွာ၊ v2)

POST https://chatapi.smsbat.com/api/chat/1867/message/v2
Authorization: Bearer <token>
Content-Type: multipart/form-data

ပုံစံကွက်လပ်	ရိုက်	ဖော်ပြချက်
TextMessage	string	စာတို စာသား
Author	int	0 အော်ပရေတာ၊ 1 client
IsInternal	bool	အတွင်းပိုင်းမှတ်စု
ReplyToMessageId	int	မက်ဆေ့ချ်ကို ပြန်ကြားထားကြောင်း
AppGuid	uuid	လမ်းညွှန် GUID
Media.File	binary	ဖိုင်ကိုယ်တိုင်
Media.Name	string	ဖိုင်အမည်
Media.Format	string	MIME အမျိုးအစား (video/mp4၊ image/png၊ application/pdf)
Media.Type	MediaType	§8.5
Media.DataBase64	string	အစားထိုးရန် Media.File
Media.Thumbnail	string	Base64 ဗီဒီယို အစမ်းကြည့်ဘောင်
Media.Duration	double	ဗီဒီယိုကြာချိန် စက္ကန့်

curl -X POST "https://chatapi.smsbat.com/api/chat/1867/message/v2" \
  -H "Authorization: Bearer <token>" \
  -F "TextMessage=Here is the price list" \
  -F "Author=0" \
  -F "Media.Type=2" \
  -F "Media.File=@./price.pdf"

200 OK → { "id": 9931, "messageStatus": 0 }

4.5 ချတ်အခြေအနေကို ပြောင်းပါ။

PUT https://chatapi.smsbat.com/api/chat/status
Authorization: Bearer <token>
Content-Type: application/json

{ "id": 1867, "status": 4 }

200 OK သည် မွမ်းမံထားသော အရာဝတ္တုကို ပဲ့တင်ထပ်သည်။

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

PUT https://chatapi.smsbat.com/api/chat/messages/status
Authorization: Bearer <token>
Content-Type: application/json

{ "status": 3, "messageIds": [9928, 9929] }

4.7 ချတ်ကိုဖျက်ပါ။

DELETE https://chatapi.smsbat.com/api/chat/chats/1867
Authorization: Bearer <token>

---

5. ပို့စ်များ၊ ရီပို့များနှင့် ဇာတ်လမ်းများ

အခြေခံလမ်းကြောင်း- https://chatapi.smsbat.com/api/meta အထောက်အထား- X-Authorization-Key: <organization token>

5.1 ပို့စ်များ၊ Reels နှင့် ဇာတ်လမ်းများစာရင်း

GET https://chatapi.smsbat.com/api/meta/posts?platform=instagram&mediaType=story&page=1&perPage=20
X-Authorization-Key: <token>

ကန့်သတ်ချက်	ရိုက်	လိုအပ်သည်	ဖော်ပြချက်
page	int	မရှိ	စာမျက်နှာ၊ မူရင်း 1
perPage	int	မရှိ	စာမျက်နှာတစ်ခုစီ၊ ပုံသေ 20
id	int	မရှိ	အတွင်းပိုင်း ပို့စ် ID
platform	string	မရှိ	instagram သို့မဟုတ် facebook
mediaType	string	မရှိ	post၊ reel သို့မဟုတ် story။ ချန်လှပ်ထားသည့်အခါ အမျိုးအစားအားလုံး

# Every post
curl -H "X-Authorization-Key: <token>" \
  "https://chatapi.smsbat.com/api/meta/posts?page=1&perPage=10"

# Instagram only
curl -H "X-Authorization-Key: <token>" \
  "https://chatapi.smsbat.com/api/meta/posts?platform=instagram"

# A single post by ID
curl -H "X-Authorization-Key: <token>" \
  "https://chatapi.smsbat.com/api/meta/posts?id=42"

# Instagram Stories only
curl -H "X-Authorization-Key: <token>" \
  "https://chatapi.smsbat.com/api/meta/posts?platform=instagram&mediaType=story"

200 OK

{
  "total": 42,
  "items": [
    {
      "id": 42,
      "metaId": "18113450675314072",
      "text": "Check out our new collection!",
      "imageUrl": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-1711-4aa8-b21d-f6dbf8f347ef",
      "platform": "instagram",
      "mediaType": "story",
      "createdAt": "2026-07-22T09:35:30Z",
      "story": {
        "id": 42,
        "metaId": "18113450675314072",
        "url": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-1711-4aa8-b21d-f6dbf8f347ef"
      }
    }
  ]
}

လယ်	ဖော်ပြချက်
id	အတွင်းပိုင်း ပို့စ် ID
metaId	Meta
text	Post caption
imageUrl	ဆက်တိုက်မဟုတ်သော MetaPost.Guid သို့မဟုတ် null
platform	facebook သို့မဟုတ် instagram
mediaType	post၊ reel သို့မဟုတ် story
createdAt	ဖန်တီးရက်စွဲ (ပလပ်ဖောင်းရက်စွဲ သို့မဟုတ် ဒေတာဘေ့စ်ရက်စွဲ)
story	mediaType: "story"
story.id	အတွင်းပိုင်းဇာတ်လမ်း ID; post.id
story.metaId	Meta
story.url	သိမ်းဆည်းထားသော Story မီဒီယာ၏ တည်ငြိမ်သော ပရောက်စီ URL၊ null မီဒီယာကို မသိမ်းဆည်းနိုင်ခဲ့ပါက

ပို့စ်မီဒီယာကို နောက်ကြောင်းအတွက် GET /api/meta/post/media/{id:int} လမ်းကြောင်းနှစ်ခုဖြင့် ဝန်ဆောင်မှုပေးပါသည်။ လိုက်ဖက်မှုနှင့် GET /api/meta/post/media/{guid:guid}။ API တုံ့ပြန်မှုများနှင့် ပြန်လည်ခေါ်ဆိုမှုများအသစ် အမြဲတမ်း GUID ဖောင်ကိုထုတ်ပေးပါ။

5.2 မှတ်ချက်များစာရင်း

GET https://chatapi.smsbat.com/api/meta/comments?platform=instagram&postId=42&page=1&perPage=20
X-Authorization-Key: <token>

ကန့်သတ်ချက်	ရိုက်	လိုအပ်သည်	ဖော်ပြချက်
page	int	မရှိ	စာမျက်နှာ၊ မူရင်း 1
perPage	int	မရှိ	စာမျက်နှာတစ်ခုစီ၊ ပုံသေ 20
postId	int	မရှိ	ပို့စ် ID
parentCommentId	int	မရှိ	ကလေး မှတ်ချက်များ (ပြန်ကြားချက်များ) ပေးထားသည့် မှတ်ချက်
platform	string	မရှိ	facebook သို့မဟုတ် instagram

200 OK

{
  "total": 100,
  "items": [
    {
      "id": 5,
      "metaId": "179000000000005",
      "text": "What is the price?",
      "createdAt": "2026-04-15T10:30:00Z",
      "platform": "instagram",
      "replyStatus": null,
      "author": {
        "type": "meta_user",
        "name": "John Doe",
        "metaUserId": "1585775752382460"
      },
      "post": {
        "id": 1,
        "metaId": "18113450675314072",
        "text": null,
        "imageUrl": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-…",
        "createdAt": "2026-07-22T09:35:30Z",
        "mediaType": "story",
        "story": {
          "id": 1,
          "metaId": "18113450675314072",
          "url": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-…"
        }
      },
      "mediaUrl": "https://chatapi.smsbat.com/api/meta/comment/media/5",
      "replyTo": {
        "id": 3,
        "metaId": "179000000000003",
        "text": "Parent comment..."
      }
    }
  ]
}

လယ်	ဖော်ပြချက်
id	အတွင်းပိုင်းမှတ်ချက် ID
metaId	Meta တွင် ပြင်ပ ID။ မပေးပို့မချင်း ကျွန်ုပ်တို့၏ ဆိုင်းငံ့ထားသော အကြောင်းပြန်ချက်အတွက် null
text	မှတ်ချက်စာသား
createdAt	ဖန်တီးရက်စွဲ
platform	facebook သို့မဟုတ် instagram
replyStatus	အဝင်အသုံးပြုသူမှတ်ချက်အတွက် null၊ ကျွန်ုပ်တို့၏ဖြေကြားမှုအတွက် "pending" / "sent" / "failure"
author.type	"meta_user" ပြင်ပအသုံးပြုသူ၊ "owner" စာမျက်နှာပိုင်ရှင်
author.name	စာရေးသူအမည်
author.metaUserId	Meta တွင် ကန့်သတ်ထားသော သုံးစွဲသူ ID null for "owner"
post	မှတ်ချက်သည်
post.mediaType	post၊ reel သို့မဟုတ် story
post.story	ဇာတ်လမ်းအကိုးအကား { id, metaId, url }, ပုံပြင်များသာ
mediaUrl	မှတ်ချက်နှင့်တွဲထားသည့် မီဒီယာ သို့မဟုတ် null
replyTo	မိဘမှတ်ချက် { id, metaId, text }; null ထိပ်တန်းအဆင့်

5.3 မှတ်ချက်ကို စာပြန်ပါ။

ပေးပို့မှုအတွက် အကြောင်းပြန်ရန် တန်းစီထားသည်။

curl -X POST \
  -H "X-Authorization-Key: <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "Thanks for the feedback!"}' \
  "https://chatapi.smsbat.com/api/meta/comments/5/reply"

တောင်းဆိုချက်- { "text": "Reply text" }

202 Accepted သည် မှတ်ချက်အရာဝတ္တု — GET /api/meta/comments ကဲ့သို့ ပုံစံတူ — ဖြင့် ပြန်ပေးသည် replyStatus: "pending" နှင့် metaId: null။ ပေးပို့မှုရလဒ်သည် နောက်ပိုင်းတွင် ဖြစ်လာသည်။ source: 13 ဖုန်းပြန်ခေါ်ခြင်း (§6.4)။

---

6. Webhooks

SMSBAT သည် သင့် URL သို့ POST တောင်းဆိုမှုများကို application/json ပေးပို့ပြီး HTTP 200 ပြန်လည်ရရှိမည်ဟု မျှော်လင့်ပါသည်။

6.1 ပြန်ခေါ်ရန် URL ကို မှတ်ပုံတင်ပါ။

curl -X POST 'https://restapi.smsbat.com/organizations/callback_urls' \
  -H 'X-Authorization-Key: <token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://your-server.com/webhook",
    "source": 12,
    "headerName": "X-Webhook-Secret",
    "headerValue": "your-secret",
    "channelType": 7,
    "channelEntityId": 12
  }'

လယ်	ရိုက်	ဖော်ပြချက်
url	string	သင်၏အဆုံးမှတ်
source	SendingSourceCallback	ဖြစ်ရပ်အမျိုးအစား၊ §8.2
headerName / headerValue	string	တောင်းဆိုချက်တွင် ကျွန်ုပ်တို့ ပူးတွဲပါရှိသော မတရားသော စစ်မှန်ကြောင်း ခေါင်းစီး (ချန်လှပ်ထားနိုင်သည်)
channelType	ChatSource	Instagram အတွက် ချန်နယ်။ 7။ ရွေးချယ်ခွင့်
channelEntityId	int	သီးခြားလုပ်ငန်းအကောင့်တစ်ခု။ channelType

channelTypeမပါဘဲ URL သည် ချန်နယ်တိုင်းမှ အစီအစဉ်များကို လက်ခံရရှိသည် ။

လက်ကျန်လုပ်ဆောင်မှုများ-

GET    https://restapi.smsbat.com/organizations/callback_urls?source=12
GET    https://restapi.smsbat.com/organizations/callback_urls/{id}
PUT    https://restapi.smsbat.com/organizations/callback_urls/{id}
DELETE https://restapi.smsbat.com/organizations/callback_urls/{id}

GET ပြန်လာသည်-

[
  {
    "id": 101,
    "url": "https://your-server.com/webhook",
    "source": 12,
    "headerName": "X-Webhook-Secret",
    "headerValue": "your-secret",
    "createdAt": "2026-08-13T09:00:00Z",
    "channelType": 7,
    "channelEntityId": 12
  }
]

6.2 မက်ဆေ့ဂျ်အသစ်နှင့် Instagram Story အကြောင်းပြန်ကြားချက် (source: 3၊ 11)

Instagram Story ကို အသုံးပြုသူတစ်ဦး၏ ပြန်ကြားချက်သည် ဤခေါ်ဆိုမှုတွင် သာမန်မက်ဆေ့ချ်တစ်ခုအဖြစ် ရောက်ရှိလာသည်၊ ထိပ်တန်းအဆင့် Story ဘလောက်တစ်ခုဖြင့်-

{
  "ChatId": 123,
  "MessageId": 456,
  "MessageText": "😍",
  "Username": "Jane Smith",
  "UserId": 789,
  "MetaUserId": "1585775752382460",
  "ShopId": 12,
  "ShopName": "instagram shop name",
  "Author": 0,
  "type_messenger": 7,
  "Story": {
    "Id": 42,
    "MetaId": "18113450675314072",
    "Url": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-1711-4aa8-b21d-f6dbf8f347ef"
  }
}

လယ်	ဖော်ပြချက်
ChatId / MessageId	ချတ် နှင့် မက်ဆေ့ချ် သတ်မှတ်ခြင်း
Author	0 အသုံးပြုသူ၊ 1 အော်ပရေတာ
Username	Instagram / Facebook အမည် သို့မဟုတ် လက်ကိုင်
UserId	SMSBAT
MetaUserId	Meta ရှိ စကားဝိုင်းပါတနာ၏ နယ်ပယ် ID။ အထွက် အော်ပရေတာ မက်ဆေ့ချ်တွင်၊ ၎င်းသည် အော်ပရေတာမဟုတ်ဘဲ ချတ်၏ Meta အသုံးပြုသူကို ဖော်ထုတ်ဆဲဖြစ်သည်
ShopId	Instagram / Facebook လုပ်ငန်းအကောင့်
ShopName	ဆက်သွယ်မှုအချိန်
MessageText	စာတို စာသား
MessageMedia	မက်ဆေ့ချ်သည် မီဒီယာ
type_messenger	အရင်းအမြစ်၊ Instagram
operator_name	အော်ပရေတာအမည် Author = 1
Story	Inbound Story reply
Story.Id	အတွင်းပိုင်းဇာတ်လမ်း (MetaPost) ID — Meta API တွင် id / postId အဖြစ် တိုက်ရိုက်အသုံးပြုနိုင်သည်
Story.MetaId	Meta
Story.Url	သိမ်းဆည်းထားသော Story မီဒီယာ၏ တည်ငြိမ်သော ပရောက်စီ URL။ မီဒီယာကို မသိမ်းဆည်းနိုင်သည့်အခါ ပျက်ကွက်ခြင်း — Story ဘလောက်နှင့် မက်ဆေ့ချ်ကို ပေးပို့ဆဲ

6.3 မှတ်ချက်အသစ် (source: 12)

Meta အသုံးပြုသူတစ်ဦးသည် Facebook ပို့စ်တစ်ခု သို့မဟုတ် Instagram ပို့စ် / Reel တွင် မှတ်ချက်ပေးသည့်အခါ မီးလောင်သည်။

{
  "type": "new_comment",
  "platform": "instagram",
  "comment": {
    "id": 10,
    "metaId": "179000000000010",
    "parentCommentId": 5,
    "parentMetaId": "179000000000005",
    "parentCommentText": "The user's previous comment",
    "text": "Great product!",
    "createdAt": "2026-04-16T12:00:00Z",
    "author": {
      "type": "meta_user",
      "name": "Jane Smith",
      "metaUserId": "1585775752382460"
    }
  },
  "post": {
    "id": 1,
    "metaId": "123456789012345",
    "text": "Post description...",
    "imageUrl": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-…",
    "createdAt": "2026-04-10T12:00:00Z",
    "mediaType": "post"
  }
}

6.4 မှတ်ချက် တုံ့ပြန်မှု အခြေအနေ (source: 13)

အောင်မြင်သည်ဖြစ်စေ မအောင်မြင်သည်ဖြစ်စေ အကြောင်းပြန်ရန် ကျွန်ုပ်တို့ကြိုးစားပြီးနောက် မီးလောင်ကျွမ်းခဲ့သည်။

{
  "type": "comment_status",
  "platform": "instagram",
  "comment": {
    "id": 15,
    "metaId": "179000000000015",
    "parentCommentId": 10,
    "parentMetaId": "179000000000010",
    "parentCommentText": "Great product!",
    "text": "Thanks for the feedback!",
    "createdAt": "2026-04-16T12:05:00Z",
    "updatedAt": "2026-04-16T12:05:03Z",
    "replyStatus": "sent",
    "author": {
      "type": "owner",
      "name": "Support Agent"
    }
  },
  "post": {
    "id": 1,
    "metaId": "179999999999999",
    "text": "Reel description...",
    "imageUrl": "https://dashboard.smsbat.com/api/meta/post/media/7d124c36-…",
    "createdAt": "2026-07-22T09:35:30Z",
    "mediaType": "reel"
  }
}

6.5 မျှဝေထားသော မှတ်ချက်ခေါ်ဆိုမှု ပြန်အကွက်များ

မှတ်ချက်ခေါ်ဆိုမှု နှစ်ခုစလုံးသည် ခန္ဓာကိုယ်ပုံစံ တစ်ခုတည်းကို မျှဝေကြပြီး type ဖြင့်သာ ကွဲပြားသည်။

လယ်	ဖော်ပြချက်
type	"new_comment" သို့မဟုတ် "comment_status"
platform	"facebook" သို့မဟုတ် "instagram"
comment.id	အတွင်းပိုင်းမှတ်ချက် ID
comment.metaId	Meta ရှိ ပြင်ပ ID မပေးပို့မီ ဆိုင်းငံ့ထားသော အကြောင်းပြန်ချက်အတွက် null
comment.parentCommentId	မိဘမှတ်ချက် ID။ ထိပ်တန်းအဆင့်မှတ်ချက်
comment.parentMetaId	ပြင်ပမိဘမှတ်ချက် ID။ ထိပ်တန်းအဆင့်
comment.parentCommentText	မိဘမှတ်ချက်စာသား။ ထိပ်တန်းအဆင့်
comment.text	မှတ်ချက်စာသား
comment.createdAt	ဖန်တီးရက်စွဲ
comment.updatedAt	နောက်ဆုံးအပ်ဒိတ်။ မှတ်ချက်ကိုဘယ်တော့မှမတည်းဖြတ်ခဲ့လျှင်ပျက်ကွက်
comment.replyStatus	"pending" / "sent" / "failure"။ ဝင်ရောက်အသုံးပြုသူမှတ်ချက်အတွက် ** ပျက်ကွက် **
comment.author.type	"meta_user" သို့မဟုတ် "owner"
comment.author.name	စာရေးသူအမည်
comment.author.metaUserId	Meta တွင် ကန့်သတ်ထားသော စာရေးဆရာ ID "owner"
comment.mediaUrl	မှတ်ချက် မီဒီယာ။ ပျက်ကွက်
post.id	အတွင်းပိုင်း ပို့စ် ID
post.metaId	Meta
post.text	ပို့စ်စာသား
post.imageUrl	ပုံ URL သို့မဟုတ် null
post.createdAt	ပို့စ်ဖန်တီးရက်စွဲ
post.mediaType	မှတ်ချက်ခေါ်ဆိုမှုတွင်၊ post သို့မဟုတ် reel သာ

6.6 ချတ်အသစ် (source: 7)

{ "ChatId": 12345, "Phone": "+380501234567", "chat.Source": 7 }

6.7 မက်ဆေ့ချ်နှင့် ချတ်အခြေအနေပြောင်းလဲမှုများ (source: 6 / 5)

{ "name": "changed_message_status", "id": 9928, "status": 6 }
{ "name": "changed_chat_status",    "id": 1867, "status": 4 }

6.8 မက်ဆေ့ချ်ကို တည်းဖြတ်ထားသည် သို့မဟုတ် ဖျက်ထားသည် (source: 9)

{ "messageId": 9930, "text": "Updated message text" }
{ "messageId": 9931, "delete": true }

6.9 စာရိုက်အညွှန်း (source: 8)

{ "chat_id": 1867, "event": "start_typing", "operator_name": "Iryna" }
{ "chat_id": 1867, "event": "end_typing" }

---

7. မဲရုံပွဲ

Inbound HTTP ကို လက်မခံနိုင်သော ပတ်ဝန်းကျင်အတွက်။

7.1 ဖြစ်ရပ်များကို ရယူပါ။

GET https://chatapi.smsbat.com/api/chat/callback-events?page=1&perPage=20
Authorization: Bearer <token>

ကန့်သတ်ချက်	ဖော်ပြချက်
organizationId	ရွေးချယ်ခွင့် ချန်လှပ်ထားသောအခါ
page / perPage	Pagination၊ ပုံသေ 1 / 20

{
  "page": 1,
  "perPage": 20,
  "total": 947,
  "items": [
    {
      "ChatId": 1867,
      "MessageId": 9928,
      "MessageText": "Hello there!",
      "MessageMedia": null,
      "Phone": null,
      "Username": "marianna_cat",
      "UserId": 123,
      "ShopId": 12,
      "ShopName": "instagram shop name",
      "Author": 1,
      "type_messenger": 7,
      "message_date": "2026-08-13T12:27:39.724Z",
      "timestamp": "2026-08-13T12:27:39.736Z",
      "event_guid": "ff60129e-c6e4-4876-9d90-badb430c0606",
      "organization_id": 1,
      "callback_type": "3"
    }
  ]
}

ပွဲတိုင်းတွင် event_guid၊ timestamp၊ organization_id နှင့် callback_type — a §8.2 ရှိ source တန်ဖိုးများနှင့် ကိုက်ညီသော စာကြောင်း။ ကျန်အကွက်များသည် သက်ဆိုင်ရာနှင့် ကိုက်ညီပါသည်။ §6 တွင် webhook

7.2 လုပ်ဆောင်ပြီးသော အဖြစ်အပျက်များကို အသိအမှတ်ပြုပါ။

POST https://chatapi.smsbat.com/api/chat/callback-events/processed
Authorization: Bearer <token>
Content-Type: application/json

[ "ff60129e-c6e4-4876-9d90-badb430c0606" ]

200 OK → { "deleted": 1 }

ဖယ်ရှားပြီးသားဖြစ်ရပ်များကို deleted တွင် ထည့်သွင်းမတွက်ပါ။ မှာယူခြင်းနှင့် ထပ်ခါတလဲလဲ လုပ်ဆောင်ခြင်းများသည် သင့်အတွက်ဖြစ်သည်။ ဘက်က တာဝန်ရှိတယ်။

7.3 အကြံပြုထားသည့် ကွင်းဆက်

1. အချိန်ဇယားတစ်ခုပေါ်တွင် GET /api/chat/callback-events စစ်တမ်းကောက်ယူပါ။
2. သင့်ဝန်ဆောင်မှုရှိ အဖြစ်အပျက်များကို လုပ်ဆောင်ပါ။
3. လုပ်ဆောင်ပြီးသား event_guid စာရင်းကို /callback-events/processed သို့ ပို့ပါ။
4. ပြန်လုပ်ပါ။

---

8. Enum အကိုးအကား

8.1 ChatSource — ချန်နယ် (0–9)

ကုတ်	လက်ပံ
0	Viber
၁	ViberBot
2	TelegramBot
3	Whatsapp
4	ဝစ်
5	Rozetka
6	Facebook
7	Instagram
8	ကျောင်းကပွဲ
9	Olx

8.2 SendingSourceCallback — ဖုန်းခေါ်ဆိုမှု အစီအစဉ်အမျိုးအစား (0–13)

ကုတ်	ပွဲ
3	Chat — Story ပြန်ကြားချက်များ
5	ချတ်အခြေအနေ
6	မက်ဆေ့ချ် အခြေအနေကို ပြောင်းထားသည်
၇	ချတ်အသစ် ဖန်တီးထားသည်
8	စာရိုက်ညွှန်
9	မက်ဆေ့ချ်ကို အပ်ဒိတ်လုပ်သည် သို့မဟုတ် ဖျက်လိုက်သည်
11	AnyChatMessage — မည်သည့် chat message
12	MetaNewComment — Instagram / Facebook မှတ်ချက်အသစ်
13	MetaCommentStatus — ကျွန်ုပ်တို့၏ မှတ်ချက်ပြန်ကြားချက် ပေးပို့မှုအခြေအနေ

enum သည် 0–13၊ Instagram ပေါင်းစည်းမှုအတွက် ကျန်တန်ဖိုးများကို မလိုအပ်ပါ။

8.3 ChatStatus (0–4)

0 အသစ်၊ 1 ဖွင့်သည်၊ 2 စောင့်ဆိုင်းနေသည်၊ 3 OnPause၊ 4 ပိတ်သည်

8.4 MessageStatus (0–11)

ကုတ်	အမည်
0	အသစ်
၁	အောင်မြင်မှု
2	ငြင်းပယ်ခဲ့သည်
3	ဖတ်ရန်
4	မသိရှိ
5	စီမံဆောင်ရွက်ခြင်း
6	DELIVERED
7	BLOCKED_BY_USER
8	USER_NOT_FOUND

enum သည် 0–11 ကျယ်သည်။ တန်ဖိုးများ 9၊ 10 နှင့် 11 API တွင် ရှိနေသော်လည်း မှတ်တမ်းမတင်ရသေးပါ — သူတို့ကို UNKNOWN အဖြစ် ဆက်ဆံပါ။

8.5 MediaType (1–10)

1 ဓာတ်ပုံ၊ 2 ဖိုင်၊ 3 အသံ၊ 4 ဗီဒီယို၊ 5 စတစ်ကာ၊ 6 စတစ်ကာကာတွန်း၊ 7စတစ်ကာဗီဒီယို၊ 8 အန်နီမေးရှင်း၊ 9 အသံ၊ 10 ဗီဒီယိုမှတ်စု

8.6 AuthorMessage — Chat API (0–4) တွင် ရေးသားသူ

0 အော်ပရေတာ၊ 1 သုံးစွဲသူ၊ 2 ဘော့တ်၊ 3 ViberAccount

enum သည် 0–4၊ တန်ဖိုး 4 သည် အထောက်အထားမရှိပေ။ ** “မက်ဆေ့ဂျ်အသစ်” ပြန်ခေါ်ခြင်းများကို အသုံးပြုသည်။ ဆန့်ကျင်ဘက်မြေပုံဆွဲခြင်း** — §6.2 ကိုကြည့်ပါ။

8.7 ChatMessageType (0–2)

0 စာသား၊ 1 ဓာတ်ပုံ၊ 2 ဖိုင်

8.8 မှတ်ချက် replyStatus

null အတွင်းဝင်အသုံးပြုသူမှတ်ချက်၊ "pending" ကျွန်ုပ်တို့၏ပြန်ကြားစာသည် တန်းစီနေပါသည်၊ "sent" ပေးပို့ပြီး၊ "failure" ပေးပို့မှု မအောင်မြင်ပါ။

---

##မေးခွန်းဖွင့်ပါ။

အတွင်းပိုင်းသတ်မှတ်ချက်နှင့် ကုဒ်ထုတ်ပေးသည့် Swagger တို့က သဘောမတူသည့် အချက်သုံးချက်။ တစ်မျိုး စစ်မှန်သော တိုကင်တစ်ခုဖြင့် တောင်းဆိုမှုသည် ၎င်းတို့အားလုံးကို ဖြေရှင်းပေးသည်။ အဲဒီအချိန်အထိ client ကိုခုခံကာကွယ်ရေးသားပါ။

#	မေးခွန်း	သတ်မှတ်ချက်	ရင်ကော့	စစ်ဆေးနည်း
၁	/api/meta/*	အတွက် စစ်မှန်သော ခေါင်းစီး X-Authorization-Key	Bearer ကြေငြာ	curl -i -H "X-Authorization-Key: <token>" ".../api/meta/posts?perPage=1" — မျှော်လင့် 200၊ မဟုတ်ဘူး 401
2	Meta တုံ့ပြန်မှုများ	ရှိ တန်ပြန်အကွက် totalCount	total	တူညီသောတောင်းဆိုချက် — root JSON သော့
3	author.type အမျိုးအစားနှင့် reply အခြေအနေကုဒ်	"meta_user" / "owner", 202 ခန္ဓာကိုယ်	int [0,1], 200 ခန္ဓာကင်း	curl -i .../api/meta/comments?perPage=1 အပေါင်း စာမေးပွဲဖြေဆိုချက်

ကြားဖြတ် လမ်းညွှန်ချက်-

• တန်ပြန် — ဖတ်ရန် total ?? totalCount;
• author.type — string နှင့် integer နှစ်ခုလုံးကို လက်ခံပါ (0 ↔ meta_user၊ 1 ↔ owner၊ အတည်ပြုရန် မြေပုံဆွဲခြင်း);
• reply — 2xxကို အောင်မြင်မှုအဖြစ် ဆက်ဆံပါ၊ ခန္ဓာကိုယ်မလိုအပ်ပါ၊ source: 13 ခေါ်ဆိုမှုမှ နောက်ဆုံးအခြေအနေကို ရယူပါ။

---

အကောင်အထည်ဖော်မှုမှတ်စု

• Auth သည် အဆုံးမှတ်အုပ်စုအလိုက် ကွဲပြားသည် — /api/meta/* X-Authorization-Key၊ ချတ်များနှင့် အော်ပရေတာများက Bearer၊ restapi ကိုလည်းကောင်း လက်ခံသည်။
• Pagination ကို နည်းလမ်းနှစ်မျိုးဖြင့် စာလုံးပေါင်းသည် — per_page on /api/chat/chats၊ perPage အပေါ် /api/meta/* နှင့် /api/chat/callback-events။
• multipart/form-data အကွက်များသည် အစက်အမှတ်အသားပါသော PascalCase (Media.File၊ Media.Type) ဖြစ်သည်။
• ** Null အကွက်များကို ပြန်ခေါ်ခြင်းမှ ချန်လှပ်ထားပါသည်** — ပျက်ကွက်သော့ဆိုသည်မှာ null ဖြစ်သည်။
• phone သည် များသောအားဖြင့် Instagram တွင် null ဖြစ်သည်။ ဖောက်သည်ကို instagramUser.id / ဖြင့် ခွဲခြားသတ်မှတ်ပါ metaUserId နှင့် ဆိုင်ကို instaAccount.id ( entityId filter value )
• ပြန်လည်ခေါ်ဆိုမှုမှ Story.Idအား id / postId အဖြစ် Meta API သို့ တိုက်ရိုက်ပြန်ပေးပို့နိုင်ပါသည်။
• Deeplink သို့မဟုတ် widget တွင် အသုံးမပြုမီ အော်ပရေတာ JWT ၏ expiresAt ကို စစ်ဆေးပါ။