[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-en-\u002Fen\u002Fdocs\u002Fwhatsapp\u002Flead-form":3},{"id":4,"title":5,"body":6,"category":749,"code_examples":749,"demos":749,"description":750,"extension":751,"meta":752,"navigation":749,"order":484,"path":754,"seo":755,"sitemap":756,"stem":757,"tags":749,"toc":758,"videos":749,"__hash__":759},"docsEn\u002Fen\u002Fdocs\u002Fwhatsapp\u002Flead-form.md","Lead Capture Form (Custom Fields)",{"type":7,"value":8,"toc":726},"minimark",[9,14,19,31,34,76,80,83,94,98,144,148,153,168,172,201,272,291,295,298,311,314,323,326,333,344,361,366,400,403,409,508,512,531,542,546,577,581,597,601,635,639,643,657,661,664,682,688,691,705,709,722],[10,11,13],"h1",{"id":12},"lead-capture-form","Lead Capture Form",[15,16,18],"h2",{"id":17},"overview","Overview",[20,21,22,23,26,27,30],"p",{},"By default, a rotator link opens WhatsApp immediately.",[24,25],"br",{},"\nWhen ",[28,29,13],"strong",{}," is enabled, visitors see a form first, then get redirected to WhatsApp after submit.",[20,32,33],{},"Latest version includes:",[35,36,37,52,55,70],"ul",{},[38,39,40,41,45,46,45,49],"li",{},"Core fields: ",[42,43,44],"code",{},"name",", ",[42,47,48],{},"phone",[42,50,51],{},"email",[38,53,54],{},"Dynamic custom fields (up to 10)",[38,56,57,58,45,61,45,64,45,67],{},"Custom field types: ",[42,59,60],{},"text",[42,62,63],{},"textarea",[42,65,66],{},"select",[42,68,69],{},"checkbox",[38,71,72,73],{},"WhatsApp message token support: ",[42,74,75],{},"[k:key]",[15,77,79],{"id":78},"when-should-you-use-it","When Should You Use It?",[20,81,82],{},"Use Lead Form when you want to:",[35,84,85,88,91],{},[38,86,87],{},"Capture richer lead data before chat starts",[38,89,90],{},"Measure ad traffic quality beyond WhatsApp clicks",[38,92,93],{},"Inject visitor context into the first WhatsApp message",[15,95,97],{"id":96},"quick-enable-steps","Quick Enable Steps",[99,100,101,108,111,118,124,141],"ol",{},[38,102,103,104,107],{},"Go to ",[28,105,106],{},"WhatsApp > Rotator",".",[38,109,110],{},"Create a new rotator or edit an existing one.",[38,112,113,114,117],{},"Select ",[28,115,116],{},"Form Link"," mode.",[38,119,120,121,123],{},"Enable the ",[28,122,13],{}," toggle.",[38,125,126,127],{},"Configure:\n",[35,128,129,132,135,138],{},[38,130,131],{},"Form title",[38,133,134],{},"Description",[38,136,137],{},"Logo URL (optional)",[38,139,140],{},"Submit button label",[38,142,143],{},"Save the rotator.",[15,145,147],{"id":146},"configure-form-fields","Configure Form Fields",[149,150,152],"h3",{"id":151},"core-fields","Core fields",[35,154,155,163],{},[38,156,157,159,160,162],{},[42,158,44],{}," and ",[42,161,48],{}," are always enabled and required.",[38,164,165,167],{},[42,166,51],{}," can be enabled\u002Fdisabled, and optionally required.",[149,169,171],{"id":170},"custom-fields","Custom fields",[35,173,174,181],{},[38,175,176,177,180],{},"Maximum ",[28,178,179],{},"10 fields"," per rotator.",[38,182,183,184,187,188],{},"Each field has a ",[28,185,186],{},"Key"," (field ID) that must be:\n",[35,189,190,193,198],{},[38,191,192],{},"unique",[38,194,195],{},[42,196,197],{},"snake_case",[38,199,200],{},"not a system key",[202,203,204,221],"table",{},[205,206,207],"thead",{},[208,209,210,215,218],"tr",{},[211,212,214],"th",{"align":213},"left","Type",[211,216,217],{"align":213},"User Input",[211,219,220],{"align":213},"Validation",[222,223,224,237,248,260],"tbody",{},[208,225,226,231,234],{},[227,228,229],"td",{"align":213},[42,230,60],{},[227,232,233],{"align":213},"Single line text",[227,235,236],{"align":213},"Trim + max length",[208,238,239,243,246],{},[227,240,241],{"align":213},[42,242,63],{},[227,244,245],{"align":213},"Multi-line text",[227,247,236],{"align":213},[208,249,250,254,257],{},[227,251,252],{"align":213},[42,253,66],{},[227,255,256],{"align":213},"Option picker",[227,258,259],{"align":213},"Value must match one of the listed options",[208,261,262,266,269],{},[227,263,264],{"align":213},[42,265,69],{},[227,267,268],{"align":213},"Check toggle",[227,270,271],{"align":213},"Yes\u002FNo only",[273,274,276],"tip",{"title":275},"Good Key Naming",[20,277,278,279,45,282,45,285,45,288,107],{},"Recommended keys: ",[42,280,281],{},"budget",[42,283,284],{},"service_need",[42,286,287],{},"plan_type",[42,289,290],{},"has_team",[15,292,294],{"id":293},"use-tokens-in-whatsapp-message","Use Tokens in WhatsApp Message",[20,296,297],{},"In your rotator message template, you can use:",[35,299,300,306],{},[38,301,302,305],{},[42,303,304],{},"[uniquecode]"," for the visitor unique code",[38,307,308,310],{},[42,309,75],{}," for custom field values",[20,312,313],{},"Example:",[315,316,321],"pre",{"className":317,"code":319,"language":60,"meta":320},[318],"language-text","Hi team, I want to discuss.\nBudget: [k:budget]\nNeed: [k:service_need]\nCode: [uniquecode]\n","",[42,322,319],{"__ignoreMap":320},[20,324,325],{},"If a custom field value is missing\u002Fempty, token output becomes an empty string.",[15,327,329,330],{"id":328},"rotator-custom-url-params-with-k_","Rotator Custom URL Params with ",[42,331,332],{},"k_*",[20,334,335,336,339,340,343],{},"Besides ",[42,337,338],{},"form.custom_fields",", you can also pass context from URL query params using the ",[42,341,342],{},"k_"," prefix, for example:",[35,345,346,351,356],{},[38,347,348],{},[42,349,350],{},"?k_budget=50jt",[38,352,353],{},[42,354,355],{},"?k_channel=meta",[38,357,358],{},[42,359,360],{},"?k_product=premium_plan",[20,362,363,365],{},[42,364,332],{}," values will:",[35,367,368,375,381],{},[38,369,370,371,374],{},"Be stored in lead custom fields with stable keys (for example ",[42,372,373],{},"k_budget",")",[38,376,377,378],{},"Appear in CSV export as ",[42,379,380],{},"cf_k_budget",[38,382,383,384],{},"Be usable in WhatsApp message templates in two token styles:\n",[35,385,386,392],{},[38,387,388,391],{},[42,389,390],{},"[k:k_budget]"," (full key)",[38,393,394,397,398,374],{},[42,395,396],{},"[k:budget]"," (automatic alias from ",[42,399,373],{},[20,401,402],{},"If a token has no value, output stays an empty string.",[20,404,405,406,408],{},"If you want ",[42,407,332],{}," to be auto-forwarded when users click rotator\u002Fform links from pages that already contain query params (without manually appending query on every link), enable this tracker option:",[315,410,414],{"className":411,"code":412,"language":413,"meta":320,"style":320},"language-javascript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","konektor('init', 'WS-XXXX', {\n  crossDomain: {\n    autoLink: true,\n    forwardKParams: true\n  }\n})\n","javascript",[42,415,416,455,467,482,493,499],{"__ignoreMap":320},[417,418,421,425,429,433,437,439,442,445,448,450,452],"span",{"class":419,"line":420},"line",1,[417,422,424],{"class":423},"s2Zo4","konektor",[417,426,428],{"class":427},"sTEyZ","(",[417,430,432],{"class":431},"sMK4o","'",[417,434,436],{"class":435},"sfazB","init",[417,438,432],{"class":431},[417,440,441],{"class":431},",",[417,443,444],{"class":431}," '",[417,446,447],{"class":435},"WS-XXXX",[417,449,432],{"class":431},[417,451,441],{"class":431},[417,453,454],{"class":431}," {\n",[417,456,458,462,465],{"class":419,"line":457},2,[417,459,461],{"class":460},"swJcz","  crossDomain",[417,463,464],{"class":431},":",[417,466,454],{"class":431},[417,468,470,473,475,479],{"class":419,"line":469},3,[417,471,472],{"class":460},"    autoLink",[417,474,464],{"class":431},[417,476,478],{"class":477},"sfNiH"," true",[417,480,481],{"class":431},",\n",[417,483,485,488,490],{"class":419,"line":484},4,[417,486,487],{"class":460},"    forwardKParams",[417,489,464],{"class":431},[417,491,492],{"class":477}," true\n",[417,494,496],{"class":419,"line":495},5,[417,497,498],{"class":431},"  }\n",[417,500,502,505],{"class":419,"line":501},6,[417,503,504],{"class":431},"}",[417,506,507],{"class":427},")\n",[15,509,511],{"id":510},"link-format","Link Format",[35,513,514,525],{},[38,515,516,517,520,521,524],{},"Direct WhatsApp link (no form): ",[42,518,519],{},"domain.com\u002Fwa\u002F[slug]"," or ",[42,522,523],{},"domain.com\u002F[slug]"," (depends on domain setup)",[38,526,527,528],{},"Form link: ",[42,529,530],{},"domain.com\u002Fform\u002F[slug]",[532,533,535],"note",{"title":534},"Important",[20,536,537,538,541],{},"Use ",[42,539,540],{},"\u002Fform\u002F"," URLs in ads or landing pages when you want visitors to fill the form first.",[15,543,545],{"id":544},"where-is-data-stored","Where Is Data Stored?",[35,547,548,555,558,564,571],{},[38,549,550,551,554],{},"Lead data is saved to ",[28,552,553],{},"Leads"," as usual.",[38,556,557],{},"Custom fields are stored securely.",[38,559,560,561,107],{},"Custom fields appear in ",[28,562,563],{},"Lead Detail",[38,565,566,567,570],{},"When exporting leads to CSV, custom fields are included as ",[42,568,569],{},"cf_\u003Ckey>"," columns.",[38,572,573,574,576],{},"In the lead list page, only core data is shown. Open ",[28,575,563],{}," or the export file to view custom fields.",[15,578,580],{"id":579},"permission-access","Permission & Access",[35,582,583,590],{},[38,584,585,586,589],{},"Only workspace owners (",[42,587,588],{},"owner",") and admins can create, update, or delete rotators.",[38,591,592,593,596],{},"Team members (",[42,594,595],{},"staff",") can only view lead details assigned to them.",[15,598,600],{"id":599},"recommended-implementation-checklist","Recommended Implementation Checklist",[99,602,603,606,609,615,621],{},[38,604,605],{},"Enable Lead Form on one rotator first (pilot).",[38,607,608],{},"Add 2-3 high-value custom fields.",[38,610,611,612,614],{},"Add ",[42,613,75],{}," tokens to message template.",[38,616,617,618,107],{},"Submit test from ",[42,619,620],{},"\u002Fform\u002F[slug]",[38,622,623,624],{},"Verify:\n",[35,625,626,629,632],{},[38,627,628],{},"WhatsApp redirect works",[38,630,631],{},"Custom fields appear in lead detail",[38,633,634],{},"Message tokens are replaced correctly",[15,636,638],{"id":637},"troubleshooting","Troubleshooting",[149,640,642],{"id":641},"do-i-need-to-update-the-tracking-script","Do I need to update the tracking script?",[35,644,645,648,654],{},[38,646,647],{},"No, not required for Lead Capture Form + rotator custom fields.",[38,649,650,651,653],{},"As long as your traffic uses ",[42,652,620],{},", custom fields will work without tracking script changes.",[38,655,656],{},"Tracker updates are still recommended for broader website tracking improvements (e.g., UTM\u002Fcross-domain), but they are not a strict requirement for this feature.",[149,658,660],{"id":659},"form-cannot-be-submitted","Form cannot be submitted",[20,662,663],{},"Common causes:",[35,665,666,669,672,677],{},[38,667,668],{},"Required field is empty",[38,670,671],{},"Duplicate custom field key",[38,673,674,676],{},[42,675,66],{}," value is not in the available options",[38,678,679,681],{},[42,680,69],{}," value is not Yes\u002FNo",[149,683,685,687],{"id":684},"kkey-token-not-filled",[42,686,75],{}," token not filled",[20,689,690],{},"Check:",[35,692,693,696,699],{},[38,694,695],{},"Token key exactly matches field key",[38,697,698],{},"Field is active",[38,700,701,702,374],{},"User actually submitted a value (empty maps to ",[42,703,704],{},"-",[15,706,708],{"id":707},"current-limits","Current Limits",[35,710,711,716,719],{},[38,712,713,714,374],{},"Custom fields are shown in Lead Detail and included in CSV export (",[42,715,569],{},[38,717,718],{},"Max 10 custom fields",[38,720,721],{},"Supported types only: text, textarea, select, checkbox",[723,724,725],"style",{},"html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":320,"searchDepth":457,"depth":457,"links":727},[728,729,730,731,735,736,738,739,740,741,742,748],{"id":17,"depth":457,"text":18},{"id":78,"depth":457,"text":79},{"id":96,"depth":457,"text":97},{"id":146,"depth":457,"text":147,"children":732},[733,734],{"id":151,"depth":469,"text":152},{"id":170,"depth":469,"text":171},{"id":293,"depth":457,"text":294},{"id":328,"depth":457,"text":737},"Rotator Custom URL Params with k_*",{"id":510,"depth":457,"text":511},{"id":544,"depth":457,"text":545},{"id":579,"depth":457,"text":580},{"id":599,"depth":457,"text":600},{"id":637,"depth":457,"text":638,"children":743},[744,745,746],{"id":641,"depth":469,"text":642},{"id":659,"depth":469,"text":660},{"id":684,"depth":469,"text":747},"[k:key] token not filled",{"id":707,"depth":457,"text":708},null,"Capture lead data before WhatsApp redirect, including dynamic custom fields and [k:key] message tokens.","md",{"icon":753},"i-heroicons-clipboard-document-list","\u002Fen\u002Fdocs\u002Fwhatsapp\u002Flead-form",{"title":5,"description":750},{"loc":754},"en\u002Fdocs\u002Fwhatsapp\u002Flead-form",true,"ssnABDisut7v_mT_rs6pn_6pGvW5e1yFbdeng8-b_ic"]