[{"data":1,"prerenderedAt":77},["ShallowReactive",2],{"pseo:glossary:session":3,"highlight:glossary:session":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},"A session is the live connection between a WhatsApp engine and WhatsApp's servers on behalf of one linked number, plus the credentials and state that make it resumable. It is what actually sends and receives; the API around it is only a façade. When a session dies, nothing can be sent until it is restored or re-paired.","Linking a device gives the engine a set of cryptographic keys and an identity that let it act as one of the number's companion devices. That state is persisted so the session survives a process restart, which is what separates a production setup from a script that must scan a QR every morning. Sessions have a lifecycle worth modelling explicitly in your own system: starting, waiting to be linked, connected, and stopped or failed. They end for several distinct reasons, and the difference matters: the phone's owner can unlink the device from the linked-devices screen, WhatsApp drops devices whose phone has not been seen for roughly two weeks, the engine itself can fail, and WhatsApp can ban the number outright. Wapito reports the reason on the channel webhook rather than collapsing them all into disconnected, because a ban needs a human and a restart does not. The practical consequence for anyone building on an unofficial API is that session health is a first-class operational concern, monitored like a database connection rather than assumed.",{"example":7,"field":8},"{\"status\": \"disconnected\", \"previous_status\": \"connected\", \"reason\": \"logged_out\"}","previous_status","The Cloud API has no session to manage. Meta hosts the connection, which removes this whole class of operational work and, with it, the ability to use the number in the WhatsApp app.","What is a WhatsApp session?",{"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\u002Fhealth","\u002Fdocs\u002Fapi\u002Fchannel\u002Fget-channel-health\u002F",{"title":22,"url":23},"GET \u002Fchannel","\u002Fdocs\u002Fapi\u002Fchannel\u002Fget-channel\u002F",{"title":25,"url":26},"POST \u002Fchannel\u002Flogout","\u002Fdocs\u002Fapi\u002Fchannel\u002Flogout-channel\u002F",[28,31,34],{"title":29,"url":30},"Channel","\u002Fglossary\u002Fchannel\u002F",{"title":32,"url":33},"QR linking","\u002Fglossary\u002Fqr-linking\u002F",{"title":35,"url":36},"Pairing code","\u002Fglossary\u002Fpairing-code\u002F",[38,46,50],{"availability":39,"ban_risk":40,"method":41,"operationId":42,"path":43,"summary":44,"tag":45,"url":20},"ga","low","GET","getChannelHealth","\u002Fchannel\u002Fhealth","Check channel and engine health","channel",{"availability":39,"ban_risk":40,"method":41,"operationId":47,"path":48,"summary":49,"tag":45,"url":23},"getChannel","\u002Fchannel","Get channel status and settings",{"availability":39,"ban_risk":40,"method":51,"operationId":52,"path":53,"summary":54,"tag":45,"url":26},"POST","logoutChannel","\u002Fchannel\u002Flogout","Log the number out of the channel",{"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},"Session","\u002Fglossary\u002Fsession\u002F","https:\u002F\u002Fwapito.com\u002Fglossary\u002Fsession\u002F","A session is the live connection between a WhatsApp engine and WhatsApp's servers on behalf of one linked number, plus the credentials and state that make it…","2026-09-15","What is a WhatsApp session? | Wapito Glossary","session","t9",[72],{"label":73,"id":74,"lang":74,"code":75,"html":76},"JSON","json","{\n  \"status\": \"disconnected\",\n  \"previous_status\": \"connected\",\n  \"reason\": \"logged_out\"\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\">  \"status\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"disconnected\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#116329;--shiki-dark:#7EE787\">  \"previous_status\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"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\">  \"reason\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"logged_out\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1790464916176]