[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"doc-\u002Far\u002Fdocs\u002Fdeveloppeurs\u002Fapi-admin":3,"docs-nav-ar":377},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"body":10,"_type":371,"_id":372,"_source":373,"_file":374,"_stem":375,"_extension":376},"\u002Far\u002Fdocs\u002Fdeveloppeurs\u002Fapi-admin","developpeurs",false,"","واجهة برمجة تطبيقات الإدارة (Admin API)","أتمتة betool انطلاقًا من أنظمتك — النماذج، حسابات LLM، الفوترة، الاستهلاك، سجلّات التدقيق.",{"type":11,"children":12,"toc":362},"root",[13,30,36,71,83,95,100,113,119,288,309,315,335,341,346,352,357],{"type":14,"tag":15,"props":16,"children":17},"element","p",{},[18,21,28],{"type":19,"value":20},"text","تعتمد واجهة الإدارة على الويب في betool على واجهة REST مُصادَق عليها (البادئة ",{"type":14,"tag":22,"props":23,"children":25},"code",{"className":24},[],[26],{"type":19,"value":27},"\u002Fapi",{"type":19,"value":29},")، يمكن استخدامها أيضًا من سكربتاتك: لوحات معلومات مخصّصة للاستهلاك، وتصدير السجلّات، ومتابعة رصيد الاعتمادات.",{"type":14,"tag":31,"props":32,"children":34},"h2",{"id":33},"المصادقة",[35],{"type":19,"value":33},{"type":14,"tag":15,"props":37,"children":38},{},[39,41,47,49,55,57,62,64,69],{"type":19,"value":40},"يحمل كل استدعاء ",{"type":14,"tag":42,"props":43,"children":44},"strong",{},[45],{"type":19,"value":46},"رمز جلسة",{"type":19,"value":48}," في ",{"type":14,"tag":22,"props":50,"children":52},{"className":51},[],[53],{"type":19,"value":54},"Authorization: Bearer",{"type":19,"value":56},". وللاستخدام الآلي، أنشئ ",{"type":14,"tag":42,"props":58,"children":59},{},[60],{"type":19,"value":61},"رمز CLI",{"type":19,"value":63}," طويل الأمد من قائمة المؤسسة ← ",{"type":14,"tag":42,"props":65,"children":66},{},[67],{"type":19,"value":68},"« Paramètres de l'organisation » ← رموز واجهة سطر الأوامر",{"type":19,"value":70}," (لا تُعرَض قيمته الصريحة إلا مرة واحدة، قابل للإلغاء في أي وقت، ومُجزَّأ (hashed) على جانب الخادم)، ثم استبدله برمز جلسة:",{"type":14,"tag":72,"props":73,"children":78},"pre",{"className":74,"code":76,"language":77,"meta":7},[75],"language-bash","# 1. استبدال رمز CLI بجلسة (معدّل محدود: 10\u002Fدقيقة)\ncurl -X POST https:\u002F\u002Fplatform.betool.ai\u002Fapi\u002Fauth\u002Fcli-login \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d \"{\\\"token\\\": \\\"$BETOOL_CLI_TOKEN\\\"}\"\n# -> {\"session_token\": \"...\", \"user\": {...}, \"active_org\": {...}, ...}\n\n# 2. استدعاء الواجهة بالجلسة\ncurl -H \"Authorization: Bearer $BETOOL_SESSION\" \\\n  https:\u002F\u002Fplatform.betool.ai\u002Fapi\u002Fauth\u002Fme\n","bash",[79],{"type":14,"tag":22,"props":80,"children":81},{"__ignoreMap":7},[82],{"type":19,"value":76},{"type":14,"tag":15,"props":84,"children":85},{},[86,88,93],{"type":19,"value":87},"رمز CLI مُثبَّت على ",{"type":14,"tag":42,"props":89,"children":90},{},[91],{"type":19,"value":92},"مؤسسة واحدة",{"type":19,"value":94},"؛ ويتوقّف عن العمل إذا عُطِّل حامله أو لم يعد عضوًا نشطًا في هذه المؤسسة. وتتبع الصلاحيات عضويته.",{"type":14,"tag":31,"props":96,"children":98},{"id":97},"التصفية",[99],{"type":19,"value":97},{"type":14,"tag":15,"props":101,"children":102},{},[103,105,111],{"type":19,"value":104},"تقبل نقاط النهاية الخاصة بالقوائم معاملات خاصة بكل مورد (عادةً ",{"type":14,"tag":22,"props":106,"children":108},{"className":107},[],[109],{"type":19,"value":110},"limit",{"type":19,"value":112}," محدود على جانب الخادم)؛ والحقول المتاحة موثَّقة في الاستجابة نفسها.",{"type":14,"tag":31,"props":114,"children":116},{"id":115},"نقاط-النهاية-الرئيسية",[117],{"type":19,"value":118},"نقاط النهاية الرئيسية",{"type":14,"tag":120,"props":121,"children":122},"table",{},[123,142],{"type":14,"tag":124,"props":125,"children":126},"thead",{},[127],{"type":14,"tag":128,"props":129,"children":130},"tr",{},[131,137],{"type":14,"tag":132,"props":133,"children":134},"th",{},[135],{"type":19,"value":136},"نقطة النهاية",{"type":14,"tag":132,"props":138,"children":139},{},[140],{"type":19,"value":141},"الوصف",{"type":14,"tag":143,"props":144,"children":145},"tbody",{},[146,164,181,206,223,240,271],{"type":14,"tag":128,"props":147,"children":148},{},[149,159],{"type":14,"tag":150,"props":151,"children":152},"td",{},[153],{"type":14,"tag":22,"props":154,"children":156},{"className":155},[],[157],{"type":19,"value":158},"GET \u002Fapi\u002Fauth\u002Fme",{"type":14,"tag":150,"props":160,"children":161},{},[162],{"type":19,"value":163},"الهوية، المؤسسة النشطة، العضويات",{"type":14,"tag":128,"props":165,"children":166},{},[167,176],{"type":14,"tag":150,"props":168,"children":169},{},[170],{"type":14,"tag":22,"props":171,"children":173},{"className":172},[],[174],{"type":19,"value":175},"GET \u002Fapi\u002Fadmin\u002Fmodels",{"type":14,"tag":150,"props":177,"children":178},{},[179],{"type":19,"value":180},"سرد النماذج (pipelines)",{"type":14,"tag":128,"props":182,"children":183},{},[184,193],{"type":14,"tag":150,"props":185,"children":186},{},[187],{"type":14,"tag":22,"props":188,"children":190},{"className":189},[],[191],{"type":19,"value":192},"GET \u002Fapi\u002Fadmin\u002Fllm\u002Faccounts",{"type":14,"tag":150,"props":194,"children":195},{},[196,198,204],{"type":19,"value":197},"سرد حسابات LLM (السرّ مُقنَّع، ",{"type":14,"tag":22,"props":199,"children":201},{"className":200},[],[202],{"type":19,"value":203},"has_api_key",{"type":19,"value":205},")",{"type":14,"tag":128,"props":207,"children":208},{},[209,218],{"type":14,"tag":150,"props":210,"children":211},{},[212],{"type":14,"tag":22,"props":213,"children":215},{"className":214},[],[216],{"type":19,"value":217},"GET \u002Fapi\u002Fadmin\u002Fbilling\u002Fstate",{"type":14,"tag":150,"props":219,"children":220},{},[221],{"type":19,"value":222},"الخطة، رصيد الاعتمادات، الشحن التلقائي",{"type":14,"tag":128,"props":224,"children":225},{},[226,235],{"type":14,"tag":150,"props":227,"children":228},{},[229],{"type":14,"tag":22,"props":230,"children":232},{"className":231},[],[233],{"type":19,"value":234},"POST \u002Fapi\u002Fadmin\u002Fbilling\u002Ftopup",{"type":14,"tag":150,"props":236,"children":237},{},[238],{"type":19,"value":239},"شحن يدوي (رابط دفع)",{"type":14,"tag":128,"props":241,"children":242},{},[243,252],{"type":14,"tag":150,"props":244,"children":245},{},[246],{"type":14,"tag":22,"props":247,"children":249},{"className":248},[],[250],{"type":19,"value":251},"GET \u002Fapi\u002Fadmin\u002Fbilling\u002Fusage",{"type":14,"tag":150,"props":253,"children":254},{},[255,257,262,264,270],{"type":19,"value":256},"سجلّ الاستهلاك (",{"type":14,"tag":22,"props":258,"children":260},{"className":259},[],[261],{"type":19,"value":110},{"type":19,"value":263}," ≤ 500، مرشِّح ",{"type":14,"tag":22,"props":265,"children":267},{"className":266},[],[268],{"type":19,"value":269},"source_kind",{"type":19,"value":205},{"type":14,"tag":128,"props":272,"children":273},{},[274,283],{"type":14,"tag":150,"props":275,"children":276},{},[277],{"type":14,"tag":22,"props":278,"children":280},{"className":279},[],[281],{"type":19,"value":282},"GET \u002Fapi\u002Fadmin\u002Fme\u002Fsupervisor-reads",{"type":14,"tag":150,"props":284,"children":285},{},[286],{"type":19,"value":287},"سجلّ تدقيق الوصول العابر للمستأجرين",{"type":14,"tag":15,"props":289,"children":290},{},[291,293,298,300,307],{"type":19,"value":292},"لقيادة ",{"type":14,"tag":42,"props":294,"children":295},{},[296],{"type":19,"value":297},"التهيئة",{"type":19,"value":299}," باللغة الطبيعية (إنشاء\u002Fتحرير pipeline عبر مقترحات، لا تُطبَّق إلا بعد قبولها)، فضِّل ",{"type":14,"tag":301,"props":302,"children":304},"a",{"href":303},"\u002Far\u002Fdocs\u002Fdeveloppeurs\u002Fmcp",[305],{"type":19,"value":306},"خادم MCP",{"type":19,"value":308},": فهو الواجهة المصمَّمة للعملاء الخارجيين.",{"type":14,"tag":31,"props":310,"children":312},{"id":311},"webhooks-الصادرة",[313],{"type":19,"value":314},"webhooks الصادرة",{"type":14,"tag":15,"props":316,"children":317},{},[318,320,326,328,333],{"type":19,"value":319},"تحتاج إلى دفع أحداث نحو أنظمتك؟ أطلِقها من الـpipelines الخاصة بك بالعقدة ",{"type":14,"tag":22,"props":321,"children":323},{"className":322},[],[324],{"type":19,"value":325},"webhook_action",{"type":19,"value":327}," — راجع ",{"type":14,"tag":301,"props":329,"children":331},{"href":330},"\u002Far\u002Fdocs\u002Fdeveloppeurs\u002Fwebhooks-sortants",[332],{"type":19,"value":314},{"type":19,"value":334},".",{"type":14,"tag":31,"props":336,"children":338},{"id":337},"تحديد-معدّل-الطلبات",[339],{"type":19,"value":340},"تحديد معدّل الطلبات",{"type":14,"tag":15,"props":342,"children":343},{},[344],{"type":19,"value":345},"نقاط نهاية المصادقة (التسجيل، تسجيل الدخول، إعادة التعيين) خاضعة لتحديد المعدّل. أما نقاط النهاية الأخرى فلا حصّة منشورة لها حتى اليوم — ويجب أن يبقى الاستخدام الآلي المكثّف معقولًا.",{"type":14,"tag":31,"props":347,"children":349},{"id":348},"حزم-sdk",[350],{"type":19,"value":351},"حزم SDK",{"type":14,"tag":15,"props":353,"children":354},{},[355],{"type":19,"value":356},"لا توجد حزمة SDK رسمية. الواجهة بسيطة بما يكفي لاستهلاكها من أي لغة عبر عميل HTTP.",{"type":14,"tag":15,"props":358,"children":359},{},[360],{"type":19,"value":361},"إذا كتبت حزمة SDK لمؤسستك، فأخبِرنا — وسنُشير إليها.",{"title":7,"searchDepth":363,"depth":363,"links":364},2,[365,366,367,368,369,370],{"id":33,"depth":363,"text":33},{"id":97,"depth":363,"text":97},{"id":115,"depth":363,"text":118},{"id":311,"depth":363,"text":314},{"id":337,"depth":363,"text":340},{"id":348,"depth":363,"text":351},"markdown","content:ar:docs:6.developpeurs:1.api-admin.md","content","ar\u002Fdocs\u002F6.developpeurs\u002F1.api-admin.md","ar\u002Fdocs\u002F6.developpeurs\u002F1.api-admin","md",[378],{"title":379,"_path":380,"children":381},"Ar","\u002Far",[382],{"title":383,"_path":384,"children":385},"Docs","\u002Far\u002Fdocs",[386,399,427,455,468,484,492,553],{"title":387,"_path":388,"children":389},"البدء","\u002Far\u002Fdocs\u002Fdemarrer",[390,393,396],{"title":391,"_path":392},"مرحبًا بك","\u002Far\u002Fdocs\u002Fdemarrer\u002Fbienvenue",{"title":394,"_path":395},"إنشاء حساب","\u002Far\u002Fdocs\u002Fdemarrer\u002Fcreer-un-compte",{"title":397,"_path":398},"ربط مفتاح LLM","\u002Far\u002Fdocs\u002Fdemarrer\u002Fbrancher-llm",{"title":400,"_path":401,"children":402},"القنوات","\u002Far\u002Fdocs\u002Fcanaux",[403,406,409,412,415,418,421,424],{"title":404,"_path":405},"نظرة عامة على القنوات","\u002Far\u002Fdocs\u002Fcanaux\u002Fvue-densemble",{"title":407,"_path":408},"الهاتف في الوقت الفعلي","\u002Far\u002Fdocs\u002Fcanaux\u002Ftelephone",{"title":410,"_path":411},"البريد الإلكتروني","\u002Far\u002Fdocs\u002Fcanaux\u002Femail",{"title":413,"_path":414},"أداة دردشة الويب","\u002Far\u002Fdocs\u002Fcanaux\u002Fchat-widget",{"title":416,"_path":417},"HTTP Webhook","\u002Far\u002Fdocs\u002Fcanaux\u002Fwebhook",{"title":419,"_path":420},"المراسلة (WhatsApp، Messenger، Telegram، Mattermost)","\u002Far\u002Fdocs\u002Fcanaux\u002Fmessageries",{"title":422,"_path":423},"Meta Lead Ads","\u002Far\u002Fdocs\u002Fcanaux\u002Ffacebook-leads",{"title":425,"_path":426},"الجدولة (cron)","\u002Far\u002Fdocs\u002Fcanaux\u002Fschedule",{"title":428,"_path":429,"children":430},"Pipelines","\u002Far\u002Fdocs\u002Fpipelines",[431,434,437,440,443,446,449,452],{"title":432,"_path":433},"المحرّر المرئي","\u002Far\u002Fdocs\u002Fpipelines\u002Fediteur-visuel",{"title":435,"_path":436},"وكلاء الذكاء الاصطناعي","\u002Far\u002Fdocs\u002Fpipelines\u002Fagents",{"title":438,"_path":439},"المشغّلات الحتمية (Operators)","\u002Far\u002Fdocs\u002Fpipelines\u002Foperateurs",{"title":441,"_path":442},"التحكّم في التدفّق","\u002Far\u002Fdocs\u002Fpipelines\u002Fcontrole-flux",{"title":444,"_path":445},"خطوات الكود (Code Steps)","\u002Far\u002Fdocs\u002Fpipelines\u002Fcode-step",{"title":447,"_path":448},"الـPipelines الفرعية","\u002Far\u002Fdocs\u002Fpipelines\u002Fsous-pipelines",{"title":450,"_path":451},"إجراءات بلا كود","\u002Far\u002Fdocs\u002Fpipelines\u002Factions-no-code",{"title":453,"_path":454},"قاعدة المعرفة","\u002Far\u002Fdocs\u002Fpipelines\u002Fbase-de-connaissances",{"title":456,"_path":457,"children":458},"الإشراف","\u002Far\u002Fdocs\u002Fsupervision",[459,462,465],{"title":460,"_path":461},"سجلّ عمليات التنفيذ","\u002Far\u002Fdocs\u002Fsupervision\u002Fexecutions",{"title":463,"_path":464},"الأرصدة والقياس","\u002Far\u002Fdocs\u002Fsupervision\u002Fcredits-metering",{"title":466,"_path":467},"المعايير (Benchmarks)","\u002Far\u002Fdocs\u002Fsupervision\u002Fbenchmarks",{"title":469,"_path":470,"children":471},"الأمن","\u002Far\u002Fdocs\u002Fsecurite",[472,475,478,481],{"title":473,"_path":474},"مبادئ الأمن","\u002Far\u002Fdocs\u002Fsecurite\u002Fprincipes",{"title":476,"_path":477},"تعدّد المستأجرين الصارم","\u002Far\u002Fdocs\u002Fsecurite\u002Fmulti-tenant",{"title":479,"_path":480},"تدقيق GDPR وسجلّ الوصول","\u002Far\u002Fdocs\u002Fsecurite\u002Faudit-rgpd",{"title":482,"_path":483},"النشر السيادي","\u002Far\u002Fdocs\u002Fsecurite\u002Fdeploiement-souverain",{"title":485,"_path":486,"children":487},"المطوّرون","\u002Far\u002Fdocs\u002Fdeveloppeurs",[488,489,490],{"title":8,"_path":4},{"title":314,"_path":330},{"title":491,"_path":303},"قيادة betool من Claude (MCP)",{"title":493,"_path":494,"children":495},"التكاملات","\u002Far\u002Fdocs\u002Fintegrations",[496,499,502,505,508,511,514,517,520,523,526,529,532,535,538,541,544,547,550],{"title":497,"_path":498},"نظرة عامة على التكاملات","\u002Far\u002Fdocs\u002Fintegrations\u002Fvue-densemble",{"title":500,"_path":501},"Stripe","\u002Far\u002Fdocs\u002Fintegrations\u002Fstripe",{"title":503,"_path":504},"GitHub","\u002Far\u002Fdocs\u002Fintegrations\u002Fgithub",{"title":506,"_path":507},"Google","\u002Far\u002Fdocs\u002Fintegrations\u002Fgoogle",{"title":509,"_path":510},"LinkedIn Ads","\u002Far\u002Fdocs\u002Fintegrations\u002Flinkedin-ads",{"title":512,"_path":513},"Kavkom","\u002Far\u002Fdocs\u002Fintegrations\u002Fkavkom",{"title":515,"_path":516},"Jira","\u002Far\u002Fdocs\u002Fintegrations\u002Fjira",{"title":518,"_path":519},"Slack","\u002Far\u002Fdocs\u002Fintegrations\u002Fslack",{"title":521,"_path":522},"الرسائل القصيرة","\u002Far\u002Fdocs\u002Fintegrations\u002Fsms",{"title":524,"_path":525},"Enable Banking (الخدمات المصرفية المفتوحة)","\u002Far\u002Fdocs\u002Fintegrations\u002Fenable-banking",{"title":527,"_path":528},"CRM والتسويق والإنتاجية","\u002Far\u002Fdocs\u002Fintegrations\u002Fcrm-marketing",{"title":530,"_path":531},"HeyGen (الفيديو)","\u002Far\u002Fdocs\u002Fintegrations\u002Fheygen",{"title":533,"_path":534},"La Poste","\u002Far\u002Fdocs\u002Fintegrations\u002Fla-poste",{"title":536,"_path":537},"CRM متخصّص (beTool Application، Qhare)","\u002Far\u002Fdocs\u002Fintegrations\u002Fcrm-metier",{"title":539,"_path":540},"Mitti (الفحص الميداني)","\u002Far\u002Fdocs\u002Fintegrations\u002Fmitti",{"title":542,"_path":543},"Meta (Messenger، الصفحات، Meta Ads)","\u002Far\u002Fdocs\u002Fintegrations\u002Fmeta",{"title":545,"_path":546},"Onoff Business (Beta)","\u002Far\u002Fdocs\u002Fintegrations\u002Fonoff",{"title":548,"_path":549},"Smart Life \u002F Tuya (الأجهزة المتّصلة)","\u002Far\u002Fdocs\u002Fintegrations\u002Fsmart-life",{"title":551,"_path":552},"منتجات beTool (Desktop، Kiosk، Terminal)","\u002Far\u002Fdocs\u002Fintegrations\u002Fproduits-betool",{"title":554,"_path":555,"children":556},"حالات الاستخدام","\u002Far\u002Fdocs\u002Fcas-usage",[557,560,563,566,569,572],{"title":558,"_path":559},"agents أعمال نموذجية","\u002Far\u002Fdocs\u002Fcas-usage\u002Fvue-densemble",{"title":561,"_path":562},"CFO IA","\u002Far\u002Fdocs\u002Fcas-usage\u002Fcfo-ia",{"title":564,"_path":565},"COO IA","\u002Far\u002Fdocs\u002Fcas-usage\u002Fcoo-ia",{"title":567,"_path":568},"CTO IA","\u002Far\u002Fdocs\u002Fcas-usage\u002Fcto-ia",{"title":570,"_path":571},"Product Manager IA","\u002Far\u002Fdocs\u002Fcas-usage\u002Fproduct-manager-ia",{"title":573,"_path":574},"المساعد الشخصي","\u002Far\u002Fdocs\u002Fcas-usage\u002Fassistant-personnel"]