[{"data":1,"prerenderedAt":133},["ShallowReactive",2],{"pseo:errors:channel-not-connected":3,"highlight:error:channel-not-connected":127},{"cause":4,"code":5,"example":6,"faqs":10,"feature":17,"fix_steps":21,"http_status":25,"message":8,"protocol_aliases":26,"raised_by":29,"related":67,"retryable":106,"seo":107,"slug":124,"tier":125,"title":126,"updated":122,"url":118},"The channel exists but its WhatsApp session is not currently linked, so nothing can be sent or read. This happens after a fresh channel is created and before pairing, when the phone unlinks the device from its linked-devices screen, when WhatsApp drops a device that has not seen its phone for around two weeks, and briefly while a session restarts. The details.status field carries the current session state.","channel_not_connected",{"error":7},{"code":5,"message":8,"request_id":9},"The channel is not connected.","req_01JRQ8F4X9N2K7YB3C5V6W8H0T",[11,14],{"a":12,"q":13},"If the status says the session is starting, a short backoff of a few seconds is reasonable and the call will usually succeed. If it says logged out, no amount of waiting helps - a human has to pair the number again. Branch on the status rather than retrying blindly.","How long should I wait before retrying?",{"a":15,"q":16},"Linked devices are tied to a phone that must come online periodically. If the phone stays offline for roughly two weeks the device is dropped. Keep the phone charged and on a network, and act on the reminders Wapito sends before the deadline rather than after it.","Why does WhatsApp unlink a number that was working fine?",{"name":18,"slug":19,"url":20},"Connect a Number","connect-number-qr-pairing","\u002Fwhatsapp-api\u002Fconnect-number-qr-pairing\u002F",[22,23,24],"Read details.status and the channel status endpoint before retrying - the remedy differs for a session that is starting and one that was logged out.","If the state is waiting for pairing, request a pairing code and enter it on the phone; QR remains available as a fallback.","Subscribe to the channel webhook so your system learns about a disconnect within seconds instead of discovering it on the next send.",409,[27,28],"WAHA session STOPPED","ErrNotLoggedIn",[30,39,46,52,61],{"availability":31,"ban_risk":32,"method":33,"operationId":34,"path":35,"summary":36,"tag":37,"url":38},"ga","medium","POST","sendText","\u002Fmessages\u002Ftext","Send a text message","messages","\u002Fdocs\u002Fapi\u002Fmessages\u002Fsend-text\u002F",{"availability":31,"ban_risk":40,"method":33,"operationId":41,"path":42,"summary":43,"tag":44,"url":45},"high","createGroup","\u002Fgroups","Create a group","groups","\u002Fdocs\u002Fapi\u002Fgroups\u002Fcreate-group\u002F",{"availability":31,"ban_risk":32,"method":33,"operationId":47,"path":48,"summary":49,"tag":50,"url":51},"postTextStory","\u002Fstories\u002Ftext","Post a text status","stories","\u002Fdocs\u002Fapi\u002Fstories\u002Fpost-text-story\u002F",{"availability":53,"ban_risk":54,"method":55,"operationId":56,"path":57,"summary":58,"tag":59,"url":60},"beta","low","GET","listChats","\u002Fchats","List chats","chats","\u002Fdocs\u002Fapi\u002Fchats\u002Flist-chats\u002F",{"availability":31,"ban_risk":54,"method":33,"operationId":62,"path":63,"summary":64,"tag":65,"url":66},"setMyPresence","\u002Fpresence\u002Fme","Set the channel online or offline","presence","\u002Fdocs\u002Fapi\u002Fpresence\u002Fset-my-presence\u002F",{"glossary":68,"hub":78,"operations":79,"pillar":20,"siblings":90},[69,72,75],{"title":70,"url":71},"Pairing code","\u002Fglossary\u002Fpairing-code\u002F",{"title":73,"url":74},"QR linking","\u002Fglossary\u002Fqr-linking\u002F",{"title":76,"url":77},"Session","\u002Fglossary\u002Fsession\u002F","\u002Fdocs\u002Ferrors\u002F",[80,82,84,86,88],{"title":81,"url":38},"POST \u002Fmessages\u002Ftext",{"title":83,"url":45},"POST \u002Fgroups",{"title":85,"url":51},"POST \u002Fstories\u002Ftext",{"title":87,"url":60},"GET \u002Fchats",{"title":89,"url":66},"POST \u002Fpresence\u002Fme",[91,94,97,100,103],{"title":92,"url":93},"channel_not_in_qr_state (409)","\u002Fdocs\u002Ferrors\u002Fchannel-not-in-qr-state\u002F",{"title":95,"url":96},"business_account_required (409)","\u002Fdocs\u002Ferrors\u002Fbusiness-account-required\u002F",{"title":98,"url":99},"payload_too_large (413)","\u002Fdocs\u002Ferrors\u002Fpayload-too-large\u002F",{"title":101,"url":102},"not_found (404)","\u002Fdocs\u002Ferrors\u002Fnot-found\u002F",{"title":104,"url":105},"not_on_whatsapp (404)","\u002Fdocs\u002Ferrors\u002Fnot-on-whatsapp\u002F",true,{"breadcrumb":108,"canonical":119,"description":120,"h1":121,"lastmod":122,"title":123},[109,112,115,117],{"name":110,"url":111},"Home","\u002F",{"name":113,"url":114},"Docs","\u002Fdocs\u002F",{"name":116,"url":78},"Errors",{"name":5,"url":118},"\u002Fdocs\u002Ferrors\u002Fchannel-not-connected\u002F","https:\u002F\u002Fwapito.com\u002Fdocs\u002Ferrors\u002Fchannel-not-connected\u002F","409 channel_not_connected: The channel is not connected. The channel exists but its WhatsApp session is not currently linked, so nothing can be sent or read.","channel_not_connected — Channel not connected","2026-09-15","channel_not_connected (409): Channel not connected | Wapito","channel-not-connected","t8","Channel not connected",[128],{"label":129,"id":130,"lang":130,"code":131,"html":132},"JSON","json","{\n  \"error\": {\n    \"code\": \"channel_not_connected\",\n    \"message\": \"The channel is not connected.\",\n    \"request_id\": \"req_01JRQ8F4X9N2K7YB3C5V6W8H0T\"\n  }\n}","\u003Cpre class=\"shiki shiki-themes github-light-default github-dark-default\" style=\"background-color:#ffffff;--shiki-dark-bg:#0d1117;color:#1f2328;--shiki-dark:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#116329;--shiki-dark:#7EE787\">  \"error\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#116329;--shiki-dark:#7EE787\">    \"code\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"channel_not_connected\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#116329;--shiki-dark:#7EE787\">    \"message\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"The channel is not connected.\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#116329;--shiki-dark:#7EE787\">    \"request_id\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"req_01JRQ8F4X9N2K7YB3C5V6W8H0T\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1790464915674]