[{"data":1,"prerenderedAt":381},["ShallowReactive",2],{"navigation_docs":3,"-api-reference-limits-and-errors":67,"-api-reference-limits-and-errors-surround":378},[4,41],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":40},"Getting started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15,20,25,30,35],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F2.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"Authentication","\u002Fgetting-started\u002Fauthentication","1.getting-started\u002F3.authentication","i-lucide-key-round",{"title":21,"path":22,"stem":23,"icon":24},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F4.quickstart","i-lucide-zap",{"title":26,"path":27,"stem":28,"icon":29},"Base URL","\u002Fgetting-started\u002Fbase-url","1.getting-started\u002F5.base-url","i-lucide-server",{"title":31,"path":32,"stem":33,"icon":34},"Responses","\u002Fgetting-started\u002Fresponses","1.getting-started\u002F6.responses","i-lucide-braces",{"title":36,"path":37,"stem":38,"icon":39},"Troubleshooting","\u002Fgetting-started\u002Ftroubleshooting","1.getting-started\u002F7.troubleshooting","i-lucide-circle-help",false,{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":40},"API reference","i-lucide-book-open","\u002Fapi-reference","2.api-reference",[47,52,57,62],{"title":48,"path":49,"stem":50,"icon":51},"Sessions","\u002Fapi-reference\u002Fsessions","2.api-reference\u002F1.sessions","i-lucide-smartphone",{"title":53,"path":54,"stem":55,"icon":56},"Messages","\u002Fapi-reference\u002Fmessages","2.api-reference\u002F2.messages","i-lucide-message-square",{"title":58,"path":59,"stem":60,"icon":61},"Webhooks","\u002Fapi-reference\u002Fwebhooks","2.api-reference\u002F3.webhooks","i-lucide-webhook",{"title":63,"path":64,"stem":65,"icon":66},"Limits and errors","\u002Fapi-reference\u002Flimits-and-errors","2.api-reference\u002F4.limits-and-errors","i-lucide-shield-alert",{"id":68,"title":63,"body":69,"description":369,"extension":370,"links":371,"meta":372,"navigation":373,"path":64,"seo":374,"stem":65,"__hash__":377},"docs\u002F2.api-reference\u002F4.limits-and-errors.md",{"type":70,"value":71,"toc":362},"minimark",[72,76,81,84,87,218,222,225,228,232,235,254,258,261,326,330,333,355,358],[73,74,75],"p",{},"ChatKazi keeps API keys, sessions, usage, and limits scoped to your account.",[77,78,80],"h2",{"id":79},"api-hit-limits","API hit limits",[73,82,83],{},"Every authenticated API request counts toward your monthly API hit limit.",[73,85,86],{},"When the limit is reached, ChatKazi returns:",[88,89,95],"pre",{"className":90,"code":91,"filename":92,"language":93,"meta":94,"style":94},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"error\": \"Payment Required\",\n  \"message\": \"Monthly API hit limit reached. Upgrade your plan to continue.\",\n  \"usage\": {\n    \"current\": 1000,\n    \"limit\": 1000\n  }\n}\n","402 Response","json","",[96,97,98,107,135,156,171,191,206,212],"code",{"__ignoreMap":94},[99,100,103],"span",{"class":101,"line":102},"line",1,[99,104,106],{"class":105},"sMK4o","{\n",[99,108,110,113,117,120,123,126,130,132],{"class":101,"line":109},2,[99,111,112],{"class":105},"  \"",[99,114,116],{"class":115},"spNyl","error",[99,118,119],{"class":105},"\"",[99,121,122],{"class":105},":",[99,124,125],{"class":105}," \"",[99,127,129],{"class":128},"sfazB","Payment Required",[99,131,119],{"class":105},[99,133,134],{"class":105},",\n",[99,136,138,140,143,145,147,149,152,154],{"class":101,"line":137},3,[99,139,112],{"class":105},[99,141,142],{"class":115},"message",[99,144,119],{"class":105},[99,146,122],{"class":105},[99,148,125],{"class":105},[99,150,151],{"class":128},"Monthly API hit limit reached. Upgrade your plan to continue.",[99,153,119],{"class":105},[99,155,134],{"class":105},[99,157,159,161,164,166,168],{"class":101,"line":158},4,[99,160,112],{"class":105},[99,162,163],{"class":115},"usage",[99,165,119],{"class":105},[99,167,122],{"class":105},[99,169,170],{"class":105}," {\n",[99,172,174,177,181,183,185,189],{"class":101,"line":173},5,[99,175,176],{"class":105},"    \"",[99,178,180],{"class":179},"sBMFI","current",[99,182,119],{"class":105},[99,184,122],{"class":105},[99,186,188],{"class":187},"sbssI"," 1000",[99,190,134],{"class":105},[99,192,194,196,199,201,203],{"class":101,"line":193},6,[99,195,176],{"class":105},[99,197,198],{"class":179},"limit",[99,200,119],{"class":105},[99,202,122],{"class":105},[99,204,205],{"class":187}," 1000\n",[99,207,209],{"class":101,"line":208},7,[99,210,211],{"class":105},"  }\n",[99,213,215],{"class":101,"line":214},8,[99,216,217],{"class":105},"}\n",[77,219,221],{"id":220},"instance-limits","Instance limits",[73,223,224],{},"Each plan controls how many WhatsApp sessions you can connect.",[73,226,227],{},"If you reach your instance limit, session creation fails with a clear upgrade message.",[77,229,231],{"id":230},"message-failures","Message failures",[73,233,234],{},"Message failures are recorded in usage logs. Common causes include:",[236,237,238,242,245,248,251],"ul",{},[239,240,241],"li",{},"Session is not connected.",[239,243,244],{},"Recipient number is invalid.",[239,246,247],{},"Your account has reached plan limits.",[239,249,250],{},"Media URL is not publicly reachable.",[239,252,253],{},"WhatsApp rejected the send.",[77,255,257],{"id":256},"safe-retry-behavior","Safe retry behavior",[73,259,260],{},"Retry only after checking the error type.",[262,263,264,280],"table",{},[265,266,267],"thead",{},[268,269,270,274,277],"tr",{},[271,272,273],"th",{},"Error",[271,275,276],{},"Retry?",[271,278,279],{},"Notes",[281,282,283,295,305,315],"tbody",{},[268,284,285,289,292],{},[286,287,288],"td",{},"Missing API key",[286,290,291],{},"No",[286,293,294],{},"Fix authentication first.",[268,296,297,300,302],{},[286,298,299],{},"Plan limit reached",[286,301,291],{},[286,303,304],{},"Upgrade or wait for reset.",[268,306,307,310,312],{},[286,308,309],{},"Session disconnected",[286,311,291],{},[286,313,314],{},"Reconnect the WhatsApp session.",[268,316,317,320,323],{},[286,318,319],{},"Temporary server error",[286,321,322],{},"Yes",[286,324,325],{},"Retry with backoff.",[77,327,329],{"id":328},"recommended-logging","Recommended logging",[73,331,332],{},"Log these fields in your own backend:",[236,334,335,338,343,346,349,352],{},[239,336,337],{},"Request endpoint",[239,339,340],{},[96,341,342],{},"sessionId",[239,344,345],{},"Recipient phone number",[239,347,348],{},"ChatKazi response status",[239,350,351],{},"ChatKazi response message",[239,353,354],{},"Your customer, order, or workflow reference",[73,356,357],{},"Do not log full API keys or sensitive customer message bodies unless your own compliance policy allows it.",[359,360,361],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":94,"searchDepth":109,"depth":109,"links":363},[364,365,366,367,368],{"id":79,"depth":109,"text":80},{"id":220,"depth":109,"text":221},{"id":230,"depth":109,"text":231},{"id":256,"depth":109,"text":257},{"id":328,"depth":109,"text":329},"Handle usage limits and failed requests.","md",null,{},{"icon":66},{"title":375,"description":376},"ChatKazi limits and errors","Understand ChatKazi plan limits, session limits, and error handling.","ku-ax01z8kzYsNLi0OlT06kdYHVa0Gmq_aYTcMHgsMg",[379,371],{"title":58,"path":59,"stem":60,"description":380,"icon":61,"children":-1},"Receive inbound WhatsApp messages and verify webhook signatures.",1784048139989]