[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-en-\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fmeta-ctwa":3},{"id":4,"title":5,"body":6,"category":590,"code_examples":591,"demos":591,"description":592,"extension":593,"meta":594,"navigation":591,"order":595,"path":596,"seo":597,"sitemap":606,"stem":608,"tags":609,"toc":613,"videos":591,"__hash__":614},"docsEn\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fmeta-ctwa.md","Connect Meta CTWA with a Meta App token",{"type":7,"value":8,"toc":567},"minimark",[9,13,22,25,40,45,48,79,82,85,89,92,99,106,110,113,138,145,148,152,174,177,181,214,217,224,234,238,241,263,266,269,273,276,314,317,321,331,350,358,364,411,415,424,444,447,451,463,480,486,490,495,498,502,510,514,517,521,529,533,536,540],[10,11,5],"h1",{"id":12},"connect-meta-ctwa-with-a-meta-app-token",[14,15,16,17,21],"p",{},"Use this temporary path if your workspace shows the ",[18,19,20],"strong",{},"Meta App token"," method. This path connects a WhatsApp Session to a Click-to-WhatsApp (CTWA) dataset through an App owned by your business.",[14,23,24],{},"If the workspace uses Direct Chat, this setup sends CTWA conversion data only. Direct Chat continues to manage conversations, contacts, messages, templates, and your inbox.",[26,27,29],"danger",{"title":28},"Submit the token only through the secure modal",[14,30,31,32,35,36,39],{},"Never send the token through chat, email, support tickets, documentation, or screenshots. Konektor accepts the token only in the ",[18,33,34],{},"Set up CTWA"," or ",[18,37,38],{},"Manage CTWA"," modal.",[41,42,44],"h2",{"id":43},"before-you-begin","Before you begin",[14,46,47],{},"Prepare the following:",[49,50,51,55,58,61,64,67],"ul",{},[52,53,54],"li",{},"owner or admin access to your Konektor workspace;",[52,56,57],{},"a Meta App owned by your business and connected to the correct Business Portfolio;",[52,59,60],{},"the WhatsApp and Marketing API use cases on that Meta App;",[52,62,63],{},"access to the WhatsApp Business Account (WABA) that contains the Session number;",[52,65,66],{},"the numeric WABA ID for that number;",[52,68,69,70,74,75,78],{},"a token with ",[71,72,73],"code",{},"whatsapp_business_management"," and ",[71,76,77],{},"whatsapp_business_manage_events",".",[14,80,81],{},"Your business must control the WABA and Meta App. The Meta user or System User that creates the token must also have access to that App and WABA.",[14,83,84],{},"You do not find or enter a Dataset ID. Konektor asks Meta to select the existing WABA dataset or create one during verification.",[41,86,88],{"id":87},"choose-a-token-for-testing-or-production","Choose a token for testing or production",[14,90,91],{},"Use a Graph API Explorer user token only for a limited test. The token can expire or stop working when the user's access changes.",[14,93,94,95,98],{},"Use a ",[18,96,97],{},"System User"," token for continued production use. Give the System User access only to the required Meta App and WABA, then create a token with both CTWA permissions.",[100,101,103],"warning",{"title":102},"Keep the token secret",[14,104,105],{},"Store the token in your business password manager or secret store. Do not put it in documents, shared notes, or screenshots.",[41,107,109],{"id":108},"prepare-the-meta-app-and-waba-access","Prepare the Meta App and WABA access",[14,111,112],{},"Meta can change its menu labels. Use the menu with the same function if your interface differs.",[114,115,116,119,122,125,128,135],"ol",{},[52,117,118],{},"Open Meta for Developers, then create or use a business App owned by your business.",[52,120,121],{},"Connect the App to the Business Portfolio that owns or manages the WABA.",[52,123,124],{},"Add the WhatsApp and Marketing API use cases to the App.",[52,126,127],{},"Give the user or System User access to the matching App and WABA.",[52,129,130,131,74,133,78],{},"Create a token with ",[71,132,73],{},[71,134,77],{},[52,136,137],{},"Open WhatsApp Manager, then copy the WABA ID for the WhatsApp number.",[14,139,140,141,144],{},"Example WABA ID format: ",[71,142,143],{},"100000000000001",". This value is fictional and must not be used in your workspace.",[14,146,147],{},"Meta can require more settings for your App type and business assets. Konektor checks both permissions, WABA access, and the dataset before it saves the connection.",[41,149,151],{"id":150},"save-the-session-before-ctwa-setup","Save the Session before CTWA setup",[114,153,154,164,167],{},[52,155,156,157,160,161,78],{},"Open ",[18,158,159],{},"WhatsApp"," > ",[18,162,163],{},"Sessions",[52,165,166],{},"Create a Session or complete the Session for the applicable WhatsApp number.",[52,168,169,170,173],{},"Select ",[18,171,172],{},"Save Changes"," before you open the CTWA setup.",[14,175,176],{},"Each Session must use the WABA ID that contains its number. Do not use a Pixel ID, Dataset ID, or WABA ID from another business.",[41,178,180],{"id":179},"connect-the-token-in-konektor","Connect the token in Konektor",[114,182,183,192,199,203,209],{},[52,184,185,186,188,189,191],{},"On the saved Session row, select ",[18,187,34],{},". Select ",[18,190,38],{}," if the Session was previously connected.",[52,193,194,195,198],{},"Enter the numeric WABA ID in ",[18,196,197],{},"WhatsApp Business Account ID"," in the CTWA modal.",[52,200,169,201,78],{},[18,202,20],{},[52,204,205,206,208],{},"Paste the token into the ",[18,207,20],{}," field.",[52,210,169,211,78],{},[18,212,213],{},"Verify and connect",[14,215,216],{},"Konektor checks both permissions, WABA access, and the dataset before it saves the token. If a replacement token fails, Konektor keeps the previous connection.",[14,218,219,220,223],{},"You do not use ",[18,221,222],{},"Edit Session"," to save the WABA ID. The CTWA modal verifies and saves the WABA ID with the connection.",[14,225,226,227,74,230,233],{},"The local connection is ready when the Session shows ",[18,228,229],{},"Ready - Manual token",[18,231,232],{},"CTWA dataset ready",". This status does not prove that Meta accepted or attributed an event.",[41,235,237],{"id":236},"use-a-saved-token-for-another-session","Use a saved token for another Session",[14,239,240],{},"Use this method when one connected token can access another WABA in the same workspace.",[114,242,243,248,254,259],{},[52,244,169,245,247],{},[18,246,34],{}," on the next Session.",[52,249,250,251,253],{},"Enter the ",[18,252,197],{}," for that Session number.",[52,255,169,256,78],{},[18,257,258],{},"Use saved token",[52,260,169,261,78],{},[18,262,213],{},[14,264,265],{},"Konektor verifies the token against the new WABA. It also verifies other WABAs that use the connector before it saves changes.",[14,267,268],{},"This method does not display or send the token to the browser. The previous connection remains available if the token cannot access the new WABA.",[41,270,272],{"id":271},"check-three-separate-proofs","Check three separate proofs",[14,274,275],{},"Do not combine these three results:",[114,277,278,287,308],{},[52,279,280,283,284,286],{},[18,281,282],{},"Local configuration is ready."," The Session shows ",[18,285,229],{},". Konektor validated and saved the connection.",[52,288,289,283,292,295,296,299,300,303,304,307],{},[18,290,291],{},"Meta accepted a dedicated CTWA event.",[18,293,294],{},"Meta accepted a CTWA event",", and ",[18,297,298],{},"Sync Logs"," shows a ",[18,301,302],{},"Meta CTWA"," row with ",[71,305,306],{},"accepted"," status.",[52,309,310,313],{},[18,311,312],{},"Ads Manager reported or attributed the conversion."," Check this result separately in Meta Ads Manager.",[14,315,316],{},"Konektor can prove the first and second results. Meta Graph acceptance does not guarantee that Ads Manager will report or attribute a conversion.",[41,318,320],{"id":319},"read-the-delivery-channel-and-status","Read the delivery channel and status",[14,322,323,324,326,327,330],{},"The ",[18,325,298],{}," tab in ",[18,328,329],{},"Conversion"," shows the channel and status separately. A badge identifies the path. The badge is not acceptance proof:",[49,332,333,338,344],{},[52,334,335,337],{},[18,336,302],{},": Konektor tried the dedicated CTWA path to the WABA dataset.",[52,339,340,343],{},[18,341,342],{},"CTWA fallback",": Konektor tried the regular Meta CAPI fallback for a CTWA event.",[52,345,346,349],{},[18,347,348],{},"Meta CAPI",": Konektor tried a regular Meta event that was not a dedicated CTWA delivery.",[14,351,352,353,303,355,357],{},"Check the status on the same row. Only a ",[18,354,302],{},[71,356,306],{}," status proves that Meta accepted the dedicated event.",[14,359,323,360,363],{},[18,361,362],{},"Resend as Meta CTWA"," action follows these rules:",[49,365,366,377,384,399,405],{},[52,367,368,369,303,371,35,373,376],{},"A ",[18,370,342],{},[71,372,306],{},[71,374,375],{},"failed"," status can be eligible.",[52,378,368,379,381,382,376],{},[18,380,302],{}," row with terminal ",[71,383,375],{},[52,385,386,387,390,391,394,395,398],{},"A row with ",[71,388,389],{},"queued",", ",[71,392,393],{},"sending",", or ",[71,396,397],{},"retry"," status is not eligible.",[52,400,401,402,404],{},"An accepted ",[18,403,302],{}," row blocks a duplicate dedicated resend for the same event and dataset.",[52,406,407,408,410],{},"A regular ",[18,409,348],{}," row does not offer CTWA resend.",[41,412,414],{"id":413},"check-replace-or-disconnect-the-connection","Check, replace, or disconnect the connection",[14,416,156,417,160,419,421,422,78],{},[18,418,159],{},[18,420,163],{},", then select ",[18,423,38],{},[49,425,426,432,438],{},[52,427,169,428,431],{},[18,429,430],{},"Check connection"," to validate the permissions and assets again. This action does not send a test Purchase event.",[52,433,169,434,437],{},[18,435,436],{},"Replace token"," to verify a new token before replacing the active token.",[52,439,169,440,443],{},[18,441,442],{},"Disconnect CTWA"," to remove the connection from that Session.",[14,445,446],{},"Disconnecting CTWA in Konektor does not revoke the token in Meta. Revoke the token in Meta business settings when it must no longer work.",[41,448,450],{"id":449},"migrate-to-meta-login-later","Migrate to Meta login later",[14,452,453,454,457,458,35,460,462],{},"A Direct Chat pilot workspace does not show ",[18,455,456],{},"Meta login",". Use ",[18,459,20],{},[18,461,258],{}," during the pilot.",[14,464,465,466,468,469,471,472,188,474,476,477,78],{},"After ",[18,467,456],{}," becomes available for your business, open ",[18,470,38],{}," and select ",[18,473,436],{},[18,475,456],{},", then continue with ",[18,478,479],{},"Log in with Meta",[14,481,482,483,78],{},"Konektor keeps the manual token until the new OAuth connection passes validation. If migration fails, the previous manual connection remains active. After migration succeeds, the Session shows ",[18,484,485],{},"Ready - Meta login",[41,487,489],{"id":488},"troubleshooting","Troubleshooting",[491,492,494],"h3",{"id":493},"the-token-is-invalid-or-expired","The token is invalid or expired",[14,496,497],{},"Create a new token from the correct business App. Confirm that the user or System User still has access to the WABA.",[491,499,501],{"id":500},"the-token-lacks-both-ctwa-permissions","The token lacks both CTWA permissions",[14,503,504,505,74,507,509],{},"Create the token again with ",[71,506,73],{},[71,508,77],{},". Confirm that the App has the WhatsApp and Marketing API use cases.",[491,511,513],{"id":512},"the-waba-is-unavailable","The WABA is unavailable",[14,515,516],{},"Confirm that the WABA ID contains digits only. Confirm that the WABA contains the Session number and is accessible to the token owner.",[491,518,520],{"id":519},"the-event-shows-ctwa-fallback","The event shows CTWA fallback",[14,522,169,523,525,526,528],{},[18,524,38],{},", then run ",[18,527,430],{},". Create one new conversion after the connection is ready before you retry an eligible older fallback.",[491,530,532],{"id":531},"support-needs-to-inspect-a-failure","Support needs to inspect a failure",[14,534,535],{},"Send the Session name, attempt time, and safe message shown by Konektor. Do not send the token, complete WABA ID, Dataset ID, private URL, or a screenshot that contains a secret.",[41,537,539],{"id":538},"related-guides","Related guides",[49,541,542,549,555,561],{},[52,543,544],{},[545,546,548],"a",{"href":547},"\u002Fen\u002Fdocs\u002Fconversions","Monitor delivery on the Conversion Dashboard",[52,550,551],{},[545,552,554],{"href":553},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fmeta-capi","Set up Meta Conversions API for regular events",[52,556,557],{},[545,558,560],{"href":559},"\u002Fen\u002Fdocs\u002Fpartner\u002Fhaloai","Connect Halo AI and set up CTWA",[52,562,563],{},[545,564,566],{"href":565},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fclick-to-whatsapp","Understand Click-to-WhatsApp conversion tracking",{"title":568,"searchDepth":569,"depth":569,"links":570},"",2,[571,572,573,574,575,576,577,578,579,580,581,589],{"id":43,"depth":569,"text":44},{"id":87,"depth":569,"text":88},{"id":108,"depth":569,"text":109},{"id":150,"depth":569,"text":151},{"id":179,"depth":569,"text":180},{"id":236,"depth":569,"text":237},{"id":271,"depth":569,"text":272},{"id":319,"depth":569,"text":320},{"id":413,"depth":569,"text":414},{"id":449,"depth":569,"text":450},{"id":488,"depth":569,"text":489,"children":582},[583,585,586,587,588],{"id":493,"depth":584,"text":494},3,{"id":500,"depth":584,"text":501},{"id":512,"depth":584,"text":513},{"id":519,"depth":584,"text":520},{"id":531,"depth":584,"text":532},{"id":538,"depth":569,"text":539},"platform-guides",null,"Set up a temporary Click-to-WhatsApp connection with your business-owned Meta App, then check its delivery proof.","md",{},6,"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fmeta-ctwa",{"title":598,"description":599,"keywords":600,"canonical":596},"Connect Meta CTWA with a Meta App token | Konektor","Set up a token from your business-owned Meta App for Click-to-WhatsApp conversion delivery from Konektor.",[601,602,603,604,605],"meta ctwa","meta app token","click to whatsapp","waba","business messaging",{"loc":596,"lastmod":607},"2026-09-06","en\u002Fdocs\u002Fplatform-guides\u002Fmeta-ctwa",[610,611,603,612,602],"meta","ctwa","whatsapp",true,"URdtkRWfMqJMUJc4zsqwkjtAY1tcg9Z9XgNt24FaJi8"]