[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-en-\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fclick-to-whatsapp":3},{"id":4,"title":5,"body":6,"category":453,"code_examples":454,"demos":454,"description":455,"extension":456,"meta":457,"navigation":454,"order":458,"path":459,"seo":460,"sitemap":467,"stem":469,"tags":470,"toc":474,"videos":454,"__hash__":475},"docsEn\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fclick-to-whatsapp.md","Click-to-WhatsApp (CTWA) conversion tracking",{"type":7,"value":8,"toc":435},"minimark",[9,13,25,30,52,63,83,94,109,113,118,213,220,224,244,248,282,288,294,304,308,335,339,346,358,371,375,385,389,395,399,411,415],[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],"note",{"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,184,193,202],"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],{},"Qiscus",[145,160,161],{},"✅",[145,163,164],{},"Automatic from webhook",[125,166,167,170,172],{},[145,168,169],{},"Kirimdev",[145,171,161],{},[145,173,164],{},[125,175,176,179,181],{},[145,177,178],{},"Halo AI",[145,180,161],{},[145,182,183],{},"Via WABA linking",[125,185,186,189,191],{},[145,187,188],{},"kirim.chat",[145,190,161],{},[145,192,183],{},[125,194,195,198,200],{},[145,196,197],{},"Qontak",[145,199,161],{},[145,201,183],{},[125,203,204,207,210],{},[145,205,206],{},"Pancake",[145,208,209],{},"❌ not yet",[145,211,212],{},"—",[214,215,217],"tip",{"title":216},"Qiscus & Kirimdev",[14,218,219],{},"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,221,223],{"id":222},"prerequisites","Prerequisites",[225,226,227,234,237],"ol",{},[67,228,229,230,233],{},"You run ",[17,231,232],{},"Click-to-WhatsApp ads"," on Meta.",[67,235,236],{},"Your business WhatsApp number receives messages through one of the supported partners above.",[67,238,239,240,243],{},"You have access to ",[17,241,242],{},"Meta Business Manager"," to grant permissions.",[26,245,247],{"id":246},"how-to-connect","How to connect",[225,249,250,261,264,267,273,279],{},[67,251,252,253,256,257,260],{},"Open ",[36,254,255],{},"WhatsApp"," > ",[36,258,259],{},"Sessions"," in Konektor.",[67,262,263],{},"Find the Session for the business number that receives messages from your CTWA ads.",[67,265,266],{},"Select the pencil icon to edit the Session.",[67,268,269,270,93],{},"Enter the WABA ID for that number in ",[36,271,272],{},"WhatsApp Business Account ID",[67,274,275,276,93],{},"Select ",[36,277,278],{},"Connect Meta",[67,280,281],{},"Sign in to Meta with an account that can access the WABA, then approve the requested permissions.",[14,283,284,285,93],{},"Meta selects or creates the CTWA dataset for that WABA. Konektor saves the Dataset ID and token automatically. When setup succeeds, the Session status changes to ",[36,286,287],{},"CTWA configured",[14,289,290,291,293],{},"Once active, conversions from CTWA leads are automatically sent as ",[44,292,61],{}," events to your CTWA dataset.",[14,295,296,297,300,301,303],{},"If the dedicated CTWA connection is not ready, Konektor continues sending new conversions as regular ",[36,298,299],{},"chat"," events through your default Meta dataset. This keeps conversion delivery running, but Meta does not receive CTWA-specific ",[44,302,61],{}," attribution until you complete the WABA connection.",[26,305,307],{"id":306},"verifying","Verifying",[64,309,310,324],{},[67,311,312,313,316,317,320,321,323],{},"In Konektor ",[17,314,315],{},"Conversion Logs",", a conversion with a ready CTWA connection shows ",[17,318,319],{},"\"Sent (business_messaging)\"",". A temporary fallback shows a regular ",[36,322,299],{}," delivery instead.",[67,325,326,327,330,331,334],{},"In ",[17,328,329],{},"Meta Events Manager",", open your CTWA dataset (named after your Page) and check for incoming ",[36,332,333],{},"business_messaging"," events.",[26,336,338],{"id":337},"troubleshooting","Troubleshooting",[340,341,343,344],"h3",{"id":342},"ctwa-conversion-is-sent-as-chat","CTWA conversion is sent as ",[36,345,299],{},[14,347,348,349,351,352,354,355,357],{},"The lead has a ",[36,350,38],{},", but its dedicated CTWA dataset or authorization is not ready. Konektor sends the conversion as a regular ",[36,353,299],{}," event so delivery can continue. Meta will not treat that event as an attributed ",[44,356,61],{}," conversion.",[14,359,360,363,364,367,368,370],{},[17,361,362],{},"Fix:"," select ",[17,365,366],{},"Connect"," on the Session and complete the WABA connection. New conversions use ",[44,369,61],{}," after the connection succeeds. Older skipped entries remain in the log and can be retried after the connection is ready.",[340,372,374],{"id":373},"waba-not-linked","\"WABA not linked\"",[14,376,377,378,256,380,382,383,93],{},"The WhatsApp number that received the lead is not connected to Meta. Open ",[36,379,255],{},[36,381,259],{},", edit the matching Session, then select ",[36,384,278],{},[340,386,388],{"id":387},"pancake-leads-arent-attributed","Pancake leads aren't attributed",[14,390,391,392,394],{},"The Pancake adapter doesn't yet extract ",[36,393,38],{},". If you run CTWA ads, use a supported partner, or contact our team.",[340,396,398],{"id":397},"messages-dont-become-leads-at-all","Messages don't become leads at all",[14,400,401,402,406,407,410],{},"That's a partner connection issue, not CTWA. See the relevant partner guide (e.g. ",[403,404,158],"a",{"href":405},"\u002Fen\u002Fdocs\u002Fpartner\u002Fqiscus",", ",[403,408,169],{"href":409},"\u002Fen\u002Fdocs\u002Fpartner\u002Fkirimdev",").",[26,412,414],{"id":413},"next-steps","Next steps",[64,416,417,423,429],{},[67,418,419],{},[403,420,422],{"href":421},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fmeta-capi","Set up Meta CAPI",[67,424,425],{},[403,426,428],{"href":427},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fmeta-emq","Optimize EMQ Score",[67,430,431],{},[403,432,434],{"href":433},"\u002Fen\u002Fdocs\u002Fpartner","WhatsApp Partner Integrations",{"title":436,"searchDepth":437,"depth":437,"links":438},"",2,[439,440,441,442,443,444,452],{"id":28,"depth":437,"text":29},{"id":111,"depth":437,"text":112},{"id":222,"depth":437,"text":223},{"id":246,"depth":437,"text":247},{"id":306,"depth":437,"text":307},{"id":337,"depth":437,"text":338,"children":445},[446,449,450,451],{"id":342,"depth":447,"text":448},3,"CTWA conversion is sent as chat",{"id":373,"depth":447,"text":374},{"id":387,"depth":447,"text":388},{"id":397,"depth":447,"text":398},{"id":413,"depth":437,"text":414},"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":461,"description":462,"keywords":463,"canonical":459},"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.",[464,38,465,61,466],"ctwa","click to whatsapp conversions api","meta capi whatsapp",{"loc":459,"lastmod":468},"2026-07-15","en\u002Fdocs\u002Fplatform-guides\u002Fclick-to-whatsapp",[464,471,472,61,38,473],"click to whatsapp","meta capi","whatsapp",true,"DE6R_e7HiLUaJOxvnIDYXrTG-UkBuvRZ9epOsjsVEd8"]