[{"data":1,"prerenderedAt":115},["ShallowReactive",2],{"pseo:errors:engine-unavailable":3,"highlight:error:engine-unavailable":109},{"cause":4,"code":5,"example":6,"faqs":10,"feature":17,"fix_steps":21,"http_status":25,"message":8,"protocol_aliases":26,"raised_by":28,"related":53,"retryable":88,"seo":89,"slug":106,"tier":107,"title":108,"updated":104,"url":100},"Wapito could not reach the WhatsApp engine process that holds this channel's session: the engine is restarting, its container is being replaced during a deploy, the connection was refused, or the deployment does not run the engine the channel asks for. The request never reached WhatsApp, so nothing was sent or changed. This is the status to expect for a minute or two around maintenance and the one a health check should tolerate briefly before paging anyone.","engine_unavailable",{"error":7},{"code":5,"message":8,"request_id":9},"The WhatsApp engine is unavailable.","req_01JRQ8F4X9N2K7YB3C5V6W8H0T",[11,14],{"a":12,"q":13},"Not necessarily. The engine holds the session, and while the engine is down nobody can tell whether the phone is still linked. Once the engine is back the channel's status in the dashboard and the channel webhook event report the real state; treat the 503 as unknown rather than as disconnected.","Is the channel disconnected when I see this?",{"a":15,"q":16},"No. Deliveries to your receiver are queued on Wapito's side with retries, and inbound events that the engine buffered are processed when it reconnects. What you may see afterwards is a short burst of events with timestamps from the outage window, so key your handlers on the event id rather than on arrival order.","Will queued webhooks be lost while the engine is unavailable?",{"name":18,"slug":19,"url":20},"Connect a Number","connect-number-qr-pairing","\u002Fwhatsapp-api\u002Fconnect-number-qr-pairing\u002F",[22,23,24],"Retry with exponential backoff starting at a couple of seconds; the engine normally comes back within a minute and the request is safe to repeat.","Poll the channel health endpoint while backing off, so your worker resumes the moment the engine answers rather than on a fixed timer.","If the 503 lasts more than a few minutes, check the status page and open a ticket with the request_id; a stuck engine is on us to restart.",503,[27],"ECONNREFUSED",[29,38,46],{"availability":30,"ban_risk":31,"method":32,"operationId":33,"path":34,"summary":35,"tag":36,"url":37},"ga","low","GET","getChannelHealth","\u002Fchannel\u002Fhealth","Check channel and engine health","channel","\u002Fdocs\u002Fapi\u002Fchannel\u002Fget-channel-health\u002F",{"availability":30,"ban_risk":39,"method":40,"operationId":41,"path":42,"summary":43,"tag":44,"url":45},"medium","POST","sendText","\u002Fmessages\u002Ftext","Send a text message","messages","\u002Fdocs\u002Fapi\u002Fmessages\u002Fsend-text\u002F",{"availability":30,"ban_risk":47,"method":40,"operationId":48,"path":49,"summary":50,"tag":51,"url":52},"high","createGroup","\u002Fgroups","Create a group","groups","\u002Fdocs\u002Fapi\u002Fgroups\u002Fcreate-group\u002F",{"glossary":54,"hub":64,"operations":65,"pillar":20,"siblings":72},[55,58,61],{"title":56,"url":57},"Pairing code","\u002Fglossary\u002Fpairing-code\u002F",{"title":59,"url":60},"QR linking","\u002Fglossary\u002Fqr-linking\u002F",{"title":62,"url":63},"Session","\u002Fglossary\u002Fsession\u002F","\u002Fdocs\u002Ferrors\u002F",[66,68,70],{"title":67,"url":37},"GET \u002Fchannel\u002Fhealth",{"title":69,"url":45},"POST \u002Fmessages\u002Ftext",{"title":71,"url":52},"POST \u002Fgroups",[73,76,79,82,85],{"title":74,"url":75},"engine_error (502)","\u002Fdocs\u002Ferrors\u002Fengine-error\u002F",{"title":77,"url":78},"engine_timeout (504)","\u002Fdocs\u002Ferrors\u002Fengine-timeout\u002F",{"title":80,"url":81},"engine_unsupported_feature (501)","\u002Fdocs\u002Ferrors\u002Fengine-unsupported-feature\u002F",{"title":83,"url":84},"feature_not_available (501)","\u002Fdocs\u002Ferrors\u002Ffeature-not-available\u002F",{"title":86,"url":87},"internal_error (500)","\u002Fdocs\u002Ferrors\u002Finternal-error\u002F",true,{"breadcrumb":90,"canonical":101,"description":102,"h1":103,"lastmod":104,"title":105},[91,94,97,99],{"name":92,"url":93},"Home","\u002F",{"name":95,"url":96},"Docs","\u002Fdocs\u002F",{"name":98,"url":64},"Errors",{"name":5,"url":100},"\u002Fdocs\u002Ferrors\u002Fengine-unavailable\u002F","https:\u002F\u002Fwapito.com\u002Fdocs\u002Ferrors\u002Fengine-unavailable\u002F","503 engine_unavailable: The WhatsApp engine is unavailable. The request never reached WhatsApp, so nothing was sent or changed.","engine_unavailable — Engine unreachable","2026-09-17","engine_unavailable (503): Engine unreachable | Wapito","engine-unavailable","t8","Engine unreachable",[110],{"label":111,"id":112,"lang":112,"code":113,"html":114},"JSON","json","{\n  \"error\": {\n    \"code\": \"engine_unavailable\",\n    \"message\": \"The WhatsApp engine is unavailable.\",\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\">\"engine_unavailable\"\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 WhatsApp engine is unavailable.\"\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>",1790464916038]