[{"data":1,"prerenderedAt":103},["ShallowReactive",2],{"pseo:errors:channel-not-in-qr-state":3,"highlight:error:channel-not-in-qr-state":97},{"cause":4,"code":5,"example":6,"faqs":10,"feature":17,"fix_steps":21,"http_status":25,"message":8,"protocol_aliases":26,"raised_by":27,"related":43,"retryable":76,"seo":77,"slug":94,"tier":95,"title":96,"updated":92,"url":88},"You asked for a QR image or a pairing code while the channel was in some other state. A QR is only meaningful during the short window when the session is waiting to be linked. If the channel is already connected there is nothing to scan, and if it is still starting up the engine has not produced a code yet. Polling this endpoint on a loop is the usual way to meet this error.","channel_not_in_qr_state",{"error":7},{"code":5,"message":8,"request_id":9},"The channel is not waiting for a QR scan.","req_01JRQ8F4X9N2K7YB3C5V6W8H0T",[11,14],{"a":12,"q":13},"Once every two or three seconds is plenty, with a hard stop after a minute or two. Codes expire quickly and a tight polling loop only produces this error faster. Better still, listen to the channel webhook, which pushes each state change as it happens.","How often should I poll while waiting for a code?",{"a":15,"q":16},"Not while this channel holds the session. WhatsApp allows several linked devices for one phone, but a Wapito channel owns one of those slots. Log out of this channel to release the slot, or create a separate channel if you genuinely need two.","Can I get a pairing code for a number already linked elsewhere?",{"name":18,"slug":19,"url":20},"Connect a Number","connect-number-qr-pairing","\u002Fwhatsapp-api\u002Fconnect-number-qr-pairing\u002F",[22,23,24],"Poll the channel status endpoint and only ask for a QR or pairing code once the state says the session is waiting to be linked.","If the channel is already connected and you want to relink a different phone, log the channel out first and then pair again.","Prefer the pairing code over the QR: new QR links have been unreliable across engines since mid-2026, and a code typed on the phone is more robust.",409,[],[28,37],{"availability":29,"ban_risk":30,"method":31,"operationId":32,"path":33,"summary":34,"tag":35,"url":36},"ga","low","GET","getChannelQr","\u002Fchannel\u002Fqr","Get the pairing QR code","channel","\u002Fdocs\u002Fapi\u002Fchannel\u002Fget-channel-qr\u002F",{"availability":29,"ban_risk":30,"method":38,"operationId":39,"path":40,"summary":41,"tag":35,"url":42},"POST","createPairingCode","\u002Fchannel\u002Fpairing-code","Request a pairing code for a number","\u002Fdocs\u002Fapi\u002Fchannel\u002Fcreate-pairing-code\u002F",{"glossary":44,"hub":54,"operations":55,"pillar":20,"siblings":60},[45,48,51],{"title":46,"url":47},"Pairing code","\u002Fglossary\u002Fpairing-code\u002F",{"title":49,"url":50},"QR linking","\u002Fglossary\u002Fqr-linking\u002F",{"title":52,"url":53},"Session","\u002Fglossary\u002Fsession\u002F","\u002Fdocs\u002Ferrors\u002F",[56,58],{"title":57,"url":36},"GET \u002Fchannel\u002Fqr",{"title":59,"url":42},"POST \u002Fchannel\u002Fpairing-code",[61,64,67,70,73],{"title":62,"url":63},"channel_not_connected (409)","\u002Fdocs\u002Ferrors\u002Fchannel-not-connected\u002F",{"title":65,"url":66},"business_account_required (409)","\u002Fdocs\u002Ferrors\u002Fbusiness-account-required\u002F",{"title":68,"url":69},"payload_too_large (413)","\u002Fdocs\u002Ferrors\u002Fpayload-too-large\u002F",{"title":71,"url":72},"not_found (404)","\u002Fdocs\u002Ferrors\u002Fnot-found\u002F",{"title":74,"url":75},"not_on_whatsapp (404)","\u002Fdocs\u002Ferrors\u002Fnot-on-whatsapp\u002F",true,{"breadcrumb":78,"canonical":89,"description":90,"h1":91,"lastmod":92,"title":93},[79,82,85,87],{"name":80,"url":81},"Home","\u002F",{"name":83,"url":84},"Docs","\u002Fdocs\u002F",{"name":86,"url":54},"Errors",{"name":5,"url":88},"\u002Fdocs\u002Ferrors\u002Fchannel-not-in-qr-state\u002F","https:\u002F\u002Fwapito.com\u002Fdocs\u002Ferrors\u002Fchannel-not-in-qr-state\u002F","409 channel_not_in_qr_state: The channel is not waiting for a QR scan. You asked for a QR image or a pairing code while the channel was in some other state.","channel_not_in_qr_state — Not waiting for a QR","2026-09-15","channel_not_in_qr_state (409): Not waiting for a QR | Wapito","channel-not-in-qr-state","t8","Not waiting for a QR",[98],{"label":99,"id":100,"lang":100,"code":101,"html":102},"JSON","json","{\n  \"error\": {\n    \"code\": \"channel_not_in_qr_state\",\n    \"message\": \"The channel is not waiting for a QR scan.\",\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_in_qr_state\"\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 waiting for a QR scan.\"\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>",1790464915689]