[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-en-\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fctwa-getting-started":3},{"id":4,"title":5,"body":6,"category":534,"code_examples":535,"demos":535,"description":536,"extension":537,"meta":538,"navigation":535,"order":539,"path":540,"seo":541,"sitemap":547,"stem":549,"tags":550,"toc":556,"videos":535,"__hash__":557},"docsEn\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fctwa-getting-started.md","Click-to-WhatsApp Ads from Zero",{"type":7,"value":8,"toc":512},"minimark",[9,13,17,22,47,51,169,175,179,182,194,198,223,230,234,264,268,280,308,312,315,319,360,364,369,372,376,379,383,393,397,400,404,407,411,478,482],[10,11,5],"h1",{"id":12},"click-to-whatsapp-ads-from-zero",[14,15,16],"p",{},"A Click-to-WhatsApp (CTWA) ad opens a WhatsApp chat directly from a Facebook or Instagram ad. Konektor records the chat as an ad lead, and sends events to Meta when the lead status changes.",[18,19,21],"h2",{"id":20},"how-it-works","How it works",[23,24,25,29,37,44],"ol",{},[26,27,28],"li",{},"A person clicks the ad and sends a message to your number.",[26,30,31,32,36],{},"The message carries ad data from Meta, including ",[33,34,35],"code",{},"ctwa_clid",".",[26,38,39,40,36],{},"Konektor creates a lead with the source ",[41,42,43],"strong",{},"ads",[26,45,46],{},"When the lead status changes, Konektor sends an event to Meta.",[18,48,50],{"id":49},"choose-a-whatsapp-path","Choose a WhatsApp path",[52,53,54,76],"table",{},[55,56,57],"thead",{},[58,59,60,64,67,73],"tr",{},[61,62,63],"th",{},"Path",[61,65,66],{},"WhatsApp Business app on the phone",[61,68,69,70,72],{},"Ad data (",[33,71,35],{},")",[61,74,75],{},"Notes",[77,78,79,100,120,139,155],"tbody",{},[58,80,81,91,94,97],{},[82,83,84],"td",{},[41,85,86],{},[87,88,90],"a",{"href":89},"\u002Fen\u002Fdocs\u002Fwhatsapp-session-risk","Unofficial QR session",[82,92,93],{},"Stays in use",[82,95,96],{},"Read when WhatsApp includes it",[82,98,99],{},"This can violate Meta terms. Meta can restrict or block the number.",[58,101,102,107,110,113],{},[82,103,104],{},[41,105,106],{},"Official WhatsApp Business",[82,108,109],{},"Remove the number from the app first",[82,111,112],{},"Read",[82,114,115,116,119],{},"The team replies from the ",[41,117,118],{},"Inbox",". Each chat from a new number becomes a lead.",[58,121,122,127,130,132],{},[82,123,124],{},[41,125,126],{},"Kirimdev, Qiscus, Halo AI, kirim.chat, Qontak",[82,128,129],{},"Depends on the provider",[82,131,112],{},[82,133,134,135,36],{},"See the provider table on ",[87,136,138],{"href":137},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fclick-to-whatsapp","Click-to-WhatsApp Conversions",[58,140,141,147,149,152],{},[82,142,143,146],{},[41,144,145],{},"Kapso"," (coexistence)",[82,148,93],{},[82,150,151],{},"Not read",[82,153,154],{},"Konektor creates a lead only from a message with a visitor code.",[58,156,157,162,164,166],{},[82,158,159],{},[41,160,161],{},"Pancake",[82,163,129],{},[82,165,151],{},[82,167,168],{},"—",[14,170,171,172,174],{},"For daily operations, use ",[41,173,106],{},". This path is the most stable and carries no risk of a Meta block.",[18,176,178],{"id":177},"before-you-start","Before you start",[14,180,181],{},"Prepare:",[183,184,185,188,191],"ul",{},[26,186,187],{},"an owner or admin role in your Konektor workspace;",[26,189,190],{},"access to Meta Business Manager, the ad account, and a Meta pixel or dataset with an access token;",[26,192,193],{},"the WhatsApp number that you will use for the ad.",[18,195,197],{"id":196},"step-1-connect-the-whatsapp-number","Step 1 — Connect the WhatsApp number",[14,199,200,201,204,205,208,209,213,214,217,218,222],{},"Open ",[41,202,203],{},"WhatsApp"," > ",[41,206,207],{},"Connect WhatsApp",", then select a path from the table above. Read ",[87,210,212],{"href":211},"\u002Fen\u002Fdocs\u002Fwhatsapp\u002Fsession","WhatsApp Session",", ",[87,215,106],{"href":216},"\u002Fen\u002Fdocs\u002Fwhatsapp-official",", or ",[87,219,221],{"href":220},"\u002Fen\u002Fdocs\u002Fpartner","Partner Integrations"," for your chosen path.",[14,224,225,226,36],{},"If Meta rejects your number during the official connection, read ",[87,227,229],{"href":228},"\u002Fen\u002Fdocs\u002Fwhatsapp-official#number-already-registered-to-a-whatsapp-account","Number already registered to a WhatsApp account",[18,231,233],{"id":232},"step-2-add-meta-in-website-tracking","Step 2 — Add Meta in Website Tracking",[14,235,200,236,239,240,243,244,247,248,251,252,255,256,259,260,263],{},[41,237,238],{},"Website Tracking",", click ",[41,241,242],{},"Add Ad Platform",", select ",[41,245,246],{},"Meta",", then enter the ",[41,249,250],{},"Meta Pixel ID"," and ",[41,253,254],{},"Access Token",". Click ",[41,257,258],{},"Save",", then click ",[41,261,262],{},"Test platform",". Without an active Meta platform, no Meta event goes out.",[18,265,267],{"id":266},"step-3-set-statuses-and-events","Step 3 — Set statuses and events",[14,269,200,270,204,273,276,277,36],{},[41,271,272],{},"Conversion",[41,274,275],{},"Conversion Settings",", then select the ",[41,278,279],{},"Campaign Type",[183,281,282,289,300],{},[26,283,284,285,288],{},"When a chat from an ad arrives, Konektor sends the event for the ",[41,286,287],{},"New"," status: AddToCart with the Sales type, or Contact with the Leads type.",[26,290,291,292,295,296,299],{},"Install the ",[41,293,294],{},"Ads Lead to Responded"," template so that active ad leads move to ",[41,297,298],{},"Responded",". This status sends the Lead event.",[26,301,302,303,307],{},"For a dedicated CTWA dataset, read ",[87,304,306],{"href":305},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fmeta-ctwa","Meta CTWA Token",". Without a dedicated CTWA dataset, Konektor sends the event as a normal chat event to your Meta pixel.",[18,309,311],{"id":310},"step-4-run-the-ad-on-the-same-number","Step 4 — Run the ad on the same number",[14,313,314],{},"Run your Click-to-WhatsApp ad in Meta Ads Manager with the WhatsApp number that you connected in Step 1. Konektor reads only chats from the number connected to your workspace.",[18,316,318],{"id":317},"step-5-check-leads-and-events","Step 5 — Check leads and events",[183,320,321,329,338],{},[26,322,200,323,326,327,36],{},[41,324,325],{},"Leads",". A lead from the ad shows the source ",[41,328,43],{},[26,330,331,332,334,335,36],{},"Open that lead's detail. Owners see the ",[33,333,35],{}," value in ",[41,336,337],{},"Attribution Parameters",[26,339,200,340,204,342,345,346,213,349,217,352,355,356,359],{},[41,341,272],{},[41,343,344],{},"Sync Logs",". A ",[41,347,348],{},"Meta CTWA",[41,350,351],{},"CTWA fallback",[41,353,354],{},"Meta CAPI"," badge identifies the delivery channel. An ",[33,357,358],{},"accepted"," status means that Meta accepted the event.",[18,361,363],{"id":362},"faq-waba-coexistence-and-ctwa_clid","FAQ: WABA, coexistence, and ctwa_clid",[365,366,368],"h3",{"id":367},"what-is-a-waba-and-when-do-i-need-the-waba-id","What is a WABA, and when do I need the WABA ID?",[14,370,371],{},"A WABA is the WhatsApp Business Account in Meta that holds official numbers. On the official connection, you select or create the WABA in the Meta window. You need the WABA ID to send events to a dedicated CTWA dataset.",[365,373,375],{"id":374},"can-i-keep-the-whatsapp-business-app-on-my-phone","Can I keep the WhatsApp Business app on my phone?",[14,377,378],{},"Yes, with the unofficial QR session or with Kapso in coexistence mode. The QR session reads ad data, but it can violate Meta terms. Kapso does not pass Click-to-WhatsApp ad data to Konektor. The Konektor official connection needs a number that you removed from the app.",[365,380,382],{"id":381},"what-is-ctwa_clid-and-where-do-i-see-it","What is ctwa_clid, and where do I see it?",[14,384,385,387,388,390,391,36],{},[33,386,35],{}," is the click ID of a Click-to-WhatsApp ad. Meta adds it to the message from a person who clicked the ad. Open the lead in ",[41,389,325],{},". Owners see the value in ",[41,392,337],{},[365,394,396],{"id":395},"why-does-an-ad-lead-have-no-ctwa_clid","Why does an ad lead have no ctwa_clid?",[14,398,399],{},"The chat did not start from an ad click, or your path does not pass ad data (Kapso, Pancake). On a QR session, Konektor reads the data only when WhatsApp includes it.",[365,401,403],{"id":402},"why-does-a-normal-chat-not-become-a-lead","Why does a normal chat not become a lead?",[14,405,406],{},"On a QR session and on providers, Konektor creates a lead only from a message with a visitor code or ad data. On Official WhatsApp Business, each chat from a new number becomes a lead.",[18,408,410],{"id":409},"common-problems","Common problems",[52,412,413,423],{},[55,414,415],{},[58,416,417,420],{},[61,418,419],{},"Symptom",[61,421,422],{},"What to do",[77,424,425,433,445,457,467],{},[58,426,427,430],{},[82,428,429],{},"A chat from the ad does not become a lead",[82,431,432],{},"Make sure that the ad uses the connected number, and that the connection is active.",[58,434,435,442],{},[82,436,437,439,440],{},[41,438,344],{}," shows ",[41,441,351],{},[82,443,444],{},"The event went out as a normal chat event. Follow the Meta CTWA Token guide for a dedicated CTWA dataset.",[58,446,447,450],{},[82,448,449],{},"No Meta row, or the row shows skipped",[82,451,452,453,259,455,36],{},"Add the Meta platform in ",[41,454,238],{},[41,456,262],{},[58,458,459,462],{},[82,460,461],{},"Meta rejects the number on the official connection",[82,463,464,465,36],{},"Read ",[87,466,229],{"href":228},[58,468,469,472],{},[82,470,471],{},"The QR session disconnects often",[82,473,474,475,36],{},"Read the ",[87,476,477],{"href":211},"WhatsApp Session guide",[18,479,481],{"id":480},"related-guides","Related guides",[183,483,484,488,492,496,500,506],{},[26,485,486],{},[87,487,138],{"href":137},[26,489,490],{},[87,491,306],{"href":305},[26,493,494],{},[87,495,106],{"href":216},[26,497,498],{},[87,499,212],{"href":211},[26,501,502],{},[87,503,505],{"href":504},"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Flanding-page-whatsapp","Landing Page to WhatsApp",[26,507,508],{},[87,509,511],{"href":510},"\u002Fen\u002Fdocs\u002Fwhatsapp\u002Fautomation","Automation Rules",{"title":513,"searchDepth":514,"depth":514,"links":515},"",2,[516,517,518,519,520,521,522,523,524,532,533],{"id":20,"depth":514,"text":21},{"id":49,"depth":514,"text":50},{"id":177,"depth":514,"text":178},{"id":196,"depth":514,"text":197},{"id":232,"depth":514,"text":233},{"id":266,"depth":514,"text":267},{"id":310,"depth":514,"text":311},{"id":317,"depth":514,"text":318},{"id":362,"depth":514,"text":363,"children":525},[526,528,529,530,531],{"id":367,"depth":527,"text":368},3,{"id":374,"depth":527,"text":375},{"id":381,"depth":527,"text":382},{"id":395,"depth":527,"text":396},{"id":402,"depth":527,"text":403},{"id":409,"depth":514,"text":410},{"id":480,"depth":514,"text":481},"platform-guides",null,"A beginner guide to Click-to-WhatsApp ads: pick a WhatsApp path, connect Meta, and check ad leads. Covers WABA, coexistence, and ctwa_clid.","md",{},4,"\u002Fen\u002Fdocs\u002Fplatform-guides\u002Fctwa-getting-started",{"title":5,"description":536,"keywords":542,"canonical":540},[543,544,545,546,35],"click to whatsapp beginner","ctwa from zero","waba id","whatsapp coexistence",{"loc":540,"lastmod":548},"2026-09-24","en\u002Fdocs\u002Fplatform-guides\u002Fctwa-getting-started",[551,552,553,554,35,555],"ctwa","click to whatsapp","waba","coexistence","beginner",true,"ooIQNyuKRpsIn1l1CRIbmv1m4ov3Nq-04yIAkaaKa4Q"]