"use strict";(self.webpackChunknewoaks_help=self.webpackChunknewoaks_help||[]).push([[3070],{9899:(e,t,s)=>{s.r(t),s.d(t,{assets:()=>c,contentTitle:()=>d,default:()=>p,frontMatter:()=>h,metadata:()=>n,toc:()=>l});const n=JSON.parse('{"id":"api/get-chatbot-messages-count","title":"Get Chatbot Messages Count","description":"The  API enables you to query the count of chatbot history messages by sending a POST request to the /chat/Chatbot/GetMessageCountByChatbot endpoint.","source":"@site/developer/api/113.get-chatbot-messages-count.md","sourceDirName":"api","slug":"/api/get-chatbot-messages-count","permalink":"/guides/developer/api/get-chatbot-messages-count","draft":false,"unlisted":false,"tags":[],"version":"current","sidebarPosition":113,"frontMatter":{"sidebar_position":113},"sidebar":"sidebar","previous":{"title":"Get Messages History","permalink":"/guides/developer/api/get-message-history"},"next":{"title":"Set Messages Limit","permalink":"/guides/developer/api/set-messages-limit"}}');var r=s(4848),o=s(8453),a=s(767),i=s(8175);const h={sidebar_position:113},d="Get Chatbot Messages Count",c={},l=[{value:"Endpoint",id:"endpoint",level:2},{value:"Request Headers",id:"request-headers",level:2},{value:"Example Request",id:"example-request",level:2},{value:"Response",id:"response",level:2},{value:"Error Handling",id:"error-handling",level:2}];function u(e){const t={code:"code",h1:"h1",h2:"h2",header:"header",p:"p",...(0,o.R)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(t.header,{children:(0,r.jsx)(t.h1,{id:"get-chatbot-messages-count",children:"Get Chatbot Messages Count"})}),"\n",(0,r.jsxs)(t.p,{children:["The ",(0,r.jsx)(i.A,{})," API enables you to query the count of chatbot history messages by sending a ",(0,r.jsx)(t.code,{children:"POST"})," request to the ",(0,r.jsx)(t.code,{children:"/chat/Chatbot/GetMessageCountByChatbot"})," endpoint."]}),"\n",(0,r.jsx)(t.h2,{id:"endpoint",children:"Endpoint"}),"\n",(0,r.jsx)(a.TM,{path:"/chat/Chatbot/GetMessageCountByChatbot",method:"POST"}),"\n",(0,r.jsx)(t.h2,{id:"request-headers",children:"Request Headers"}),"\n",(0,r.jsx)(a.iW,{headers:{Authorization:"<Your-Secret-Key>"}}),"\n",(0,r.jsx)(t.h2,{id:"example-request",children:"Example Request"}),"\n",(0,r.jsx)(a.r3,{method:"POST",path:"/chat/Chatbot/GetMessageCountByChatbot",headers:{Authorization:"<Your-Session-Key>"},requestBody:{SerialNumber:"36XXGxiYDigrQgg5xz4n45bcBW7qeYyW35"}}),"\n",(0,r.jsx)(t.h2,{id:"response",children:"Response"}),"\n",(0,r.jsx)(a.zV,{responseExample:{Data:13},responseComments:{Data:"int - Number of messages for chatbot","Data.Total":"integer - Total number of message credits allocated (-1 indicates unlimited credits)","Data.Used":"integer - Number of message credits that have been used","Data.Remain":"integer - Number of message credits remaining (-1 indicates unlimited remaining credits)"}}),"\n",(0,r.jsx)(t.h2,{id:"error-handling",children:"Error Handling"}),"\n",(0,r.jsx)(a.NH,{})]})}function p(e={}){const{wrapper:t}={...(0,o.R)(),...e.components};return t?(0,r.jsx)(t,{...e,children:(0,r.jsx)(u,{...e})}):u(e)}},767:(e,t,s)=>{s.d(t,{Ay:()=>m,NH:()=>p,TM:()=>h,VQ:()=>c,iW:()=>d,r3:()=>l,zV:()=>u});s(6540);var n=s(3532),r=s(8069),o=s(9303),a=s(4848);const i=function(e,t){void 0===t&&(t={});const s=JSON.stringify(e,null,2).split("\n"),n=[];return s.forEach((e=>{const s=e.match(/"([^"]+)":/);if(s&&t[s[1]]){const r=e.match(/^\s*/)?.[0]||"";n.push(`${r}// ${t[s[1]]}`)}n.push(e)})),n.join("\n")},h=e=>{let{path:t,method:s="POST"}=e;const r=(0,n.r)()(t)||`https://usapi.hottask.com${t}`;return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsxs)("p",{children:[(0,a.jsx)("strong",{children:"Request URL:"})," ",r]}),(0,a.jsxs)("p",{children:[(0,a.jsx)("strong",{children:"Method:"})," ",s]})]})},d=e=>{let{headers:t={Authorization:"<Your-Secret-Key>","Content-Type":"application/json"},headersDescription:s={Authorization:"string, required - The secret key for authenticating the API request","Content-Type":"string, required - The content type of the request payload (must be application/json)"}}=e;return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)("p",{children:"The API request must include the following headers:"}),(0,a.jsx)("ul",{children:Object.entries(t).map((e=>{let[t,n]=e;return(0,a.jsxs)("li",{children:[(0,a.jsxs)("code",{children:[t,": ",n]})," - ",s[t]]},t)}))})]})},c=e=>{let{requestBody:t,requestBodyParams:s,addCommentsToJson:n=i}=e;return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)("p",{children:"The request body should contain the following parameters:"}),(0,a.jsx)(r.A,{language:"json",children:n(t,s)}),(0,a.jsx)("ul",{children:Object.entries(s).map((e=>{let[t,s]=e;return(0,a.jsxs)("li",{children:[(0,a.jsx)("code",{children:t})," - ",s]},t)}))})]})},l=e=>{let{method:t="POST",path:s,requestBody:i,headers:h={Authorization:"<Your-Secret-Key>","Content-Type":"application/json"}}=e;const d=(0,n.r)()(s),c="undefined"==typeof window?"usapi.hottask.com":new URL(d||`https://usapi.hottask.com${s}`).host,l={javascript:`const res = await fetch('${d||`https://usapi.hottask.com${s}`}', {\n  method: '${t}',\n  headers: ${JSON.stringify(h,null,2)},\n  body: JSON.stringify(${JSON.stringify(i,null,2)})\n});\n\nconst data = await res.json();\nconsole.log(data);`,python:`import requests\nimport json\n\nurl = '${d||`https://usapi.hottask.com${s}`}'\nheaders = ${JSON.stringify(h,null,4)}\ndata = ${JSON.stringify(i,null,2)}\n\nresponse = requests.${t.toLowerCase()}(url, headers=headers, json=data)\ndata = response.json()\nprint(data)`,bash:`curl '${d||`https://usapi.hottask.com${s}`}' \\\n  -X ${t} \\\n${Object.entries(h).map((e=>{let[t,s]=e;return`  -H '${t}: ${s}' \\`})).join("\n")}\n  -d '${JSON.stringify(i)}'`,http:`${t} ${s} HTTP/1.1\nHost: ${c}\n${Object.entries(h).map((e=>{let[t,s]=e;return`${t}: ${s}`})).join("\n")}\n\n${JSON.stringify(i,null,2)}`};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(o.A,{as:"h3",children:"JavaScript (Fetch API)"}),(0,a.jsx)(r.A,{language:"javascript",children:l.javascript}),(0,a.jsx)(o.A,{as:"h3",children:"Python (Requests Library)"}),(0,a.jsx)(r.A,{language:"python",children:l.python}),(0,a.jsx)(o.A,{as:"h3",children:"cURL"}),(0,a.jsx)(r.A,{language:"bash",children:l.bash}),(0,a.jsx)(o.A,{as:"h3",children:"HTTP Request"}),(0,a.jsx)(r.A,{language:"http",children:l.http})]})},u=e=>{let{responseExample:t,responseComments:s,addCommentsToJson:n=i}=e;const o={...t,Version:"1.0.0",Success:!0,Code:200,Message:""},h={...s,Version:"string - API version",Success:"boolean - Operation success status",Code:"integer - HTTP status code",Message:"string - Error message if any"};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)("p",{children:"The API response will be a JSON object with the following structure:"}),(0,a.jsx)(r.A,{language:"json",children:n(o,h)})]})},p=e=>{let{errorHandling:t="If the request fails, you should:\n1. Check the HTTP status code for network-level errors\n2. Examine the `Code` and `Message` fields in the response for business-level errors\n3. The `Message` field will contain detailed error information"}=e;return(0,a.jsx)("div",{style:{whiteSpace:"pre-line"},children:t})};function m(e){let{title:t,path:s,method:r="POST",description:o="",requestBody:m={timeZone:"Asia/Shanghai",type:0},requestBodyDescription:g={timeZone:"The time zone of the chatbot. The standard time zone format: e.g., Asia/Shanghai or America/New_York.",type:"Create a generic chatbot with a fixed value of 0"},requestBodyComments:j={timeZone:"string, required",type:"integer, required"},responseExample:x={Data:"3254a9d0424c4806b9ea3d0763xxxxxx",Version:"1.0.0",Success:!0,Code:200,Message:""},responseComments:y={Data:"chatbot id"},headers:f={Authorization:"<Your-Secret-Key>","Content-Type":"application/json"},headersDescription:b={Authorization:"The secret key for authenticating the API request.","Content-Type":"The content type of the request payload."},errorHandling:w="If it's an HTTP network error, you should check the `HTTP status code`. If it's a business exception, you need to examine the `Code` and `Message` fields, which will provide the error details."}=e;const T=(0,n.r)()(s),C="undefined"==typeof window?"usapi.hottask.com":new URL(T||`https://usapi.hottask.com${s}`).host;JSON.stringify(f,null,2),i(m,j),JSON.stringify(f,null,4),i(m,j),r.toLowerCase(),Object.entries(f).map((e=>{let[t,s]=e;return`  -H '${t}: ${s}' \\`})).join("\n"),JSON.stringify(m),Object.entries(f).map((e=>{let[t,s]=e;return`${t}: ${s}`})).join("\n"),i(m,j);return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(h,{path:s,method:r}),(0,a.jsx)(d,{headers:f,headersDescription:b}),(0,a.jsx)(c,{requestBody:m,requestBodyParams:g,addCommentsToJson:i}),(0,a.jsx)(l,{method:r,path:s,requestBody:m,headers:f}),(0,a.jsx)(u,{responseExample:x,responseComments:y,addCommentsToJson:i}),(0,a.jsx)(p,{errorHandling:w})]})}},8175:(e,t,s)=>{s.d(t,{A:()=>o});s(6540);var n=s(5872),r=s(4848);function o(){let e=(0,n.K)()();return["newoaks.ai","www.newoaks.ai","eu.newoaks.ai"].includes(e)&&(e="NewOaks AI"),"appointify.ai"===e&&(e="Appointify AI"),(0,r.jsx)("code",{children:e})}},3532:(e,t,s)=>{function n(){return function(e){if("undefined"==typeof window)return"";const t=window.location.hostname;let s="";return s="www.newoaks.ai"==t||"newoaks.ai"==t?"https://usapi.hottask.com":"eu.newoaks.ai"==t?"https://euapi.hottask.com":`https://${t}`,e?`${s}${e.startsWith("/")?e:`/${e}`}`:s}}s.d(t,{r:()=>n})},5872:(e,t,s)=>{function n(){return function(){return"undefined"==typeof window?"":window.location.hostname}}s.d(t,{K:()=>n})}}]);