[{"data":1,"prerenderedAt":77},["ShallowReactive",2],{"pseo:glossary:qr-linking":3,"highlight:glossary:qr-linking":71},{"definition":4,"explanation":5,"in_wapito":6,"official_note":9,"question":10,"related":11,"related_operations":37,"seo":55,"slug":69,"term":63,"tier":70,"updated":67,"url":64},"QR linking is the original way to attach a companion device: the engine renders a QR code, the phone's owner scans it from the linked-devices screen, and the device is added. Wapito still offers it, but it is the fallback path rather than the recommended one.","The QR encodes a short-lived handshake, which is why the image refreshes every twenty seconds or so and why a screenshot sent over chat is almost always stale by the time it arrives. In a hosted setup the QR has to travel from the server to whoever is holding the phone, and every hop adds delay that the refresh window does not forgive. Since mid-2026 there has been an additional, harder problem: linking brand-new devices by QR has been failing intermittently across the main engine libraries, with the phone reporting a registration refresh error rather than completing the link. That is why Wapito leads with pairing codes and keeps QR as a secondary route. If you do build a QR flow, stream the image to the browser and re-render on every refresh rather than caching it, show a visible countdown so the user knows why it changed, and fall back to a pairing code automatically after a couple of failed attempts rather than letting someone scan a dead code repeatedly.",{"example":7,"field":8},"{\"qr\": \"data:image\u002Fpng;base64,iVBORw0KGgo...\", \"expires_in\": 20}","qr","The Cloud API has no QR step. Meta hosts the number itself, so there is no companion device to link and nothing to scan.","What is QR linking on WhatsApp?",{"features":12,"hub":16,"operations":17,"terms":27},[13],{"title":14,"url":15},"Connect a Number","\u002Fwhatsapp-api\u002Fconnect-number-qr-pairing\u002F","\u002Fglossary\u002F",[18,21,24],{"title":19,"url":20},"GET \u002Fchannel\u002Fqr","\u002Fdocs\u002Fapi\u002Fchannel\u002Fget-channel-qr\u002F",{"title":22,"url":23},"POST \u002Fchannel\u002Fpairing-code","\u002Fdocs\u002Fapi\u002Fchannel\u002Fcreate-pairing-code\u002F",{"title":25,"url":26},"GET \u002Fchannel","\u002Fdocs\u002Fapi\u002Fchannel\u002Fget-channel\u002F",[28,31,34],{"title":29,"url":30},"Pairing code","\u002Fglossary\u002Fpairing-code\u002F",{"title":32,"url":33},"Session","\u002Fglossary\u002Fsession\u002F",{"title":35,"url":36},"Channel","\u002Fglossary\u002Fchannel\u002F",[38,46,51],{"availability":39,"ban_risk":40,"method":41,"operationId":42,"path":43,"summary":44,"tag":45,"url":20},"ga","low","GET","getChannelQr","\u002Fchannel\u002Fqr","Get the pairing QR code","channel",{"availability":39,"ban_risk":40,"method":47,"operationId":48,"path":49,"summary":50,"tag":45,"url":23},"POST","createPairingCode","\u002Fchannel\u002Fpairing-code","Request a pairing code for a number",{"availability":39,"ban_risk":40,"method":41,"operationId":52,"path":53,"summary":54,"tag":45,"url":26},"getChannel","\u002Fchannel","Get channel status and settings",{"breadcrumb":56,"canonical":65,"description":66,"h1":10,"lastmod":67,"title":68},[57,60,62],{"name":58,"url":59},"Home","\u002F",{"name":61,"url":16},"Glossary",{"name":63,"url":64},"QR linking","\u002Fglossary\u002Fqr-linking\u002F","https:\u002F\u002Fwapito.com\u002Fglossary\u002Fqr-linking\u002F","QR linking is the original way to attach a companion device: the engine renders a QR code, the phone's owner scans it from the linked-devices screen, and the…","2026-09-15","What is QR linking on WhatsApp? | Wapito Glossary","qr-linking","t9",[72],{"label":73,"id":74,"lang":74,"code":75,"html":76},"JSON","json","{\n  \"qr\": \"data:image\u002Fpng;base64,iVBORw0KGgo...\",\n  \"expires_in\": 20\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\">  \"qr\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"data:image\u002Fpng;base64,iVBORw0KGgo...\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#116329;--shiki-dark:#7EE787\">  \"expires_in\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">20\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1790464916268]