[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-en-\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fclick-to-whatsapp":3},{"id":4,"title":5,"body":6,"category":574,"code_examples":575,"demos":575,"description":576,"extension":577,"meta":578,"navigation":575,"order":579,"path":580,"seo":581,"sitemap":588,"stem":590,"tags":591,"toc":595,"videos":575,"__hash__":596},"docsEn\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fclick-to-whatsapp.md","Click-to-WhatsApp (CTWA) conversion tracking",{"type":7,"value":8,"toc":556},"minimark",[9,13,25,30,52,63,83,94,109,113,118,241,248,252,272,276,323,340,343,349,359,363,399,402,406,413,425,443,484,488,497,501,507,511,521,525],[10,11,5],"h1",{"id":12},"click-to-whatsapp-ctwa-conversion-tracking",[14,15,16,20,21,24],"p",{},[17,18,19],"strong",{},"Click-to-WhatsApp (CTWA)"," ads send people from Facebook or Instagram straight into a WhatsApp conversation with your business. Konektor links conversions from those conversations back to the ad through the ",[17,22,23],{},"Meta Conversions API",", so Meta can optimize your campaigns.",[26,27,29],"h2",{"id":28},"how-it-works","How it works",[14,31,32,33,39,40,42,43,47,48,51],{},"When a customer taps a CTWA ad and sends their first message, Meta injects a ",[17,34,35],{},[36,37,38],"code",{},"ctwa_clid"," (Click-to-WhatsApp Click ID) into that message's webhook. Konektor stores the ",[36,41,38],{}," on the lead. When the lead later progresses (for example to ",[44,45,46],"em",{},"qualified"," or ",[44,49,50],{},"won","), Konektor sends a conversion event to Meta.",[14,53,54,55,58,59,62],{},"For Meta to attribute that conversion to the CTWA ad, the event ",[17,56,57],{},"must"," be sent as ",[44,60,61],{},"business messaging",", not as a regular website event. Konektor sends the three required fields:",[64,65,66,72,77],"ul",{},[67,68,69],"li",{},[36,70,71],{},"action_source: \"business_messaging\"",[67,73,74],{},[36,75,76],{},"messaging_channel: \"whatsapp\"",[67,78,79,82],{},[36,80,81],{},"user_data.ctwa_clid"," (raw value, not hashed)",[14,84,85,86,89,90,93],{},"plus the business identifier (",[36,87,88],{},"whatsapp_business_account_id","), delivered to your account's dedicated ",[17,91,92],{},"CTWA dataset",".",[95,96,98],"info",{"title":97},"Why a dedicated dataset & token are needed",[14,99,100,101,104,105,108],{},"Meta uses a ",[17,102,103],{},"separate CTWA dataset"," for WhatsApp conversions, distinct from your website pixel. Sending events to that dataset requires access permission. When you connect your ",[17,106,107],{},"WhatsApp Business Account (WABA)",", Meta selects the associated dataset or creates one if needed. Konektor saves the Dataset ID and token automatically.",[26,110,112],{"id":111},"supported-partners","Supported partners",[14,114,115,117],{},[36,116,38],{}," detection depends on which WhatsApp partner you use.",[119,120,121,139],"table",{},[122,123,124],"thead",{},[125,126,127,131,136],"tr",{},[128,129,130],"th",{},"Partner",[128,132,133,135],{},[36,134,38],{}," detected",[128,137,138],{},"Business identity (WABA)",[140,141,142,154,165,174,183,193,202,211,222,231],"tbody",{},[125,143,144,148,151],{},[145,146,147],"td",{},"WhatsApp API (gateway)",[145,149,150],{},"✅ (most complete)",[145,152,153],{},"Automatic from session",[125,155,156,159,162],{},[145,157,158],{},"Official WhatsApp Business (Cloud API)",[145,160,161],{},"✅",[145,163,164],{},"Automatic from webhook",[125,166,167,170,172],{},[145,168,169],{},"Qiscus",[145,171,161],{},[145,173,164],{},[125,175,176,179,181],{},[145,177,178],{},"Kirimdev",[145,180,161],{},[145,182,164],{},[125,184,185,188,190],{},[145,186,187],{},"Halo AI",[145,189,161],{},[145,191,192],{},"Via WABA linking",[125,194,195,198,200],{},[145,196,197],{},"kirim.chat",[145,199,161],{},[145,201,192],{},[125,203,204,207,209],{},[145,205,206],{},"Qontak",[145,208,161],{},[145,210,192],{},[125,212,213,216,219],{},[145,214,215],{},"Kapso",[145,217,218],{},"❌",[145,220,221],{},"—",[125,223,224,227,229],{},[145,225,226],{},"Pancake",[145,228,218],{},[145,230,221],{},[125,232,233,236,238],{},[145,234,235],{},"Official WhatsApp Business",[145,237,161],{},[145,239,240],{},"Automatic from the connection",[242,243,245],"tip",{"title":244},"Qiscus & Kirimdev",[14,246,247],{},"For Qiscus and Kirimdev, Konektor reads the WhatsApp Business Account ID from the webhook. You do not enter it manually, but you still connect Meta once.",[26,249,251],{"id":250},"prerequisites","Prerequisites",[253,254,255,262,265],"ol",{},[67,256,257,258,261],{},"You run ",[17,259,260],{},"Click-to-WhatsApp ads"," on Meta.",[67,263,264],{},"Your business WhatsApp number receives messages through one of the supported partners above.",[67,266,267,268,271],{},"You have access to ",[17,269,270],{},"Meta Business Manager"," to grant permissions.",[26,273,275],{"id":274},"how-to-connect","How to connect",[253,277,278,289,292,298,308,315],{},[67,279,280,281,284,285,288],{},"Open ",[36,282,283],{},"WhatsApp"," > ",[36,286,287],{},"Sessions"," in Konektor.",[67,290,291],{},"Create a Session or complete the Session for the business number that receives messages from your CTWA ads.",[67,293,294,295,93],{},"Select ",[36,296,297],{},"Save Changes",[67,299,294,300,303,304,307],{},[36,301,302],{},"Set up CTWA"," on the saved Session row. Select ",[36,305,306],{},"Manage CTWA"," if the Session was previously connected.",[67,309,310,311,314],{},"Enter the WABA ID for that number in ",[36,312,313],{},"WhatsApp Business Account ID"," in the CTWA modal.",[67,316,317,318,93],{},"Follow the ",[319,320,322],"a",{"href":321},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fmeta-ctwa","Meta CTWA connection guide for a Meta App token",[14,324,325,326,329,330,333,334,329,337,93],{},"For the manual method, select ",[36,327,328],{},"Meta App token",", then use ",[36,331,332],{},"Verify and connect",". For the available OAuth method, select ",[36,335,336],{},"Meta login",[36,338,339],{},"Log in with Meta",[14,341,342],{},"The local configuration is ready when the Session shows its CTWA readiness status. This local status does not prove that Meta accepted an event.",[14,344,345,346,348],{},"Once active, conversions from CTWA leads are automatically sent as ",[44,347,61],{}," events to your CTWA dataset.",[14,350,351,352,355,356,358],{},"If the dedicated CTWA connection is not ready, Konektor continues sending new conversions as regular ",[36,353,354],{},"chat"," events through your default Meta dataset. This keeps conversion delivery running, but Meta does not receive CTWA-specific ",[44,357,61],{}," attribution until you complete the WABA connection.",[26,360,362],{"id":361},"check-the-result","Check the result",[64,364,365,373,380,390,396],{},[67,366,280,367,284,370,93],{},[17,368,369],{},"Conversion",[17,371,372],{},"Sync Logs",[67,374,375,376,379],{},"The ",[17,377,378],{},"Meta CTWA"," badge identifies the dedicated CTWA channel. The badge is not acceptance proof.",[67,381,382,383,386,387,389],{},"An ",[36,384,385],{},"accepted"," status on a ",[17,388,378],{}," row proves that Meta accepted the dedicated event.",[67,391,375,392,395],{},[17,393,394],{},"CTWA fallback"," badge identifies the regular Meta CAPI fallback.",[67,397,398],{},"Check reporting or attribution separately in Meta Ads Manager.",[14,400,401],{},"Konektor proves local configuration readiness and Meta acceptance of a dedicated event. Konektor does not prove Ads Manager reporting or attribution.",[26,403,405],{"id":404},"troubleshooting","Troubleshooting",[407,408,410,411],"h3",{"id":409},"ctwa-conversion-is-sent-as-chat","CTWA conversion is sent as ",[36,412,354],{},[14,414,415,416,418,419,421,422,424],{},"The lead has a ",[36,417,38],{},", but its dedicated CTWA dataset or authorization is not ready. Konektor sends the conversion as a regular ",[36,420,354],{}," event so delivery can continue. Meta will not treat that event as an attributed ",[44,423,61],{}," conversion.",[14,426,427,430,431,284,433,435,436,438,439,442],{},[17,428,429],{},"Fix:"," open ",[17,432,283],{},[17,434,287],{},", then select ",[17,437,306],{},". Run ",[17,440,441],{},"Check connection",", then create one new conversion.",[14,444,445,446,448,449,47,451,454,455,458,459,461,462,464,465,468,469,472,473,476,477,479,480,483],{},"A ",[17,447,394],{}," row with ",[36,450,385],{},[36,452,453],{},"failed"," status can be eligible for ",[17,456,457],{},"Resend as Meta CTWA",". A ",[17,460,378],{}," row with terminal ",[36,463,453],{}," status can also be eligible. A row with ",[36,466,467],{},"queued",", ",[36,470,471],{},"sending",", or ",[36,474,475],{},"retry"," status is not eligible. An accepted ",[17,478,378],{}," row blocks a duplicate. A regular ",[17,481,482],{},"Meta CAPI"," row does not offer CTWA resend.",[407,485,487],{"id":486},"waba-not-linked","\"WABA not linked\"",[14,489,490,491,493,494,93],{},"The WhatsApp number that received the lead is not connected to Meta. Select ",[36,492,302],{}," on the saved Session, then enter the WABA ID in the CTWA modal. Follow the ",[319,495,496],{"href":321},"Meta CTWA connection guide",[407,498,500],{"id":499},"pancake-or-kapso-leads-have-no-ctwa-click-id","Pancake or Kapso leads have no CTWA click ID",[14,502,503,504,506],{},"Konektor does not read ",[36,505,38],{}," from Pancake or Kapso. If you run CTWA ads, use a channel marked ✅ in the table above, or contact our team.",[407,508,510],{"id":509},"messages-dont-become-leads-at-all","Messages don't become leads at all",[14,512,513,514,468,517,520],{},"That's a partner connection issue, not CTWA. See the relevant partner guide (e.g. ",[319,515,169],{"href":516},"\u002Fen\u002Fdocs\u002Fpartner\u002Fqiscus",[319,518,178],{"href":519},"\u002Fen\u002Fdocs\u002Fpartner\u002Fkirimdev",").",[26,522,524],{"id":523},"next-steps","Next steps",[64,526,527,533,538,544,550],{},[67,528,529],{},[319,530,532],{"href":531},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fctwa-getting-started","Click-to-WhatsApp Ads from Zero",[67,534,535],{},[319,536,537],{"href":321},"Connect Meta CTWA with a Meta App token",[67,539,540],{},[319,541,543],{"href":542},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fmeta-capi","Set up Meta CAPI",[67,545,546],{},[319,547,549],{"href":548},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fmeta-emq","Optimize EMQ Score",[67,551,552],{},[319,553,555],{"href":554},"\u002Fen\u002Fdocs\u002Fpartner","WhatsApp Partner Integrations",{"title":557,"searchDepth":558,"depth":558,"links":559},"",2,[560,561,562,563,564,565,573],{"id":28,"depth":558,"text":29},{"id":111,"depth":558,"text":112},{"id":250,"depth":558,"text":251},{"id":274,"depth":558,"text":275},{"id":361,"depth":558,"text":362},{"id":404,"depth":558,"text":405,"children":566},[567,570,571,572],{"id":409,"depth":568,"text":569},3,"CTWA conversion is sent as chat",{"id":486,"depth":568,"text":487},{"id":499,"depth":568,"text":500},{"id":509,"depth":568,"text":510},{"id":523,"depth":558,"text":524},"platform-guides",null,"How Konektor tracks conversions from Click-to-WhatsApp ads to the Meta Conversions API, which partners are supported, and how to connect your WhatsApp Business Account so attribution works.","md",{},5,"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fclick-to-whatsapp",{"title":582,"description":583,"keywords":584,"canonical":580},"Click-to-WhatsApp (CTWA) Conversion Tracking - Meta CAPI","Enable Click-to-WhatsApp ad conversion attribution in Konektor. Connect your WhatsApp Business Account & CTWA dataset to the Meta Conversions API.",[585,38,586,61,587],"ctwa","click to whatsapp conversions api","meta capi whatsapp",{"loc":580,"lastmod":589},"2026-09-24","en\u002Fdocs\u002Fplatform-guides\u002Fclick-to-whatsapp",[585,592,593,61,38,594],"click to whatsapp","meta capi","whatsapp",true,"RqdfK6kPtXKqHBUtcw4rOYlWvIAYcihnVKbe--Q74Aw"]