[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-id-\u002Fdocs\u002Fapi\u002Fagent-api":3},{"id":4,"title":5,"body":6,"category":888,"code_examples":889,"demos":889,"description":890,"extension":891,"meta":892,"navigation":889,"order":691,"path":893,"seo":894,"sitemap":904,"stem":906,"tags":907,"toc":913,"videos":889,"__hash__":914},"docs\u002Fdocs\u002Fapi\u002Fagent-api.md","Agent API v2 - API untuk AI Agent",{"type":7,"value":8,"toc":868},"minimark",[9,14,18,23,26,29,40,43,47,50,55,63,143,147,150,155,158,162,165,171,175,178,212,216,219,257,261,513,524,538,572,576,579,624,627,647,651,654,803,824,828,842,846,852,856,859,864],[10,11,13],"h1",{"id":12},"agent-api-v2-api-untuk-ai-agent","Agent API v2 — API untuk AI Agent",[15,16,17],"p",{},"Agent API v2 adalah namespace API khusus yang dirancang untuk AI Agent, LLM, dan automation tool. Dengan Agent API, AI Agent Anda dapat mengakses dan mengelola data lead, menarik analytics, memantau conversion tracking, dan mendapatkan informasi workspace — semuanya melalui endpoint yang aman dan terstruktur.",[19,20,22],"h2",{"id":21},"apa-itu-skillmd","Apa itu SKILL.md?",[15,24,25],{},"SKILL.md adalah dokumen machine-readable yang menjelaskan seluruh kemampuan Agent API Konektor. AI Agent membaca file ini untuk memahami endpoint apa saja yang tersedia, parameter yang dibutuhkan, dan format response yang dikembalikan.",[15,27,28],{},"URL SKILL.md Anda:",[30,31,37],"pre",{"className":32,"code":34,"language":35,"meta":36},[33],"language-text","https:\u002F\u002Fkonektor.id\u002Fapi\u002Fv2\u002Fagent\u002FSKILL.md\n","text","",[38,39,34],"code",{"__ignoreMap":36},[15,41,42],{},"SKILL.md bersifat publik dan tidak memerlukan autentikasi. AI Agent manapun dapat mengaksesnya langsung.",[19,44,46],{"id":45},"cara-menghubungkan-ai-agent","Cara Menghubungkan AI Agent",[15,48,49],{},"Untuk menghubungkan AI Agent (seperti OpenClaw, ChatGPT, Claude, atau tool automation lainnya) ke workspace Konektor Anda:",[51,52,54],"h3",{"id":53},"_1-buat-api-key-dengan-scope-agent","1. Buat API Key dengan Scope Agent",[15,56,57,58,62],{},"Buka ",[59,60,61],"strong",{},"Settings → API Keys"," di dashboard workspace Anda, lalu buat API key baru dengan scope yang dibutuhkan:",[64,65,66,79],"table",{},[67,68,69],"thead",{},[70,71,72,76],"tr",{},[73,74,75],"th",{},"Scope",[73,77,78],{},"Akses",[80,81,82,93,103,113,123,133],"tbody",{},[70,83,84,90],{},[85,86,87],"td",{},[38,88,89],{},"agent.leads.read",[85,91,92],{},"Membaca data lead (list, detail)",[70,94,95,100],{},[85,96,97],{},[38,98,99],{},"agent.leads.write",[85,101,102],{},"Membuat, mengupdate, dan upsert lead",[70,104,105,110],{},[85,106,107],{},[38,108,109],{},"agent.analytics.read",[85,111,112],{},"Membaca analytics (summary, funnel, campaign)",[70,114,115,120],{},[85,116,117],{},[38,118,119],{},"agent.conversions.read",[85,121,122],{},"Membaca status conversion sync",[70,124,125,130],{},[85,126,127],{},[38,128,129],{},"agent.workspace.read",[85,131,132],{},"Membaca info workspace dan subscription",[70,134,135,140],{},[85,136,137],{},[38,138,139],{},"agent.support.write",[85,141,142],{},"Membuat support ticket",[51,144,146],{"id":145},"_2-berikan-skillmd-ke-ai-agent-anda","2. Berikan SKILL.md ke AI Agent Anda",[15,148,149],{},"Berikan URL berikut ke AI Agent Anda:",[30,151,153],{"className":152,"code":34,"language":35,"meta":36},[33],[38,154,34],{"__ignoreMap":36},[15,156,157],{},"AI Agent akan membaca dokumen ini dan memahami cara berinteraksi dengan API Konektor. Setiap AI Agent yang mendukung format SKILL.md dapat langsung terhubung.",[51,159,161],{"id":160},"_3-konfigurasi-api-key-di-ai-agent","3. Konfigurasi API Key di AI Agent",[15,163,164],{},"Masukkan API key yang sudah dibuat ke konfigurasi AI Agent Anda. AI Agent akan menggunakan key ini untuk autentikasi setiap request:",[30,166,169],{"className":167,"code":168,"language":35,"meta":36},[33],"Authorization: Bearer \u003Capi_key_anda>\n",[38,170,168],{"__ignoreMap":36},[19,172,174],{"id":173},"apa-yang-bisa-dilakukan-ai-agent","Apa yang Bisa Dilakukan AI Agent?",[15,176,177],{},"Setelah terhubung, AI Agent Anda dapat:",[179,180,181,188,194,200,206],"ul",{},[182,183,184,187],"li",{},[59,185,186],{},"Analisa data lead"," — Menarik summary, funnel, dan performa campaign secara real-time",[182,189,190,193],{},[59,191,192],{},"Manage lead"," — Membuat lead baru, mengupdate status, melakukan scoring",[182,195,196,199],{},[59,197,198],{},"Monitor conversion"," — Memantau status sync conversion ke Meta, Google, TikTok",[182,201,202,205],{},[59,203,204],{},"Cek workspace"," — Melihat info subscription, usage, dan konfigurasi workspace",[182,207,208,211],{},[59,209,210],{},"Buat support ticket"," — Mengirim support ticket langsung dari AI Agent",[51,213,215],{"id":214},"contoh-penggunaan","Contoh Penggunaan",[15,217,218],{},"Berikut beberapa contoh perintah yang bisa Anda berikan ke AI Agent:",[179,220,221,227,232,237,242,247,252],{},[182,222,223],{},[224,225,226],"em",{},"\"Berapa total lead baru minggu ini?\"",[182,228,229],{},[224,230,231],{},"\"Tampilkan funnel conversion bulan ini\"",[182,233,234],{},[224,235,236],{},"\"Campaign mana yang paling banyak menghasilkan lead?\"",[182,238,239],{},[224,240,241],{},"\"Update status lead CRM-1024 ke qualified\"",[182,243,244],{},[224,245,246],{},"\"Buat lead baru dari form submission ini\"",[182,248,249],{},[224,250,251],{},"\"Ada berapa conversion yang gagal sync?\"",[182,253,254],{},[224,255,256],{},"\"Buat support ticket tentang tracking pixel yang tidak jalan\"",[19,258,260],{"id":259},"endpoint-yang-tersedia","Endpoint yang Tersedia",[64,262,263,278],{},[67,264,265],{},[70,266,267,270,273,275],{},[73,268,269],{},"Method",[73,271,272],{},"Path",[73,274,75],{},[73,276,277],{},"Keterangan",[80,279,280,298,316,334,352,370,388,406,424,442,460,478,496],{},[70,281,282,287,292,295],{},[85,283,284],{},[38,285,286],{},"GET",[85,288,289],{},[38,290,291],{},"\u002Fapi\u002Fv2\u002Fagent\u002FSKILL.md",[85,293,294],{},"—",[85,296,297],{},"Dokumentasi machine-readable (publik)",[70,299,300,304,309,313],{},[85,301,302],{},[38,303,286],{},[85,305,306],{},[38,307,308],{},"\u002Fapi\u002Fv2\u002Fagent\u002Fleads",[85,310,311],{},[38,312,89],{},[85,314,315],{},"List leads dengan filter dan pagination",[70,317,318,322,327,331],{},[85,319,320],{},[38,321,286],{},[85,323,324],{},[38,325,326],{},"\u002Fapi\u002Fv2\u002Fagent\u002Fleads\u002F:id",[85,328,329],{},[38,330,89],{},[85,332,333],{},"Detail lead",[70,335,336,341,345,349],{},[85,337,338],{},[38,339,340],{},"POST",[85,342,343],{},[38,344,308],{},[85,346,347],{},[38,348,99],{},[85,350,351],{},"Buat lead baru",[70,353,354,358,363,367],{},[85,355,356],{},[38,357,340],{},[85,359,360],{},[38,361,362],{},"\u002Fapi\u002Fv2\u002Fagent\u002Fleads\u002Fupsert",[85,364,365],{},[38,366,99],{},[85,368,369],{},"Upsert lead berdasarkan id\u002FuniqueCode\u002Fphone\u002FexternalRef",[70,371,372,377,381,385],{},[85,373,374],{},[38,375,376],{},"PATCH",[85,378,379],{},[38,380,326],{},[85,382,383],{},[38,384,99],{},[85,386,387],{},"Update lead",[70,389,390,394,399,403],{},[85,391,392],{},[38,393,286],{},[85,395,396],{},[38,397,398],{},"\u002Fapi\u002Fv2\u002Fagent\u002Fanalytics\u002Fsummary",[85,400,401],{},[38,402,109],{},[85,404,405],{},"Ringkasan analytics",[70,407,408,412,417,421],{},[85,409,410],{},[38,411,286],{},[85,413,414],{},[38,415,416],{},"\u002Fapi\u002Fv2\u002Fagent\u002Fanalytics\u002Ffunnel",[85,418,419],{},[38,420,109],{},[85,422,423],{},"Funnel per status",[70,425,426,430,435,439],{},[85,427,428],{},[38,429,286],{},[85,431,432],{},[38,433,434],{},"\u002Fapi\u002Fv2\u002Fagent\u002Fanalytics\u002Fcampaigns",[85,436,437],{},[38,438,109],{},[85,440,441],{},"Performa campaign",[70,443,444,448,453,457],{},[85,445,446],{},[38,447,286],{},[85,449,450],{},[38,451,452],{},"\u002Fapi\u002Fv2\u002Fagent\u002Fconversions\u002Fstatus",[85,454,455],{},[38,456,119],{},[85,458,459],{},"Status sync conversion",[70,461,462,466,471,475],{},[85,463,464],{},[38,465,286],{},[85,467,468],{},[38,469,470],{},"\u002Fapi\u002Fv2\u002Fagent\u002Fconversions\u002Fpending",[85,472,473],{},[38,474,119],{},[85,476,477],{},"Conversion pending\u002Fgagal",[70,479,480,484,489,493],{},[85,481,482],{},[38,483,286],{},[85,485,486],{},[38,487,488],{},"\u002Fapi\u002Fv2\u002Fagent\u002Fworkspace",[85,490,491],{},[38,492,129],{},[85,494,495],{},"Info workspace",[70,497,498,502,507,511],{},[85,499,500],{},[38,501,340],{},[85,503,504],{},[38,505,506],{},"\u002Fapi\u002Fv2\u002Fagent\u002Fsupport\u002Ftickets",[85,508,509],{},[38,510,139],{},[85,512,210],{},[51,514,516,517,520,521],{"id":515},"catatan-query-from-dan-to","Catatan Query ",[38,518,519],{},"from"," dan ",[38,522,523],{},"to",[15,525,526,527,530,531,530,534,537],{},"Untuk endpoint analytics (",[38,528,529],{},"summary",", ",[38,532,533],{},"funnel",[38,535,536],{},"campaigns",") dan conversion status:",[179,539,540,552,558,563],{},[182,541,542,543,545,546,548,549],{},"Jika ",[38,544,519],{}," atau ",[38,547,523],{}," diisi, filter custom range akan override ",[38,550,551],{},"timeframe",[182,553,554,555,557],{},"Jika hanya ",[38,556,519],{}," yang diisi, range dianggap terbuka sampai waktu sekarang",[182,559,554,560,562],{},[38,561,523],{}," yang diisi, range dianggap terbuka dari data paling awal",[182,564,542,565,568,569],{},[38,566,567],{},"from > to",", API mengembalikan ",[38,570,571],{},"VALIDATION_ERROR",[19,573,575],{"id":574},"rate-limit","Rate Limit",[15,577,578],{},"Rate limit berbasis plan dan berlaku per workspace (shared antar semua API key):",[64,580,581,591],{},[67,582,583],{},[70,584,585,588],{},[73,586,587],{},"Plan",[73,589,590],{},"Limit",[80,592,593,601,609,617],{},[70,594,595,598],{},[85,596,597],{},"Starter",[85,599,600],{},"60 req\u002Fmenit",[70,602,603,606],{},[85,604,605],{},"Pro",[85,607,608],{},"200 req\u002Fmenit",[70,610,611,614],{},[85,612,613],{},"Enterprise",[85,615,616],{},"600 req\u002Fmenit",[70,618,619,622],{},[85,620,621],{},"Custom",[85,623,608],{},[15,625,626],{},"Setiap response terautentikasi menyertakan header rate limit (termasuk saat auth-throttle):",[179,628,629,635,641],{},[182,630,631,634],{},[38,632,633],{},"X-RateLimit-Limit"," — Maksimum request per menit",[182,636,637,640],{},[38,638,639],{},"X-RateLimit-Remaining"," — Sisa request di window saat ini",[182,642,643,646],{},[38,644,645],{},"X-RateLimit-Reset"," — Timestamp reset window (Unix seconds)",[19,648,650],{"id":649},"format-error","Format Error",[15,652,653],{},"Semua error menggunakan format JSON yang konsisten:",[30,655,659],{"className":656,"code":657,"language":658,"meta":36,"style":36},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"VALIDATION_ERROR\",\n    \"message\": \"Invalid lead data\",\n    \"details\": {\n      \"firstName\": \"Required\"\n    }\n  }\n}\n","json",[38,660,661,670,689,704,728,749,763,785,791,797],{"__ignoreMap":36},[662,663,666],"span",{"class":664,"line":665},"line",1,[662,667,669],{"class":668},"sMK4o","{\n",[662,671,673,676,680,683,686],{"class":664,"line":672},2,[662,674,675],{"class":668},"  \"",[662,677,679],{"class":678},"spNyl","success",[662,681,682],{"class":668},"\"",[662,684,685],{"class":668},":",[662,687,688],{"class":668}," false,\n",[662,690,692,694,697,699,701],{"class":664,"line":691},3,[662,693,675],{"class":668},[662,695,696],{"class":678},"error",[662,698,682],{"class":668},[662,700,685],{"class":668},[662,702,703],{"class":668}," {\n",[662,705,707,710,713,715,717,720,723,725],{"class":664,"line":706},4,[662,708,709],{"class":668},"    \"",[662,711,38],{"class":712},"sBMFI",[662,714,682],{"class":668},[662,716,685],{"class":668},[662,718,719],{"class":668}," \"",[662,721,571],{"class":722},"sfazB",[662,724,682],{"class":668},[662,726,727],{"class":668},",\n",[662,729,731,733,736,738,740,742,745,747],{"class":664,"line":730},5,[662,732,709],{"class":668},[662,734,735],{"class":712},"message",[662,737,682],{"class":668},[662,739,685],{"class":668},[662,741,719],{"class":668},[662,743,744],{"class":722},"Invalid lead data",[662,746,682],{"class":668},[662,748,727],{"class":668},[662,750,752,754,757,759,761],{"class":664,"line":751},6,[662,753,709],{"class":668},[662,755,756],{"class":712},"details",[662,758,682],{"class":668},[662,760,685],{"class":668},[662,762,703],{"class":668},[662,764,766,769,773,775,777,779,782],{"class":664,"line":765},7,[662,767,768],{"class":668},"      \"",[662,770,772],{"class":771},"sbssI","firstName",[662,774,682],{"class":668},[662,776,685],{"class":668},[662,778,719],{"class":668},[662,780,781],{"class":722},"Required",[662,783,784],{"class":668},"\"\n",[662,786,788],{"class":664,"line":787},8,[662,789,790],{"class":668},"    }\n",[662,792,794],{"class":664,"line":793},9,[662,795,796],{"class":668},"  }\n",[662,798,800],{"class":664,"line":799},10,[662,801,802],{"class":668},"}\n",[15,804,805,806,530,809,530,812,530,814,530,817,530,820,823],{},"Kode error yang mungkin: ",[38,807,808],{},"UNAUTHORIZED",[38,810,811],{},"FORBIDDEN",[38,813,571],{},[38,815,816],{},"NOT_FOUND",[38,818,819],{},"RATE_LIMITED",[38,821,822],{},"INTERNAL_ERROR",".",[19,825,827],{"id":826},"keamanan","Keamanan",[179,829,830,833,836,839],{},[182,831,832],{},"Semua data PII (nama, email, phone) dienkripsi at-rest",[182,834,835],{},"API key mendukung IP allowlist untuk membatasi akses",[182,837,838],{},"Scope-based access control memastikan AI Agent hanya bisa mengakses data yang diizinkan",[182,840,841],{},"Analytics endpoint hanya mengembalikan data agregat, tanpa PII",[19,843,845],{"id":844},"persyaratan-plan","Persyaratan Plan",[15,847,848,849,851],{},"Agent API tersedia untuk plan ",[59,850,597],{}," ke atas. Plan Trial dan Free tidak dapat mengakses Agent API.",[19,853,855],{"id":854},"referensi-lengkap","Referensi Lengkap",[15,857,858],{},"Untuk dokumentasi teknis lengkap (parameter, contoh request\u002Fresponse, dan nilai enum), baca langsung SKILL.md:",[30,860,862],{"className":861,"code":34,"language":35,"meta":36},[33],[38,863,34],{"__ignoreMap":36},[865,866,867],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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":36,"searchDepth":672,"depth":672,"links":869},[870,871,876,879,883,884,885,886,887],{"id":21,"depth":672,"text":22},{"id":45,"depth":672,"text":46,"children":872},[873,874,875],{"id":53,"depth":691,"text":54},{"id":145,"depth":691,"text":146},{"id":160,"depth":691,"text":161},{"id":173,"depth":672,"text":174,"children":877},[878],{"id":214,"depth":691,"text":215},{"id":259,"depth":672,"text":260,"children":880},[881],{"id":515,"depth":691,"text":882},"Catatan Query from dan to",{"id":574,"depth":672,"text":575},{"id":649,"depth":672,"text":650},{"id":826,"depth":672,"text":827},{"id":844,"depth":672,"text":845},{"id":854,"depth":672,"text":855},"api",null,"Dokumentasi Agent API v2 Konektor untuk menghubungkan AI Agent seperti OpenClaw, ChatGPT, Claude, dan automation tool lainnya ke workspace Konektor Anda.","md",{},"\u002Fdocs\u002Fapi\u002Fagent-api",{"title":895,"description":896,"keywords":897,"canonical":893},"Konektor Agent API v2 - Hubungkan AI Agent ke Workspace Anda","Berikan AI Agent Anda akses ke data lead, analytics, dan conversion tracking Konektor melalui Agent API v2 dengan SKILL.md.",[898,899,900,901,902,903],"konektor agent api","ai agent api","skill.md","openclaw","llm integration","lead management ai",{"loc":893,"lastmod":905},"2026-03-28","docs\u002Fapi\u002Fagent-api",[888,908,909,910,911,912],"agent-api","ai-agent","llm","automation","skill-md",true,"celDbW3_myEMoh3AZlzCnb1poIrJscKISKP8fKQdlLw"]