[{"data":1,"prerenderedAt":725},["ShallowReactive",2],{"navigation_docs":3,"-ai-deploy-troubleshooting":315,"-ai-deploy-troubleshooting-surround":720},[4,30,87,208,252],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Getting Started","\u002Fgetting-started","1.getting-started",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-rocket",{"title":15,"path":16,"stem":17,"icon":18},"API","\u002Fgetting-started\u002Fapi-docs","1.getting-started\u002F2.api-docs","i-lucide-book-open-text",{"title":20,"path":21,"stem":22,"icon":23},"MCP","\u002Fgetting-started\u002Fmcp","1.getting-started\u002F3.mcp","i-lucide-bot",{"title":25,"path":26,"stem":27,"icon":28},"Smart Contract","\u002Fgetting-started\u002Fcontracts","1.getting-started\u002F5.contracts","i-lucide-clock",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Guides","\u002Fguides","2.guides",[35,72,82],{"title":36,"path":37,"stem":38,"children":39,"page":29},"Crypto","\u002Fguides\u002Fcrypto","2.guides\u002F1.crypto",[40,45,50,55,59,64,68],{"title":41,"path":42,"stem":43,"icon":44},"Belong CheckIn","\u002Fguides\u002Fcrypto\u002Fcheckin","2.guides\u002F1.crypto\u002FcheckIn","i-lucide-map-pin",{"title":46,"path":47,"stem":48,"icon":49},"EVM NFT Minting","\u002Fguides\u002Fcrypto\u002Fminting","2.guides\u002F1.crypto\u002Fminting","i-lucide-box",{"title":51,"path":52,"stem":53,"icon":54},"Sponsored Gas","\u002Fguides\u002Fcrypto\u002Fsponsorship","2.guides\u002F1.crypto\u002Fsponsorship","i-lucide-wallet",{"title":56,"path":57,"stem":58,"icon":49},"LONG Staking","\u002Fguides\u002Fcrypto\u002Fstaking","2.guides\u002F1.crypto\u002Fstaking",{"title":60,"path":61,"stem":62,"icon":63},"Starknet NFT Minting","\u002Fguides\u002Fcrypto\u002Fstarknet","2.guides\u002F1.crypto\u002Fstarknet","i-lucide-circuit-board",{"title":65,"path":66,"stem":67,"icon":49},"Sui NFT Minting","\u002Fguides\u002Fcrypto\u002Fsui","2.guides\u002F1.crypto\u002Fsui",{"title":69,"path":70,"stem":71,"icon":28},"LONG Vesting","\u002Fguides\u002Fcrypto\u002Fvesting","2.guides\u002F1.crypto\u002Fvesting",{"title":73,"path":74,"stem":75,"children":76,"page":29},"Media","\u002Fguides\u002Fmedia","2.guides\u002F2.media",[77],{"title":78,"path":79,"stem":80,"icon":81},"Media Upload","\u002Fguides\u002Fmedia\u002Fcollection","2.guides\u002F2.media\u002Fcollection","i-lucide-image",{"title":83,"path":84,"stem":85,"icon":86},"Whitelabel","\u002Fguides\u002Fwhitelabel","2.guides\u002F5.whitelabel","i-lucide-badge-check",{"title":41,"path":88,"stem":89,"children":90},"\u002Fbelong-checkin","3.belong-checkin",[91,94,99,104,109,114,118,123,127,132,137,171,175,180,185,189,194,199,203],{"title":92,"path":88,"stem":93,"icon":44},"Overview","3.belong-checkin\u002Findex",{"title":95,"path":96,"stem":97,"icon":98},"App Features","\u002Fbelong-checkin\u002Fapp-features","3.belong-checkin\u002F1.app-features","i-lucide-list-checks",{"title":100,"path":101,"stem":102,"icon":103},"Telegram Bot","\u002Fbelong-checkin\u002Ftelegram-bot","3.belong-checkin\u002F10.telegram-bot","i-lucide-send",{"title":105,"path":106,"stem":107,"icon":108},"Apple Wallet","\u002Fbelong-checkin\u002Fapple-wallet","3.belong-checkin\u002F11.apple-wallet","i-lucide-ticket",{"title":110,"path":111,"stem":112,"icon":113},"Payments","\u002Fbelong-checkin\u002Fpayments-and-onramp","3.belong-checkin\u002F12.payments-and-onramp","i-lucide-credit-card",{"title":51,"path":115,"stem":116,"icon":117},"\u002Fbelong-checkin\u002Fsponsored-gas","3.belong-checkin\u002F13.sponsored-gas","i-lucide-fuel",{"title":119,"path":120,"stem":121,"icon":122},"Fees & Staking","\u002Fbelong-checkin\u002Ffees-and-staking","3.belong-checkin\u002F14.fees-and-staking","i-lucide-percent",{"title":124,"path":125,"stem":126,"icon":23},"Connect AI Deploy","\u002Fbelong-checkin\u002Fconnect-ai-deploy","3.belong-checkin\u002F15.connect-ai-deploy",{"title":128,"path":129,"stem":130,"icon":131},"QR Signage Examples","\u002Fbelong-checkin\u002Fvenue-qr-signage-examples","3.belong-checkin\u002F16.venue-qr-signage-examples","i-lucide-qr-code",{"title":133,"path":134,"stem":135,"icon":136},"Whitepaper","\u002Fbelong-checkin\u002Fwhitepaper","3.belong-checkin\u002F18.whitepaper","i-lucide-file-text",{"title":138,"icon":139,"path":140,"stem":141,"children":142,"page":29},"Developer","i-lucide-code","\u002Fbelong-checkin\u002Fdeveloper","3.belong-checkin\u002F19.developer",[143,148,152,156,161,166],{"title":144,"path":145,"stem":146,"icon":147},"Integration Overview","\u002Fbelong-checkin\u002Fdeveloper\u002Fintegration-overview","3.belong-checkin\u002F19.developer\u002F1.integration-overview","i-lucide-plug",{"title":149,"path":150,"stem":151,"icon":18},"API Reference","\u002Fbelong-checkin\u002Fdeveloper\u002Fapi-reference","3.belong-checkin\u002F19.developer\u002F2.api-reference",{"title":153,"path":154,"stem":155,"icon":23},"MCP Tools","\u002Fbelong-checkin\u002Fdeveloper\u002Fmcp-tools","3.belong-checkin\u002F19.developer\u002F3.mcp-tools",{"title":157,"path":158,"stem":159,"icon":160},"Networks","\u002Fbelong-checkin\u002Fdeveloper\u002Fnetworks","3.belong-checkin\u002F19.developer\u002F4.networks","i-lucide-network",{"title":162,"path":163,"stem":164,"icon":165},"Enterprise Apps","\u002Fbelong-checkin\u002Fdeveloper\u002Fenterprise-whitelabel","3.belong-checkin\u002F19.developer\u002F5.enterprise-whitelabel","i-lucide-package",{"title":167,"path":168,"stem":169,"icon":170},"POS & Events","\u002Fbelong-checkin\u002Fdeveloper\u002Fwebhooks-and-pos","3.belong-checkin\u002F19.developer\u002F6.webhooks-and-pos","i-lucide-receipt",{"title":172,"path":173,"stem":174,"icon":131},"Check-In Modes","\u002Fbelong-checkin\u002Fcheck-in-modes","3.belong-checkin\u002F2.check-in-modes",{"title":176,"path":177,"stem":178,"icon":179},"Venue Quick Start","\u002Fbelong-checkin\u002Fvenue-quickstart","3.belong-checkin\u002F3.venue-quickstart","i-lucide-store",{"title":181,"path":182,"stem":183,"icon":184},"Customer Rewards","\u002Fbelong-checkin\u002Fcustomer_rewards_guide","3.belong-checkin\u002F4.customer_rewards_guide","i-lucide-gift",{"title":186,"path":187,"stem":188,"icon":54},"Promoter Earnings","\u002Fbelong-checkin\u002Fpromoter-earnings-guide","3.belong-checkin\u002F5.promoter-earnings-guide",{"title":190,"path":191,"stem":192,"icon":193},"Venue Partner","\u002Fbelong-checkin\u002Fvenue-partner","3.belong-checkin\u002F6.venue-partner","i-lucide-building",{"title":195,"path":196,"stem":197,"icon":198},"Event Creation","\u002Fbelong-checkin\u002Fevent-creation","3.belong-checkin\u002F7.event-creation","i-lucide-calendar-plus",{"title":200,"path":201,"stem":202,"icon":54},"Wallet & Sign-In","\u002Fbelong-checkin\u002Fwallet-and-auth","3.belong-checkin\u002F8.wallet-and-auth",{"title":204,"path":205,"stem":206,"icon":207},"AI & Voice","\u002Fbelong-checkin\u002Fai-and-voice","3.belong-checkin\u002F9.ai-and-voice","i-lucide-mic",{"title":209,"path":210,"stem":211,"children":212,"page":29},"MCP Cheat Sheet","\u002Fmcp","4.mcp",[213,216,220,224,228,232,236,240,244,248],{"title":92,"path":214,"stem":215,"icon":23},"\u002Fmcp\u002Foverview","4.mcp\u002Foverview",{"title":217,"path":218,"stem":219,"icon":23},"Addresses","\u002Fmcp\u002Ftools-addresses","4.mcp\u002Ftools-addresses",{"title":221,"path":222,"stem":223,"icon":23},"CheckIn","\u002Fmcp\u002Ftools-check-in","4.mcp\u002Ftools-check-In",{"title":225,"path":226,"stem":227,"icon":23},"Events","\u002Fmcp\u002Ftools-events","4.mcp\u002Ftools-events",{"title":229,"path":230,"stem":231,"icon":23},"Hubs","\u002Fmcp\u002Ftools-hubs","4.mcp\u002Ftools-hubs",{"title":233,"path":234,"stem":235,"icon":49},"Minting","\u002Fmcp\u002Ftools-minting","4.mcp\u002Ftools-minting",{"title":237,"path":238,"stem":239,"icon":23},"Notes","\u002Fmcp\u002Ftools-notes","4.mcp\u002Ftools-notes",{"title":241,"path":242,"stem":243,"icon":23},"Registration","\u002Fmcp\u002Ftools-registration","4.mcp\u002Ftools-registration",{"title":245,"path":246,"stem":247,"icon":23},"Starknet","\u002Fmcp\u002Ftools-starknet","4.mcp\u002Ftools-starknet",{"title":249,"path":250,"stem":251,"icon":28},"Vesting","\u002Fmcp\u002Ftools-vesting","4.mcp\u002Ftools-vesting",{"title":253,"icon":13,"path":254,"stem":255,"children":256,"page":29},"Belong AI Deploy","\u002Fai-deploy","5.ai-deploy",[257,260,265,270,275,295,300,305,310],{"title":92,"path":258,"stem":259,"icon":13},"\u002Fai-deploy\u002Foverview","5.ai-deploy\u002F1.overview",{"title":261,"path":262,"stem":263,"icon":264},"Quick Start","\u002Fai-deploy\u002Fquickstart","5.ai-deploy\u002F2.quickstart","i-lucide-zap",{"title":266,"path":267,"stem":268,"icon":269},"Cloud Providers","\u002Fai-deploy\u002Fcloud-providers","5.ai-deploy\u002F3.cloud-providers","i-lucide-cloud",{"title":271,"path":272,"stem":273,"icon":274},"AI Providers","\u002Fai-deploy\u002Fai-providers","5.ai-deploy\u002F4.ai-providers","i-lucide-brain",{"title":276,"icon":277,"path":278,"stem":279,"children":280,"page":29},"Channels","i-lucide-messages-square","\u002Fai-deploy\u002Fchannels","5.ai-deploy\u002F5.channels",[281,285,290],{"title":282,"path":283,"stem":284,"icon":103},"Telegram","\u002Fai-deploy\u002Fchannels\u002Ftelegram","5.ai-deploy\u002F5.channels\u002F1.telegram",{"title":286,"path":287,"stem":288,"icon":289},"WhatsApp","\u002Fai-deploy\u002Fchannels\u002Fwhatsapp","5.ai-deploy\u002F5.channels\u002F2.whatsapp","i-lucide-message-circle",{"title":291,"path":292,"stem":293,"icon":294},"Slack","\u002Fai-deploy\u002Fchannels\u002Fslack","5.ai-deploy\u002F5.channels\u002F3.slack","i-lucide-hash",{"title":296,"path":297,"stem":298,"icon":299},"Private Access","\u002Fai-deploy\u002Fprivate-access","5.ai-deploy\u002F6.private-access","i-lucide-shield",{"title":301,"path":302,"stem":303,"icon":304},"Troubleshooting","\u002Fai-deploy\u002Ftroubleshooting","5.ai-deploy\u002F7.troubleshooting","i-lucide-wrench",{"title":306,"path":307,"stem":308,"icon":309},"Enterprise & API","\u002Fai-deploy\u002Fenterprise-api","5.ai-deploy\u002F8.enterprise-api","i-lucide-server-cog",{"title":311,"path":312,"stem":313,"icon":314},"OVHcloud","\u002Fai-deploy\u002Fovhcloud","5.ai-deploy\u002F9.ovhcloud","i-lucide-cloud-cog",{"id":316,"title":301,"body":317,"description":713,"extension":714,"links":715,"meta":716,"navigation":717,"path":302,"seo":718,"stem":303,"__hash__":719},"docs\u002F5.ai-deploy\u002F7.troubleshooting.md",{"type":318,"value":319,"toc":682},"minimark",[320,324,328,332,337,350,354,370,374,391,395,415,419,431,435,453,457,491,495,528,532,549,553,557,568,572,583,587,591,602,606,610,625,629,646,650,654,661,664,667],[321,322,301],"h2",{"id":323},"troubleshooting",[325,326,327],"p",{},"Common issues and how to fix them.",[321,329,331],{"id":330},"deployment-issues","Deployment issues",[333,334,336],"h3",{"id":335},"server-creation-timed-out","\"Server creation timed out\"",[338,339,340,344,347],"ul",{},[341,342,343],"li",{},"Check your cloud provider's dashboard to see whether the server was created",[341,345,346],{},"Your account may have hit a resource limit — check your provider's limits",[341,348,349],{},"Try a different region",[333,351,353],{"id":352},"cloud-init-took-too-long","\"Cloud-init took too long\"",[338,355,356,359,367],{},[341,357,358],{},"The server is still installing its runtime",[341,360,361,362,366],{},"Wait a few more minutes and check the ",[363,364,365],"strong",{},"Technical details"," in the progress screen",[341,368,369],{},"The deployment streams logs there throughout setup",[333,371,373],{"id":372},"stack-deployment-failed","\"Stack deployment failed\"",[338,375,376,382],{},[341,377,378,379,381],{},"Open the ",[363,380,365],{}," log in the wizard to see which step failed",[341,383,384,385,390],{},"A redeploy from a clean state is usually the fastest fix — see ",[386,387,389],"a",{"href":388},"#full-redeployment","Full redeployment"," below",[333,392,394],{"id":393},"ovhcloud-rejected-these-credentials","\"OVHcloud rejected these credentials\"",[396,397,398,401,404,407],"ol",{},[341,399,400],{},"Confirm the wizard account endpoint matches the site where the API token was created",[341,402,403],{},"Use the Public Cloud API service name, not the editable project display name",[341,405,406],{},"Confirm the consumer key includes the required project and instance rules",[341,408,409,410,414],{},"Follow ",[386,411,413],{"href":412},"\u002Fai-deploy\u002Fovhcloud#troubleshooting","Deploy with OVHcloud"," to create a replacement restricted token",[321,416,418],{"id":417},"connection-issues","Connection issues",[325,420,421,422,425,426,430],{},"Private-by-default deployments do ",[363,423,424],{},"not"," expose internal app ports to the internet. DigitalOcean, Google Cloud, and OVHcloud deployments open public ",[427,428,429],"code",{},"443"," only when a selected channel requires inbound webhook delivery. Telegram stays private and uses outbound polling. Other providers need a separate HTTPS entrypoint.",[333,432,434],{"id":433},"cant-access-the-dashboard","\"Can't access the dashboard\"",[396,436,437,444,447],{},[341,438,439,440,443],{},"Make sure ",[386,441,442],{"href":297},"Tailscale"," is running on your device",[341,445,446],{},"Check that both your device and the server are on the same Tailscale network",[341,448,449,450],{},"Try the Tailscale IP directly: ",[427,451,452],{},"http:\u002F\u002F100.x.x.x:3000",[333,454,456],{"id":455},"telegram-bot-not-responding","\"Telegram bot not responding\"",[396,458,459,472,479,482,485],{},[341,460,378,461,464,465,468,469],{},[363,462,463],{},"management dashboard"," first (",[427,466,467],{},"http:\u002F\u002F\u003Ctailscale-ip>:3000",") and go to ",[363,470,471],{},"Connect AI & Messengers",[341,473,474,475,478],{},"Use the ",[363,476,477],{},"Agent"," selector to choose the right agent",[341,480,481],{},"Confirm Telegram shows as configured there",[341,483,484],{},"If the bot is already replying in chat, ask it to connect the missing provider there instead of pasting secrets",[341,486,487,488],{},"Verify the bot token works: visit ",[427,489,490],{},"https:\u002F\u002Fapi.telegram.org\u002FbotYOUR_TOKEN\u002FgetMe",[333,492,494],{"id":493},"pairing-required-in-the-agent-ui","\"Pairing required\" in the agent UI",[396,496,497,509,514,521],{},[341,498,499,500,502,503,506,507],{},"Return to the ",[363,501,463],{}," (",[427,504,505],{},":3000",") and run setup from ",[363,508,471],{},[341,510,474,511,513],{},[363,512,477],{}," selector to choose the affected agent",[341,515,516,517,520],{},"If shown, click ",[363,518,519],{},"Fix Pairing Automatically"," in the setup checklist",[341,522,523,524,527],{},"If pairing still fails, restart the agent from the ",[363,525,526],{},"Agents"," page",[333,529,531],{"id":530},"whatsapp-webhook-verification-failed","\"WhatsApp webhook verification failed\"",[396,533,534,537,543],{},[341,535,536],{},"Double-check the callback URL in Meta's developer console",[341,538,539,540],{},"Verify the verify token matches the value shown in ",[363,541,542],{},"Dashboard → Connect AI & Messengers → WhatsApp",[341,544,545,546],{},"Make sure your HTTPS entrypoint forwards to ",[427,547,548],{},"\u002Fwebhook\u002Fwhatsapp\u002FYOUR_DEPLOY_ID",[321,550,552],{"id":551},"ai-provider-issues","AI provider issues",[333,554,556],{"id":555},"oauth-token-expired","\"OAuth token expired\"",[338,558,559,562],{},[341,560,561],{},"Your agent automatically refreshes OAuth tokens",[341,563,564,565,567],{},"If refresh fails, reconnect from chat by asking the bot to connect ChatGPT or Claude again, or use ",[363,566,471],{}," in the dashboard",[333,569,571],{"id":570},"api-key-invalid","\"API key invalid\"",[338,573,574,577,580],{},[341,575,576],{},"Verify the key at the provider's dashboard",[341,578,579],{},"Check whether the key was revoked or expired",[341,581,582],{},"Update the key from chat (if the bot is live) or in your agent's dashboard settings",[584,585,586],"note",{},"For ChatGPT or Claude browser sign-in, don't paste OAuth bearer tokens as API keys. Reconnect by asking the bot to connect the provider, copy the sign-in link into Safari, Chrome, or your normal desktop browser, and paste the code it shows back to the bot.",[333,588,590],{"id":589},"model-not-available","\"Model not available\"",[338,592,593,596,599],{},[341,594,595],{},"Your subscription plan may not include the default model",[341,597,598],{},"The agent automatically falls back to the next best model",[341,600,601],{},"You can manually select a different model in dashboard settings",[321,603,605],{"id":604},"performance-issues","Performance issues",[333,607,609],{"id":608},"agent-responding-slowly","\"Agent responding slowly\"",[338,611,612,619,622],{},[341,613,614,615],{},"Consider upgrading to a larger ",[386,616,618],{"href":617},"\u002Fai-deploy\u002Fcloud-providers#server-sizes","server size",[341,620,621],{},"Reduce the number of agents if you're running several",[341,623,624],{},"Check your AI provider's status page for outages",[333,626,628],{"id":627},"database-running-out-of-space","\"Database running out of space\"",[338,630,631,637,643],{},[341,632,633,634],{},"Enable conversation pruning in ",[363,635,636],{},"Dashboard → Settings",[341,638,639,640],{},"Run a manual cleanup with ",[363,641,642],{},"Settings → Clean up now",[341,644,645],{},"Resize the server's disk via your cloud provider",[321,647,649],{"id":648},"recovering-from-errors","Recovering from errors",[333,651,653],{"id":652},"restart-a-single-agent","Restart a single agent",[325,655,656,657,660],{},"From the master dashboard, find the agent card and click ",[363,658,659],{},"Restart",".",[333,662,389],{"id":663},"full-redeployment",[325,665,666],{},"If things are severely broken, tear down and redeploy:",[396,668,669,672,679],{},[341,670,671],{},"Go to the wizard",[341,673,674,675,678],{},"Click ",[363,676,677],{},"Destroy"," on your existing deployment",[341,680,681],{},"Re-run the wizard",{"title":683,"searchDepth":684,"depth":684,"links":685},"",2,[686,687,694,700,705,709],{"id":323,"depth":684,"text":301},{"id":330,"depth":684,"text":331,"children":688},[689,691,692,693],{"id":335,"depth":690,"text":336},3,{"id":352,"depth":690,"text":353},{"id":372,"depth":690,"text":373},{"id":393,"depth":690,"text":394},{"id":417,"depth":684,"text":418,"children":695},[696,697,698,699],{"id":433,"depth":690,"text":434},{"id":455,"depth":690,"text":456},{"id":493,"depth":690,"text":494},{"id":530,"depth":690,"text":531},{"id":551,"depth":684,"text":552,"children":701},[702,703,704],{"id":555,"depth":690,"text":556},{"id":570,"depth":690,"text":571},{"id":589,"depth":690,"text":590},{"id":604,"depth":684,"text":605,"children":706},[707,708],{"id":608,"depth":690,"text":609},{"id":627,"depth":690,"text":628},{"id":648,"depth":684,"text":649,"children":710},[711,712],{"id":652,"depth":690,"text":653},{"id":663,"depth":690,"text":389},"Common Belong AI Deploy issues and how to fix them.","md",null,{},{"title":301,"icon":304},{"title":301,"description":713},"JVlh-CS0ev1LS3dj_IKfDnk8lvUDhS6HRh6EbA8VK6s",[721,723],{"title":296,"path":297,"stem":298,"description":722,"icon":299,"children":-1},"Reach your agent's dashboard securely over a private Tailscale network — never the public internet.",{"title":306,"path":307,"stem":308,"description":724,"icon":309,"children":-1},"Deploy and manage AI Deploy agents programmatically with the REST API or MCP server.",1785598152140]