[{"data":1,"prerenderedAt":122},["ShallowReactive",2],{"pseo:errors:engine-error":3,"highlight:error:engine-error":116},{"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":58,"retryable":95,"seo":96,"slug":113,"tier":114,"title":115,"updated":111,"url":107},"The engine that holds the WhatsApp session answered the request with a failure Wapito could not map to a more specific code: WhatsApp rejected the action for that chat, the session hit a protocol error mid-call, or the engine returned a body that was not what its own contract promises. The response quotes what the engine said in details so the reason is not lost, and the request_id ties it to our logs. Some of these are transient and some are specific to one chat or one media file.","engine_error",{"error":7},{"code":5,"message":8,"request_id":9},"The WhatsApp engine returned an error.","req_01JRQ8F4X9N2K7YB3C5V6W8H0T",[11,14],{"a":12,"q":13},"It means the engine did not confirm it, which is not the same as no. For a send, check the message's status through the reference endpoint or wait for the messages.status webhook before resending, because a retry of a message that did go out is a duplicate the recipient will notice.","Does a 502 mean the message went out?",{"a":15,"q":16},"With engine_unavailable the engine could not be reached at all, so nothing happened and a retry is safe. With engine_error the engine was reached and answered with a failure, so the action may have partly happened - a group created but its icon not set, for instance - and the quoted message in details is what tells you which.","How is engine_error different from engine_unavailable?",{"name":18,"slug":19,"url":20},"Create Group","create-group","\u002Fwhatsapp-api\u002Fcreate-group\u002F",[22,23,24],"Read the quoted engine message in details before retrying; a rejection tied to the target chat or media will repeat, while a session hiccup will not.","Retry once with backoff; if the same call keeps failing, check the channel's health and whether the number is still connected on the phone.","Report a repeatable 502 with its request_id and the quoted engine message, because an unmapped engine answer is usually a mapping we should add.",502,[27],"WAHA 500 Internal Server Error",[29,38,45,52],{"availability":30,"ban_risk":31,"method":32,"operationId":33,"path":34,"summary":35,"tag":36,"url":37},"ga","high","POST","createGroup","\u002Fgroups","Create a group","groups","\u002Fdocs\u002Fapi\u002Fgroups\u002Fcreate-group\u002F",{"availability":30,"ban_risk":39,"method":40,"operationId":41,"path":42,"summary":43,"tag":36,"url":44},"low","GET","getGroup","\u002Fgroups\u002F{id}","Get a group","\u002Fdocs\u002Fapi\u002Fgroups\u002Fget-group\u002F",{"availability":30,"ban_risk":46,"method":32,"operationId":47,"path":48,"summary":49,"tag":50,"url":51},"medium","sendText","\u002Fmessages\u002Ftext","Send a text message","messages","\u002Fdocs\u002Fapi\u002Fmessages\u002Fsend-text\u002F",{"availability":30,"ban_risk":39,"method":40,"operationId":53,"path":54,"summary":55,"tag":56,"url":57},"listNewsletters","\u002Fnewsletters","List WhatsApp Channels","newsletters","\u002Fdocs\u002Fapi\u002Fnewsletters\u002Flist-newsletters\u002F",{"glossary":59,"hub":69,"operations":70,"pillar":20,"siblings":79},[60,63,66],{"title":61,"url":62},"JID","\u002Fglossary\u002Fjid\u002F",{"title":64,"url":65},"Group admin","\u002Fglossary\u002Fgroup-admin\u002F",{"title":67,"url":68},"Invite code","\u002Fglossary\u002Finvite-code\u002F","\u002Fdocs\u002Ferrors\u002F",[71,73,75,77],{"title":72,"url":37},"POST \u002Fgroups",{"title":74,"url":44},"GET \u002Fgroups\u002F{id}",{"title":76,"url":51},"POST \u002Fmessages\u002Ftext",{"title":78,"url":57},"GET \u002Fnewsletters",[80,83,86,89,92],{"title":81,"url":82},"engine_unsupported_feature (501)","\u002Fdocs\u002Ferrors\u002Fengine-unsupported-feature\u002F",{"title":84,"url":85},"feature_not_available (501)","\u002Fdocs\u002Ferrors\u002Ffeature-not-available\u002F",{"title":87,"url":88},"engine_unavailable (503)","\u002Fdocs\u002Ferrors\u002Fengine-unavailable\u002F",{"title":90,"url":91},"internal_error (500)","\u002Fdocs\u002Ferrors\u002Finternal-error\u002F",{"title":93,"url":94},"engine_timeout (504)","\u002Fdocs\u002Ferrors\u002Fengine-timeout\u002F",true,{"breadcrumb":97,"canonical":108,"description":109,"h1":110,"lastmod":111,"title":112},[98,101,104,106],{"name":99,"url":100},"Home","\u002F",{"name":102,"url":103},"Docs","\u002Fdocs\u002F",{"name":105,"url":69},"Errors",{"name":5,"url":107},"\u002Fdocs\u002Ferrors\u002Fengine-error\u002F","https:\u002F\u002Fwapito.com\u002Fdocs\u002Ferrors\u002Fengine-error\u002F","502 engine_error: The WhatsApp engine returned an error. Some of these are transient and some are specific to one chat or one media file.","engine_error — WhatsApp engine error","2026-09-17","engine_error (502): WhatsApp engine error | Wapito","engine-error","t8","WhatsApp engine error",[117],{"label":118,"id":119,"lang":119,"code":120,"html":121},"JSON","json","{\n  \"error\": {\n    \"code\": \"engine_error\",\n    \"message\": \"The WhatsApp engine returned an error.\",\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_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\">    \"message\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"The WhatsApp engine returned an 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\">    \"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>",1790464916021]