[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"doc-\u002Fit\u002Fdocs\u002Fdeveloppeurs\u002Fapi-admin":3,"docs-nav-it":379},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"body":10,"_type":373,"_id":374,"_source":375,"_file":376,"_stem":377,"_extension":378},"\u002Fit\u002Fdocs\u002Fdeveloppeurs\u002Fapi-admin","developpeurs",false,"","API Admin","Automatizza betool dai tuoi sistemi — modelli, account LLM, fatturazione, consumi, registri di audit.",{"type":11,"children":12,"toc":364},"root",[13,30,37,72,84,96,102,115,121,290,311,317,337,343,348,354,359],{"type":14,"tag":15,"props":16,"children":17},"element","p",{},[18,21,28],{"type":19,"value":20},"text","L'admin web di betool si basa su un'API REST autenticata (prefisso ",{"type":14,"tag":22,"props":23,"children":25},"code",{"className":24},[],[26],{"type":19,"value":27},"\u002Fapi",{"type":19,"value":29},"), utilizzabile anche dai tuoi script: dashboard personalizzate dei consumi, esportazione dei registri, monitoraggio del saldo dei crediti.",{"type":14,"tag":31,"props":32,"children":34},"h2",{"id":33},"autenticazione",[35],{"type":19,"value":36},"Autenticazione",{"type":14,"tag":15,"props":38,"children":39},{},[40,42,48,50,56,58,63,65,70],{"type":19,"value":41},"Ogni chiamata porta un ",{"type":14,"tag":43,"props":44,"children":45},"strong",{},[46],{"type":19,"value":47},"token di sessione",{"type":19,"value":49}," in ",{"type":14,"tag":22,"props":51,"children":53},{"className":52},[],[54],{"type":19,"value":55},"Authorization: Bearer",{"type":19,"value":57},". Per un uso automatizzato, crea un ",{"type":14,"tag":43,"props":59,"children":60},{},[61],{"type":19,"value":62},"token CLI",{"type":19,"value":64}," a lunga durata dal menu dell'organizzazione → ",{"type":14,"tag":43,"props":66,"children":67},{},[68],{"type":19,"value":69},"Impostazioni dell'organizzazione → Token CLI",{"type":19,"value":71}," (il valore in chiaro viene mostrato una sola volta, revocabile in qualsiasi momento, hashato lato server), poi scambialo con un token di sessione:",{"type":14,"tag":73,"props":74,"children":79},"pre",{"className":75,"code":77,"language":78,"meta":7},[76],"language-bash","# 1. Scambiare il token CLI con una sessione (rate limit: 10\u002Fmin)\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. Chiamare l'API con la sessione\ncurl -H \"Authorization: Bearer $BETOOL_SESSION\" \\\n  https:\u002F\u002Fplatform.betool.ai\u002Fapi\u002Fauth\u002Fme\n","bash",[80],{"type":14,"tag":22,"props":81,"children":82},{"__ignoreMap":7},[83],{"type":19,"value":77},{"type":14,"tag":15,"props":85,"children":86},{},[87,89,94],{"type":19,"value":88},"Un token CLI è associato a ",{"type":14,"tag":43,"props":90,"children":91},{},[92],{"type":19,"value":93},"una organizzazione",{"type":19,"value":95},"; smette di funzionare se il suo titolare viene disattivato o non è più membro attivo di questa organizzazione. I diritti seguono la sua membership.",{"type":14,"tag":31,"props":97,"children":99},{"id":98},"filtri",[100],{"type":19,"value":101},"Filtri",{"type":14,"tag":15,"props":103,"children":104},{},[105,107,113],{"type":19,"value":106},"Gli endpoint di elenco accettano parametri propri di ciascuna risorsa (tipicamente un ",{"type":14,"tag":22,"props":108,"children":110},{"className":109},[],[111],{"type":19,"value":112},"limit",{"type":19,"value":114}," limitato lato server); i campi disponibili sono documentati dalla risposta stessa.",{"type":14,"tag":31,"props":116,"children":118},{"id":117},"endpoint-principali",[119],{"type":19,"value":120},"Endpoint principali",{"type":14,"tag":122,"props":123,"children":124},"table",{},[125,144],{"type":14,"tag":126,"props":127,"children":128},"thead",{},[129],{"type":14,"tag":130,"props":131,"children":132},"tr",{},[133,139],{"type":14,"tag":134,"props":135,"children":136},"th",{},[137],{"type":19,"value":138},"Endpoint",{"type":14,"tag":134,"props":140,"children":141},{},[142],{"type":19,"value":143},"Descrizione",{"type":14,"tag":145,"props":146,"children":147},"tbody",{},[148,166,183,208,225,242,273],{"type":14,"tag":130,"props":149,"children":150},{},[151,161],{"type":14,"tag":152,"props":153,"children":154},"td",{},[155],{"type":14,"tag":22,"props":156,"children":158},{"className":157},[],[159],{"type":19,"value":160},"GET \u002Fapi\u002Fauth\u002Fme",{"type":14,"tag":152,"props":162,"children":163},{},[164],{"type":19,"value":165},"Identità, organizzazione attiva, membership",{"type":14,"tag":130,"props":167,"children":168},{},[169,178],{"type":14,"tag":152,"props":170,"children":171},{},[172],{"type":14,"tag":22,"props":173,"children":175},{"className":174},[],[176],{"type":19,"value":177},"GET \u002Fapi\u002Fadmin\u002Fmodels",{"type":14,"tag":152,"props":179,"children":180},{},[181],{"type":19,"value":182},"Elenca i modelli (pipeline)",{"type":14,"tag":130,"props":184,"children":185},{},[186,195],{"type":14,"tag":152,"props":187,"children":188},{},[189],{"type":14,"tag":22,"props":190,"children":192},{"className":191},[],[193],{"type":19,"value":194},"GET \u002Fapi\u002Fadmin\u002Fllm\u002Faccounts",{"type":14,"tag":152,"props":196,"children":197},{},[198,200,206],{"type":19,"value":199},"Elenca gli account LLM (segreto mascherato, ",{"type":14,"tag":22,"props":201,"children":203},{"className":202},[],[204],{"type":19,"value":205},"has_api_key",{"type":19,"value":207},")",{"type":14,"tag":130,"props":209,"children":210},{},[211,220],{"type":14,"tag":152,"props":212,"children":213},{},[214],{"type":14,"tag":22,"props":215,"children":217},{"className":216},[],[218],{"type":19,"value":219},"GET \u002Fapi\u002Fadmin\u002Fbilling\u002Fstate",{"type":14,"tag":152,"props":221,"children":222},{},[223],{"type":19,"value":224},"Piano, saldo dei crediti, ricarica automatica",{"type":14,"tag":130,"props":226,"children":227},{},[228,237],{"type":14,"tag":152,"props":229,"children":230},{},[231],{"type":14,"tag":22,"props":232,"children":234},{"className":233},[],[235],{"type":19,"value":236},"POST \u002Fapi\u002Fadmin\u002Fbilling\u002Ftopup",{"type":14,"tag":152,"props":238,"children":239},{},[240],{"type":19,"value":241},"Ricarica manuale (link di pagamento)",{"type":14,"tag":130,"props":243,"children":244},{},[245,254],{"type":14,"tag":152,"props":246,"children":247},{},[248],{"type":14,"tag":22,"props":249,"children":251},{"className":250},[],[252],{"type":19,"value":253},"GET \u002Fapi\u002Fadmin\u002Fbilling\u002Fusage",{"type":14,"tag":152,"props":255,"children":256},{},[257,259,264,266,272],{"type":19,"value":258},"Registro dei consumi (",{"type":14,"tag":22,"props":260,"children":262},{"className":261},[],[263],{"type":19,"value":112},{"type":19,"value":265}," ≤ 500, filtro ",{"type":14,"tag":22,"props":267,"children":269},{"className":268},[],[270],{"type":19,"value":271},"source_kind",{"type":19,"value":207},{"type":14,"tag":130,"props":274,"children":275},{},[276,285],{"type":14,"tag":152,"props":277,"children":278},{},[279],{"type":14,"tag":22,"props":280,"children":282},{"className":281},[],[283],{"type":19,"value":284},"GET \u002Fapi\u002Fadmin\u002Fme\u002Fsupervisor-reads",{"type":14,"tag":152,"props":286,"children":287},{},[288],{"type":19,"value":289},"Registro di audit degli accessi cross-tenant",{"type":14,"tag":15,"props":291,"children":292},{},[293,295,300,302,309],{"type":19,"value":294},"Per pilotare la ",{"type":14,"tag":43,"props":296,"children":297},{},[298],{"type":19,"value":299},"configurazione",{"type":19,"value":301}," in linguaggio naturale (creare\u002Fmodificare una pipeline tramite proposte, applicate solo una volta accettate), preferisci il ",{"type":14,"tag":303,"props":304,"children":306},"a",{"href":305},"\u002Fit\u002Fdocs\u002Fdeveloppeurs\u002Fmcp",[307],{"type":19,"value":308},"server MCP",{"type":19,"value":310},": è la superficie progettata per i client esterni.",{"type":14,"tag":31,"props":312,"children":314},{"id":313},"webhook-in-uscita",[315],{"type":19,"value":316},"Webhook in uscita",{"type":14,"tag":15,"props":318,"children":319},{},[320,322,328,330,335],{"type":19,"value":321},"Hai bisogno di inviare eventi ai tuoi sistemi? Emettili dalle tue pipeline con il nodo ",{"type":14,"tag":22,"props":323,"children":325},{"className":324},[],[326],{"type":19,"value":327},"webhook_action",{"type":19,"value":329}," — vedi ",{"type":14,"tag":303,"props":331,"children":333},{"href":332},"\u002Fit\u002Fdocs\u002Fdeveloppeurs\u002Fwebhooks-sortants",[334],{"type":19,"value":316},{"type":19,"value":336},".",{"type":14,"tag":31,"props":338,"children":340},{"id":339},"limitazione-della-frequenza",[341],{"type":19,"value":342},"Limitazione della frequenza",{"type":14,"tag":15,"props":344,"children":345},{},[346],{"type":19,"value":347},"Gli endpoint di autenticazione (registrazione, login, reimpostazione) hanno un rate limit. Gli altri endpoint non hanno, a oggi, una quota pubblicata — un uso automatizzato intensivo deve restare ragionevole.",{"type":14,"tag":31,"props":349,"children":351},{"id":350},"sdk",[352],{"type":19,"value":353},"SDK",{"type":14,"tag":15,"props":355,"children":356},{},[357],{"type":19,"value":358},"Nessun SDK ufficiale. L'API è abbastanza semplice da essere consumata da qualsiasi linguaggio con un client HTTP.",{"type":14,"tag":15,"props":360,"children":361},{},[362],{"type":19,"value":363},"Se scrivi un SDK per la tua organizzazione, segnalacelo — lo elencheremo.",{"title":7,"searchDepth":365,"depth":365,"links":366},2,[367,368,369,370,371,372],{"id":33,"depth":365,"text":36},{"id":98,"depth":365,"text":101},{"id":117,"depth":365,"text":120},{"id":313,"depth":365,"text":316},{"id":339,"depth":365,"text":342},{"id":350,"depth":365,"text":353},"markdown","content:it:docs:6.developpeurs:1.api-admin.md","content","it\u002Fdocs\u002F6.developpeurs\u002F1.api-admin.md","it\u002Fdocs\u002F6.developpeurs\u002F1.api-admin","md",[380],{"title":381,"_path":382,"children":383},"It","\u002Fit",[384],{"title":385,"_path":386,"children":387},"Docs","\u002Fit\u002Fdocs",[388,401,429,457,470,486,494,555],{"title":389,"_path":390,"children":391},"Per iniziare","\u002Fit\u002Fdocs\u002Fdemarrer",[392,395,398],{"title":393,"_path":394},"Benvenuto","\u002Fit\u002Fdocs\u002Fdemarrer\u002Fbienvenue",{"title":396,"_path":397},"Creare un account","\u002Fit\u002Fdocs\u002Fdemarrer\u002Fcreer-un-compte",{"title":399,"_path":400},"Collegare una chiave LLM","\u002Fit\u002Fdocs\u002Fdemarrer\u002Fbrancher-llm",{"title":402,"_path":403,"children":404},"Canali","\u002Fit\u002Fdocs\u002Fcanaux",[405,408,411,414,417,420,423,426],{"title":406,"_path":407},"Panoramica dei canali","\u002Fit\u002Fdocs\u002Fcanaux\u002Fvue-densemble",{"title":409,"_path":410},"Telefonia in tempo reale","\u002Fit\u002Fdocs\u002Fcanaux\u002Ftelephone",{"title":412,"_path":413},"Email","\u002Fit\u002Fdocs\u002Fcanaux\u002Femail",{"title":415,"_path":416},"Widget chat web","\u002Fit\u002Fdocs\u002Fcanaux\u002Fchat-widget",{"title":418,"_path":419},"Webhook HTTP","\u002Fit\u002Fdocs\u002Fcanaux\u002Fwebhook",{"title":421,"_path":422},"Messaggistica (WhatsApp, Messenger, Telegram, Mattermost)","\u002Fit\u002Fdocs\u002Fcanaux\u002Fmessageries",{"title":424,"_path":425},"Meta Lead Ads","\u002Fit\u002Fdocs\u002Fcanaux\u002Ffacebook-leads",{"title":427,"_path":428},"Schedule (cron)","\u002Fit\u002Fdocs\u002Fcanaux\u002Fschedule",{"title":430,"_path":431,"children":432},"Pipeline","\u002Fit\u002Fdocs\u002Fpipelines",[433,436,439,442,445,448,451,454],{"title":434,"_path":435},"L'editor visuale","\u002Fit\u002Fdocs\u002Fpipelines\u002Fediteur-visuel",{"title":437,"_path":438},"Agenti IA","\u002Fit\u002Fdocs\u002Fpipelines\u002Fagents",{"title":440,"_path":441},"Operatori deterministici","\u002Fit\u002Fdocs\u002Fpipelines\u002Foperateurs",{"title":443,"_path":444},"Controllo di flusso","\u002Fit\u002Fdocs\u002Fpipelines\u002Fcontrole-flux",{"title":446,"_path":447},"Code Step","\u002Fit\u002Fdocs\u002Fpipelines\u002Fcode-step",{"title":449,"_path":450},"Sotto-pipeline","\u002Fit\u002Fdocs\u002Fpipelines\u002Fsous-pipelines",{"title":452,"_path":453},"Azioni no-code","\u002Fit\u002Fdocs\u002Fpipelines\u002Factions-no-code",{"title":455,"_path":456},"Base di conoscenza","\u002Fit\u002Fdocs\u002Fpipelines\u002Fbase-de-connaissances",{"title":458,"_path":459,"children":460},"Supervisione","\u002Fit\u002Fdocs\u002Fsupervision",[461,464,467],{"title":462,"_path":463},"Cronologia delle esecuzioni","\u002Fit\u002Fdocs\u002Fsupervision\u002Fexecutions",{"title":465,"_path":466},"Crediti e metering","\u002Fit\u002Fdocs\u002Fsupervision\u002Fcredits-metering",{"title":468,"_path":469},"Benchmark","\u002Fit\u002Fdocs\u002Fsupervision\u002Fbenchmarks",{"title":471,"_path":472,"children":473},"Sicurezza","\u002Fit\u002Fdocs\u002Fsecurite",[474,477,480,483],{"title":475,"_path":476},"Principi di sicurezza","\u002Fit\u002Fdocs\u002Fsecurite\u002Fprincipes",{"title":478,"_path":479},"Multi-tenancy rigorosa","\u002Fit\u002Fdocs\u002Fsecurite\u002Fmulti-tenant",{"title":481,"_path":482},"Audit RGPD e registro degli accessi","\u002Fit\u002Fdocs\u002Fsecurite\u002Faudit-rgpd",{"title":484,"_path":485},"Deployment sovrano","\u002Fit\u002Fdocs\u002Fsecurite\u002Fdeploiement-souverain",{"title":487,"_path":488,"children":489},"Sviluppatori","\u002Fit\u002Fdocs\u002Fdeveloppeurs",[490,491,492],{"title":8,"_path":4},{"title":316,"_path":332},{"title":493,"_path":305},"Pilotare betool da Claude (MCP)",{"title":495,"_path":496,"children":497},"Integrazioni","\u002Fit\u002Fdocs\u002Fintegrations",[498,501,504,507,510,513,516,519,522,525,528,531,534,537,540,543,546,549,552],{"title":499,"_path":500},"Panoramica delle integrazioni","\u002Fit\u002Fdocs\u002Fintegrations\u002Fvue-densemble",{"title":502,"_path":503},"Stripe","\u002Fit\u002Fdocs\u002Fintegrations\u002Fstripe",{"title":505,"_path":506},"GitHub","\u002Fit\u002Fdocs\u002Fintegrations\u002Fgithub",{"title":508,"_path":509},"Google","\u002Fit\u002Fdocs\u002Fintegrations\u002Fgoogle",{"title":511,"_path":512},"LinkedIn Ads","\u002Fit\u002Fdocs\u002Fintegrations\u002Flinkedin-ads",{"title":514,"_path":515},"Kavkom","\u002Fit\u002Fdocs\u002Fintegrations\u002Fkavkom",{"title":517,"_path":518},"Jira","\u002Fit\u002Fdocs\u002Fintegrations\u002Fjira",{"title":520,"_path":521},"Slack","\u002Fit\u002Fdocs\u002Fintegrations\u002Fslack",{"title":523,"_path":524},"SMS","\u002Fit\u002Fdocs\u002Fintegrations\u002Fsms",{"title":526,"_path":527},"Enable Banking (open banking)","\u002Fit\u002Fdocs\u002Fintegrations\u002Fenable-banking",{"title":529,"_path":530},"CRM, marketing e produttività","\u002Fit\u002Fdocs\u002Fintegrations\u002Fcrm-marketing",{"title":532,"_path":533},"HeyGen (video)","\u002Fit\u002Fdocs\u002Fintegrations\u002Fheygen",{"title":535,"_path":536},"La Poste","\u002Fit\u002Fdocs\u002Fintegrations\u002Fla-poste",{"title":538,"_path":539},"CRM verticali (beTool Application, Qhare)","\u002Fit\u002Fdocs\u002Fintegrations\u002Fcrm-metier",{"title":541,"_path":542},"Mitti (ispezioni sul campo)","\u002Fit\u002Fdocs\u002Fintegrations\u002Fmitti",{"title":544,"_path":545},"Meta (Messenger, Pagine, Meta Ads)","\u002Fit\u002Fdocs\u002Fintegrations\u002Fmeta",{"title":547,"_path":548},"Onoff Business (Beta)","\u002Fit\u002Fdocs\u002Fintegrations\u002Fonoff",{"title":550,"_path":551},"Smart Life \u002F Tuya (oggetti connessi)","\u002Fit\u002Fdocs\u002Fintegrations\u002Fsmart-life",{"title":553,"_path":554},"Prodotti beTool (Desktop, Kiosk, Terminal)","\u002Fit\u002Fdocs\u002Fintegrations\u002Fproduits-betool",{"title":556,"_path":557,"children":558},"Casi d'uso","\u002Fit\u002Fdocs\u002Fcas-usage",[559,562,565,568,571,574],{"title":560,"_path":561},"Agenti di business tipo","\u002Fit\u002Fdocs\u002Fcas-usage\u002Fvue-densemble",{"title":563,"_path":564},"CFO IA","\u002Fit\u002Fdocs\u002Fcas-usage\u002Fcfo-ia",{"title":566,"_path":567},"COO IA","\u002Fit\u002Fdocs\u002Fcas-usage\u002Fcoo-ia",{"title":569,"_path":570},"CTO IA","\u002Fit\u002Fdocs\u002Fcas-usage\u002Fcto-ia",{"title":572,"_path":573},"Product Manager IA","\u002Fit\u002Fdocs\u002Fcas-usage\u002Fproduct-manager-ia",{"title":575,"_path":576},"Assistente personale","\u002Fit\u002Fdocs\u002Fcas-usage\u002Fassistant-personnel"]