[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-en-\u002Fen\u002Fdocs\u002Fpartner\u002Fkapso":3},{"id":4,"title":5,"body":6,"category":755,"code_examples":756,"demos":756,"description":757,"extension":758,"meta":759,"navigation":756,"order":760,"path":761,"seo":762,"sitemap":769,"stem":793,"tags":794,"toc":800,"videos":756,"__hash__":801},"docsEn\u002Fen\u002Fdocs\u002Fpartner\u002Fkapso.md","Kapso WhatsApp Cloud API Integration",{"type":7,"value":8,"toc":733},"minimark",[9,14,35,40,43,46,90,94,97,122,126,150,157,162,165,316,319,323,330,346,349,353,356,366,373,377,384,388,391,397,401,445,449,540,552,558,562,583,589,593,600,606,609,613,636,640,651,654,658,716,720],[10,11,13],"h1",{"id":12},"kapso-whatsapp-integration","Kapso WhatsApp Integration",[15,16,17,18,25,26,30,31,34],"p",{},"Connect your official WhatsApp number on ",[19,20,24],"a",{"href":21,"rel":22},"https:\u002F\u002Fkapso.com",[23],"nofollow","Kapso"," to Konektor. Once connected, incoming messages are saved automatically as ",[27,28,29],"strong",{},"Leads"," and appear in your ",[27,32,33],{},"Inbox",", and you can send outbound messages (text & template) directly from Konektor.",[36,37,39],"h2",{"id":38},"about-kapso","About Kapso",[15,41,42],{},"Kapso is an official WhatsApp connection provider (Cloud API). You sign up and pay Kapso directly, not through Konektor. Konektor only needs one API key from your Kapso account.",[15,44,45],{},"The number of WhatsApp numbers you can connect follows your Kapso plan, not your Konektor plan:",[47,48,49,62],"table",{},[50,51,52],"thead",{},[53,54,55,59],"tr",{},[56,57,58],"th",{},"Kapso plan",[56,60,61],{},"Number limit",[63,64,65,74,82],"tbody",{},[53,66,67,71],{},[68,69,70],"td",{},"Free",[68,72,73],{},"1 number",[53,75,76,79],{},[68,77,78],{},"Pro",[68,80,81],{},"3 numbers",[53,83,84,87],{},[68,85,86],{},"Platform",[68,88,89],{},"50 numbers",[36,91,93],{"id":92},"prerequisites","Prerequisites",[15,95,96],{},"Before you start, prepare:",[98,99,100,108,111],"ol",{},[101,102,103,104,107],"li",{},"An active ",[19,105,24],{"href":21,"rel":106},[23]," account.",[101,109,110],{},"One WhatsApp number to connect (a new number, or a number that already has WhatsApp Business).",[101,112,113,114,117,118,121],{},"Access to Konektor as the ",[27,115,116],{},"Owner"," or ",[27,119,120],{},"Admin"," of your workspace.",[36,123,125],{"id":124},"connect-a-number-on-kapso","Connect a Number on Kapso",[98,127,128,137,147],{},[101,129,130,131,136],{},"Sign in to the ",[19,132,135],{"href":133,"rel":134},"https:\u002F\u002Fapp.kapso.ai",[23],"Kapso dashboard",".",[101,138,139,140,143,144,136],{},"Click ",[27,141,142],{},"Phone numbers",", then ",[27,145,146],{},"Add phone number",[101,148,149],{},"Choose one of the three ways below.",[15,151,152],{},[153,154],"img",{"alt":155,"src":156},"The Connect number to WhatsApp page on Kapso with three options: US digital number, your own SIM card, and WhatsApp Business App","\u002Fimages\u002Fdocs\u002Fkapso-pilih-cara-nomor.webp",[158,159,161],"h3",{"id":160},"way-1-us-digital-number-fastest","Way 1: US digital number (fastest)",[15,163,164],{},"Kapso gives you a US number that is already verified. You need no SIM card and no verification code.",[98,166,167,173,186,198,218,240,258,270,290,303],{},[101,168,169,170,136],{},"Choose ",[27,171,172],{},"Instant setup with US digital number",[101,174,175,176,136,179,182],{},"Tick the confirmation box, then click ",[27,177,178],{},"Get and set up phone number",[180,181],"br",{},[153,183],{"alt":184,"src":185},"The US digital number page on Kapso with the box ticked and the Get and set up phone number button","\u002Fimages\u002Fdocs\u002Fkapso-nomor-us-mulai.webp",[101,187,188,189,136,192,194],{},"A Facebook window opens. Click ",[27,190,191],{},"Continue",[180,193],{},[153,195],{"alt":196,"src":197},"The Meta window Seamlessly connect your account to Kapso with the Continue button","\u002Fimages\u002Fdocs\u002Fkapso-meta-mulai.webp",[101,199,200,201,204,205,208,209,136,212,214],{},"Under ",[27,202,203],{},"Phone number",", pick a number labeled ",[27,206,207],{},"Verified",", then click ",[27,210,211],{},"Next",[180,213],{},[153,215],{"alt":216,"src":217},"The list of US numbers labeled Verified in the Meta window","\u002Fimages\u002Fdocs\u002Fkapso-meta-pilih-nomor.webp",[101,219,220,221,224,225,228,229,208,232,136,234,236],{},"Choose your ",[27,222,223],{},"Business portfolio",". Under ",[27,226,227],{},"WhatsApp Business account",", choose ",[27,230,231],{},"Create a WhatsApp Business account",[27,233,211],{},[180,235],{},[153,237],{"alt":238,"src":239},"The Business portfolio choice and Create a WhatsApp Business account in the Meta window","\u002Fimages\u002Fdocs\u002Fkapso-meta-pilih-bm.webp",[101,241,242,243,246,247,208,250,136,252,254],{},"Enter your business name in ",[27,244,245],{},"Name",", choose a ",[27,248,249],{},"Category",[27,251,211],{},[180,253],{},[153,255],{"alt":256,"src":257},"The business information form in the Meta window","\u002Fimages\u002Fdocs\u002Fkapso-meta-info-bisnis.webp",[101,259,260,261,136,264,266],{},"Review the requested access, then click ",[27,262,263],{},"Confirm",[180,265],{},[153,267],{"alt":268,"src":269},"The Review what you'll share with Kapso screen with the Confirm button","\u002Fimages\u002Fdocs\u002Fkapso-meta-review-izin.webp",[101,271,272,273,276,277,280,281,136,284,286],{},"The Meta window shows ",[27,274,275],{},"Your account is connected to Kapso",". Clear the box ",[27,278,279],{},"Instruct Meta to automatically identify order and lead events",", because Konektor already sends its own conversion events. Then click ",[27,282,283],{},"Finish",[180,285],{},[153,287],{"alt":288,"src":289},"The Your account is connected to Kapso screen with the Finish button","\u002Fimages\u002Fdocs\u002Fkapso-meta-terhubung.webp",[101,291,292,293,296,297,299],{},"Back on Kapso, choose how to pay Meta's fees. ",[27,294,295],{},"Use Kapso credits"," is the simplest.",[180,298],{},[153,300],{"alt":301,"src":302},"The choice of how to pay Meta's fees on Kapso","\u002Fimages\u002Fdocs\u002Fkapso-cara-bayar-meta.webp",[101,304,305,306,309,310,312],{},"Kapso shows the ",[27,307,308],{},"Build with this number"," page. Your number is live.",[180,311],{},[153,313],{"alt":314,"src":315},"The Build with this number page on Kapso with the connected number","\u002Fimages\u002Fdocs\u002Fkapso-nomor-siap.webp",[15,317,318],{},"From 1 October 2026, Meta charges replies within 24 hours after 1,000 free messages per number per month. The Kapso Free plan gives one US digital number; a second number needs the Pro plan.",[158,320,322],{"id":321},"way-2-your-own-sim-card","Way 2: Your own SIM card",[15,324,325,326,329],{},"Use your own number that is ",[27,327,328],{},"not"," registered in any WhatsApp app.",[98,331,332,337,343],{},[101,333,169,334,136],{},[27,335,336],{},"Connect my own SIM card",[101,338,339,340,136],{},"Follow the Facebook window as in Way 1, but choose ",[27,341,342],{},"Enter a new phone number",[101,344,345],{},"Enter your number, then enter the code sent by SMS or call.",[15,347,348],{},"If the number is still installed in a WhatsApp app, delete that WhatsApp account from the phone first.",[158,350,352],{"id":351},"way-3-an-existing-whatsapp-business-number-coexistence","Way 3: An existing WhatsApp Business number (coexistence)",[15,354,355],{},"Use a number that is already live in the WhatsApp Business app. The phone app keeps working, and your chat history syncs.",[98,357,358,363],{},[101,359,169,360,136],{},[27,361,362],{},"Connect WhatsApp Business App",[101,364,365],{},"Follow the Facebook window, then scan the QR code from the WhatsApp Business app on your phone.",[15,367,368,369,372],{},"This mode is capped at about 5 messages per second, and the connection sometimes drops on its own. Kapso labels it ",[27,370,371],{},"Unstable",". Choose Way 1 or Way 2 for high volume.",[158,374,376],{"id":375},"if-you-see-whatsapp-business-account-is-currently-restricted","If you see \"WhatsApp Business account is currently restricted\"",[15,378,379,380,383],{},"Meta restricts the business portfolio you chose. Click ",[27,381,382],{},"Back",", then choose another business portfolio. Check that portfolio in Business Support Home.",[158,385,387],{"id":386},"if-you-see-to-use-this-phone-number-youll-need-to-delete-an-existing-one","If you see \"To use this phone number, you'll need to delete an existing one\"",[15,389,390],{},"Your business portfolio has reached its number limit. A portfolio that is not verified can hold only a few numbers. Choose another business portfolio that is verified, or delete an old number in WhatsApp Manager.",[15,392,393],{},[153,394],{"alt":395,"src":396},"The number limit error in the Meta window","\u002Fimages\u002Fdocs\u002Fkapso-meta-error-batas-nomor.webp",[36,398,400],{"id":399},"create-an-api-key-on-kapso","Create an API Key on Kapso",[98,402,403,413,433,442],{},[101,404,405,406,409,410,136],{},"In the Kapso dashboard, open ",[27,407,408],{},"Integrate"," > ",[27,411,412],{},"API keys",[101,414,139,415,418,419,423,424,136,427,429],{},[27,416,417],{},"Create API key",", give it a name (for example ",[420,421,422],"code",{},"Konektor","), then click ",[27,425,426],{},"Create key",[180,428],{},[153,430],{"alt":431,"src":432},"The Create new API key dialog on Kapso with the name Konektor","\u002Fimages\u002Fdocs\u002Fkapso-api-key-buat.webp",[101,434,435,436,438],{},"Click the copy icon next to the key. Kapso shows it only once.",[180,437],{},[153,439],{"alt":440,"src":441},"The API key created dialog on Kapso with the copy button; the key value is hidden","\u002Fimages\u002Fdocs\u002Fkapso-api-key-jadi.webp",[101,443,444],{},"Keep this key safe. It works for every number in your Kapso account, so never share it with anyone you do not trust.",[36,446,448],{"id":447},"add-the-api-key-to-konektor","Add the API Key to Konektor",[98,450,451,454,477,500,512,525],{},[101,452,453],{},"Sign in to Konektor as the Owner or Admin of your workspace.",[101,455,456,457,409,460,208,463,466,467,470,471,473],{},"Open ",[27,458,459],{},"WhatsApp",[27,461,462],{},"Connect WhatsApp",[27,464,465],{},"Connect with Kapso"," on the ",[27,468,469],{},"Official WhatsApp Business"," card.",[180,472],{},[153,474],{"alt":475,"src":476},"The Connect WhatsApp page with the Connect with Kapso button on the Official WhatsApp Business card","\u002Fimages\u002Fdocs\u002Fwa-hubungkan-kapso.webp",[101,478,479,480,483,484,486,487,409,490,493,494,497,498,136],{},"The ",[27,481,482],{},"Add Partner Integration"," form opens with ",[27,485,24],{}," already selected. Another way: open ",[27,488,489],{},"Integrations",[27,491,492],{},"Partner Integrations",", click ",[27,495,496],{},"+ Add Integration",", then choose ",[27,499,24],{},[101,501,502,503,136,506,508],{},"Paste your Kapso API key into ",[27,504,505],{},"API Key",[180,507],{},[153,509],{"alt":510,"src":511},"The Add Partner Integration form with Kapso selected, the Integration Name field, and the API Key field","\u002Fimages\u002Fdocs\u002Fkapso-tambah.webp",[101,513,514,515,518,519,521],{},"Konektor looks up the numbers in your Kapso account at once. When there is only one, Konektor picks it and fills in ",[27,516,517],{},"Integration Name"," for you.",[180,520],{},[153,522],{"alt":523,"src":524},"The Kapso form in Konektor with the key pasted, the number picked, and the name filled in","\u002Fimages\u002Fdocs\u002Fkapso-konektor-nomor-otomatis.webp",[101,526,139,527,530,531,136,534,536],{},[27,528,529],{},"Connect",". The new integration card shows ",[27,532,533],{},"Connected",[180,535],{},[153,537],{"alt":538,"src":539},"The Partner Integrations page in Konektor with the new Kapso card marked Connected","\u002Fimages\u002Fdocs\u002Fkapso-konektor-terhubung.webp",[15,541,542,543,409,545,548,549,136],{},"You do not need to create a webhook on Kapso. Konektor registers the webhook for that number automatically, with its signing key. On Kapso, open ",[27,544,408],{},[27,546,547],{},"Webhooks"," to see it marked ",[27,550,551],{},"Active",[15,553,554],{},[153,555],{"alt":556,"src":557},"The Webhooks page on Kapso with the Konektor webhook marked Active","\u002Fimages\u002Fdocs\u002Fkapso-webhook-otomatis.webp",[36,559,561],{"id":560},"choose-a-number","Choose a Number",[563,564,565,568,571,578],"ul",{},[101,566,567],{},"Choose a number that is not already connected to another Kapso integration.",[101,569,570],{},"A number already used by another active Kapso integration in this workspace is shown, but cannot be selected.",[101,572,573,574,577],{},"If the number list does not appear, enter the ",[27,575,576],{},"WhatsApp Number"," manually using the number ID from Kapso.",[101,579,139,580,582],{},[27,581,529],{}," to finish.",[15,584,585],{},[153,586],{"alt":587,"src":588},"The Konektor Partner Integrations page with the Kapso WhatsApp card marked Connected","\u002Fimages\u002Fdocs\u002Fintegrasi-partner.webp",[36,590,592],{"id":591},"messages-reach-your-inbox-automatically","Messages Reach Your Inbox Automatically",[15,594,595,596,599],{},"Once the integration is active, WhatsApp messages sent to that number appear automatically in your ",[19,597,33],{"href":598},"\u002Fen\u002Fdocs\u002Funified-inbox",", alongside your other WhatsApp channels. No extra step is needed.",[15,601,602],{},[153,603],{"alt":604,"src":605},"The Konektor Inbox with a customer message that came in through the Kapso number","\u002Fimages\u002Fdocs\u002Fkapso-kotak-masuk-pesan.webp",[15,607,608],{},"When you open a conversation, the customer sees blue ticks. When you type a reply, the customer sees that you are typing.",[36,610,612],{"id":611},"test-sending-and-receiving","Test Sending and Receiving",[98,614,615,618,624,627],{},[101,616,617],{},"Send a WhatsApp message from a personal number to the newly connected Kapso number.",[101,619,620,621,623],{},"Open your ",[27,622,33],{}," and confirm the message appears as a new conversation.",[101,625,626],{},"Reply to that message from the Inbox.",[101,628,629,630,632],{},"Confirm your reply arrives on WhatsApp, and its status moves from sent to delivered, then read.",[180,631],{},[153,633],{"alt":634,"src":635},"A reply from the Konektor Inbox marked delivered","\u002Fimages\u002Fdocs\u002Fkapso-kotak-masuk-balas.webp",[36,637,639],{"id":638},"add-a-second-number","Add a Second Number",[98,641,642,648],{},[101,643,644,645,647],{},"Create another Kapso integration in Konektor using the same API key (see ",[27,646,448],{}," above).",[101,649,650],{},"Choose a different number that is not yet connected.",[15,652,653],{},"The number limit follows your Kapso plan (see the table above). Upgrade your Kapso plan first if you have reached the limit.",[36,655,657],{"id":656},"common-failures","Common Failures",[563,659,660,666,672,678,689,703],{},[101,661,662,665],{},[27,663,664],{},"API key rejected"," — check that you copied the whole key and that it has not been revoked in the Kapso dashboard. Create a new key if needed.",[101,667,668,671],{},[27,669,670],{},"No numbers appear in the list"," — make sure number verification finished on Kapso. Use manual entry as a fallback.",[101,673,674,677],{},[27,675,676],{},"A number cannot be selected"," — that number is already connected to another active Kapso integration in this workspace. Choose a different number, or remove the older integration first.",[101,679,680,683,684,409,686,688],{},[27,681,682],{},"The webhook stops receiving messages"," — Kapso pauses a webhook that fails too often. Open ",[27,685,408],{},[27,687,547],{}," on Kapso and turn it back on, or remove the integration in Konektor and connect again.",[101,690,691,694,695,698,699,702],{},[27,692,693],{},"Messages fail to send"," — check that the number connection mode is still active in the Kapso dashboard. ",[27,696,697],{},"Coexistence"," mode can drop on its own; switch to ",[27,700,701],{},"dedicated"," if this keeps happening.",[101,704,705,708,709,712,713,715],{},[27,706,707],{},"Replies arrive slowly"," — a number in ",[27,710,711],{},"coexistence"," mode is capped at about 5 messages per second. Wait a moment, or switch to ",[27,714,701],{}," for higher volume.",[36,717,719],{"id":718},"next-steps","Next Steps",[563,721,722,727],{},[101,723,724],{},[19,725,726],{"href":598},"WhatsApp Inbox",[101,728,729],{},[19,730,732],{"href":731},"\u002Fen\u002Fdocs\u002Fpartner","Konektor Partner Integrations",{"title":734,"searchDepth":735,"depth":735,"links":736},"",2,[737,738,739,747,748,749,750,751,752,753,754],{"id":38,"depth":735,"text":39},{"id":92,"depth":735,"text":93},{"id":124,"depth":735,"text":125,"children":740},[741,743,744,745,746],{"id":160,"depth":742,"text":161},3,{"id":321,"depth":742,"text":322},{"id":351,"depth":742,"text":352},{"id":375,"depth":742,"text":376},{"id":386,"depth":742,"text":387},{"id":399,"depth":735,"text":400},{"id":447,"depth":735,"text":448},{"id":560,"depth":735,"text":561},{"id":591,"depth":735,"text":592},{"id":611,"depth":735,"text":612},{"id":638,"depth":735,"text":639},{"id":656,"depth":735,"text":657},{"id":718,"depth":735,"text":719},"integrations",null,"Guide to connect your official Kapso WhatsApp number to Konektor: add your API key, pick a number, then send and receive messages.","md",{},7,"\u002Fen\u002Fdocs\u002Fpartner\u002Fkapso",{"keywords":763,"canonical":761,"title":5,"description":757},[764,765,766,767,768],"kapso integration","kapso.com","whatsapp cloud api","official waba","coexistence whatsapp",{"loc":761,"images":770,"lastmod":792},[771,772,773,774,775,776,777,778,779,780,781,782,783,784,785,786,787,788,789,790,791],{"loc":156},{"loc":185},{"loc":197},{"loc":217},{"loc":239},{"loc":257},{"loc":269},{"loc":289},{"loc":302},{"loc":315},{"loc":396},{"loc":432},{"loc":441},{"loc":476},{"loc":511},{"loc":524},{"loc":539},{"loc":557},{"loc":588},{"loc":605},{"loc":635},"2026-09-25","en\u002Fdocs\u002Fpartner\u002Fkapso",[795,796,797,798,799],"kapso","whatsapp","cloud api","outbound","integration",true,"lqZe-vIZ9KglD6PkORc9D-Gy0k7PCZgMKZNfX1LufMU"]