Account SoWay (cliente)
L'account SoWay di chi è entrato come cliente dall'indirizzo di servizio di SoWay: cos'è SoWay, i livelli di abbonamento con i prezzi, la scelta e il link di pagamento, e soprattutto come collegare la propria AI al proprio spazio, dove stanno gli strumenti veri.
Quando si usa. Usala quando la persona è collegata come cliente all'indirizzo di servizio di SoWay (non al dominio di un'azienda). Da qui non si toccano i dati dell'attività: per quelli bisogna collegarsi al proprio spazio (come-mi-collego).
- Livello: compreso dal livello 1.
Le 7 azioni
cosa-e-soway Spiega in breve cos'è SoWay, cosa si può fare da qui (vedere e pagare un abbonamento, imparare a collegarsi) e cosa no, e quanti strumenti ci sono nel proprio spazio.come-mi-collego Dà l'indirizzo dello spazio della persona e le istruzioni per collegarci la sua AI (Claude Code, ChatGPT, Claude Desktop), con il comando pronto. Se non ha ancora uno spazio, dà il link per registrarsi.abbonamenti Elenca i livelli di abbonamento letti dal catalogo vero: numero, nome, prezzo al mese (o «su richiesta»), quanti strumenti comprende, descrizione.aggiungi-al-carrello Sceglie un livello di abbonamento e lo mette nel carrello. Il carrello tiene un solo abbonamento: sceglierne un altro sostituisce il precedente. Non paga nulla.carrello Mostra il livello scelto con aggiungi-al-carrello. Il carrello è tenuto in memoria per poco e può risultare vuoto: in quel caso passa il livello direttamente a paga.paga Prepara il link alla pagina di pagamento Stripe per il livello scelto. Non addebita nulla: il pagamento lo fa la persona su quella pagina, i dati della carta non passano dalla conversazione.il-mio-account Dice chi è la persona (nome ed email di accesso), l'indirizzo del suo spazio, i suoi ruoli nelle aziende e gli abbonamenti attivi.
Agent nel browser
Pilota il browser di chi ha installato l'estensione SoWay: leggere e cliccare nelle pagine, compilare, schede, console e rete. Le azioni del connettore sono fisse; ogni altra azione è un comando che il browser dichiara da sé.
Quando si usa. Per agire nel browser di una persona. Chiedi action=documentazione per vedere i comandi dichiarati dal browser, e documentazione_<comando> per i parametri di uno. Per agire servono modo «può agire» e consenso del proprietario.
- Livello: compreso dal livello 1.
- Serve un dispositivo: un browser Chrome con la nostra estensione con l'agente di SoWay installato e collegato al tuo spazio. Senza un dispositivo collegato questo strumento non ha niente da comandare, e per comandarlo serve il consenso di chi ha il dispositivo.
Le 6 azioni
list-devices Elenca i browser con estensione accoppiati all'azienda.device-capabilities Dice quali comandi sa fare un browser, come li dichiara lui.pair-device Accoppia direttamente all'utente collegato un browser con estensione (senza codice) e ne rilascia il token; se esiste già per quell'install_id lo riusa. Vale come consenso del proprietario.get-result Ritira il risultato di un comando rimasto in attesa.give-consent Registra il consenso del proprietario: da ora il browser può eseguire comandi che agiscono, se il suo modo è «può agire».revoke-consent Revoca il consenso: da subito i comandi che agiscono si fermano.
Agent nella cassa
Comanda l'agente installato sulla cassa (dispositivo di tipo pos_browser) dell'azienda: aggiungere prodotti, incassare, chiudere lo scontrino, aprire il cassetto. Le azioni qui sotto sono quelle del connettore; ogni altra azione e' un comando che la cassa dichiara da se'.
Quando si usa. Per agire su una cassa fisica collegata. Prima list-devices e device-capabilities per sapere quale cassa e cosa sa fare; i comandi funzionano solo se la cassa e' in modo «agisce» e ha il consenso del proprietario. Per le sessioni POS del gestionale usa gli strumenti pos_*.
- Livello: compreso dal livello 1.
- Serve un dispositivo: una cassa con l'agente di SoWay installato e collegato al tuo spazio. Senza un dispositivo collegato questo strumento non ha niente da comandare, e per comandarlo serve il consenso di chi ha il dispositivo.
Le 6 azioni
list-devices Elenca le casse dell'azienda con stato, modo (observe/actuate), consenso, se possono agire, ultimo contatto e capacita' dichiarate. Solo lettura.device-capabilities Mostra le azioni che una cassa dichiara di saper fare e tutte le sue capacita'. Senza device_id usa l'unica cassa online. Solo lettura.pair-device Accoppia alla tua azienda una cassa tua, senza codice: crea il dispositivo (o riusa quello con lo stesso install_id), registra il tuo consenso e rilascia un token nuovo. Il token vecchio di quel dispositivo smette di valere.get-result Ritira il risultato di un comando alla cassa rimasto in attesa (stato pending). Solo lettura.give-consent Registra il consenso del proprietario: da adesso la cassa puo' eseguire comandi, se il suo modo e' «actuate». Lo puo' dare solo chi possiede il dispositivo o un amministratore di sistema, non l'assistente per conto suo.revoke-consent Revoca il consenso: da subito la cassa non esegue piu' comandi. Solo il proprietario o un amministratore di sistema.
Agent su Linux o Raspberry
Comanda l'agent SoWay su una macchina Linux o un Raspberry dell'azienda. Qui ci sono le azioni del connettore; le altre (comandi, file, rete, MQTT, bluetooth…) le dichiara il dispositivo e si passano con i parametri in `params`.
Quando si usa. Quando la macchina è Linux o Raspberry (Windows: «Agent su PC Windows»). action=documentazione elenca le azioni del dispositivo. Per agire servono consenso del proprietario e mode=actuate.
- Livello: compreso dal livello 1.
- Serve un dispositivo: un computer Linux o un Raspberry con l'agente di SoWay installato e collegato al tuo spazio. Senza un dispositivo collegato questo strumento non ha niente da comandare, e per comandarlo serve il consenso di chi ha il dispositivo.
Le 9 azioni
list-devices Elenca i dispositivi Linux/Raspberry dell'azienda con stato, modo, consenso e capacità. Sola lettura.device-capabilities Mostra cosa sa fare un dispositivo, come lo dichiara lui: l'elenco delle azioni e le capacità. Sola lettura.pair-device Accoppia all'azienda di chi chiama un dispositivo nuovo (tipo PC), senza codice. Crea il dispositivo e ne emette il token: la risposta contiene un segreto da non mostrare in chat.get-result Ritira il risultato di un comando rimasto in attesa (stato pending). Sola lettura.give-consent Registra il consenso del proprietario a far agire il dispositivo. Lo può dare solo il proprietario del dispositivo o l'amministratore di sistema, mai l'AI per conto suo.revoke-consent Revoca il consenso: da subito i comandi che agiscono si fermano. Solo il proprietario o l'amministratore di sistema.esecutore-installa Scarica, installa e accoppia l'esecutore SoWay sulla stessa macchina dell'agent, con avvio automatico (systemd). Esegue comandi sulla macchina e crea un esecutore nel gestionale.esecutore-configura Legge il file executor.toml dell'esecutore o ne cambia solo le righe kinds, concurrency e name (token e worker_id mai). Senza cambi è sola lettura; con cambi scrive il file sulla macchina.esecutore-stato Controlla se l'esecutore è installato e in esecuzione sulla macchina, e come del gestionale vede gli esecutori dell'azienda (online/offline). Esegue solo comandi di lettura.
Agent su PC Windows
Comanda l'agent SoWay installato su un PC Windows dell'azienda. Le azioni qui sotto sono del connettore; ogni altra azione e' un comando che il PC dichiara da se' (vedi device-capabilities o action=documentazione) e si manda con i suoi argomenti in 'params'.
Quando si usa. Usalo quando devi agire su un PC Windows gia' collegato. Per un Raspberry o un PC Linux usa «Agent su Linux o Raspberry»; per collegare un dispositivo nuovo e prendere i link di download usa «Dispositivi e loro strumenti»; per delegare lavori a un esecutore usa «Esecutori esterni e deleghe».
- Livello: compreso dal livello 1.
- Serve un dispositivo: un PC Windows con l'agente di SoWay installato e collegato al tuo spazio. Senza un dispositivo collegato questo strumento non ha niente da comandare, e per comandarlo serve il consenso di chi ha il dispositivo.
Le 9 azioni
list-devices Elenca i PC Windows dell'azienda (agent di tipo pc_agent che dichiarano sistema Windows), con stato, modo, consenso e capacita'.device-capabilities Mostra le azioni che un PC dichiara di saper fare (le capacita' vere) e il suo modo.pair-device Accoppia direttamente all'utente collegato un nuovo agent PC, senza codice, e restituisce device_id e token per l'agent. Scrive.get-result Ritira il risultato di un comando rimasto in attesa (stato pending).give-consent Registra il consenso del proprietario del PC a far agire l'assistente. Solo il proprietario del dispositivo o un amministratore di sistema: l'assistente non puo' darlo da se'.revoke-consent Revoca il consenso: da subito i comandi sul PC si fermano. Stesse regole di give-consent.esecutore-installa Crea un esecutore nel gestionale, genera il codice di accoppiamento (15 minuti) e fa scaricare, installare e agganciare l'esecutore sullo stesso PC tramite l'agent. ESEGUE COMANDI sul PC.esecutore-configura Legge (senza cambi) o modifica il file executor.toml dell'esecutore sul PC. Cambia solo kinds, concurrency e name; token e worker_id mai. ESEGUE COMANDI sul PC.esecutore-stato Controlla se l'esecutore e' installato e gira sul PC e come lo vede del gestionale (online/offline). Esegue un comando di sola lettura sul PC.
Agent su telefono Android
Comanda l'app SoWay su un telefono Android dell'azienda: fotocamera, rete e wifi, bluetooth, chat, sveglie, app. Le azioni qui sono del connettore; ogni altra azione è un comando dichiarato dal telefono, con gli argomenti in 'params'.
Quando si usa. Per agire su un telefono già collegato. I comandi si scoprono con device-capabilities. Un comando lento torna 'pending' con corr_id: il risultato con get-result. Per i PC usa «Agent su PC Windows» o «Agent su Linux o Raspberry».
- Livello: compreso dal livello 1.
- Serve un dispositivo: un telefono Android con l'agente di SoWay installato e collegato al tuo spazio. Senza un dispositivo collegato questo strumento non ha niente da comandare, e per comandarlo serve il consenso di chi ha il dispositivo.
Le 6 azioni
list-devices Elenca i telefoni Android dell'azienda, con stato, modo, consenso e capacità.device-capabilities Mostra i comandi che il telefono dichiara di saper fare e il suo modo (observe = solo osservare, actuate = può agire).pair-device Accoppia all'utente collegato un telefono, senza codice, e restituisce device_id e token per l'app. Scrive. Il telefono nasce in sola osservazione; l'accoppiamento vale come consenso del proprietario. Se esiste già un telefono con lo stesso install_id, gli riemette il token: l'app già collegata va riconfigurata.get-result Ritira il risultato di un comando rimasto in attesa (stato pending).give-consent Registra il consenso del proprietario del telefono a far agire l'assistente. Lo può dare solo il proprietario del dispositivo o un amministratore di sistema: l'assistente non può darselo da sé.revoke-consent Revoca il consenso: da subito i comandi sul telefono si fermano. Stesse regole di give-consent.
Agent su un altro dispositivo (qualsiasi)
Comanda un dispositivo dell'azienda (telefono, PC, Raspberry, browser, cassa) senza filtrare per famiglia. Le azioni fisse servono a trovarlo, accoppiarlo e gestire il consenso; ogni altra azione e' un comando che il dispositivo dichiara di saper fare.
Quando si usa. Usalo quando conosci gia' il device_id o non sai il tipo. Se sai la famiglia preferisci «Agent su PC Windows», ...OnLinuxDevice, ...OnAndroidDevice, ...OnBrowserChromeDevice, ...OnPosDevice. Dal client MCP lo strumento si chiama manageAgentOnAnotherDevice.
- Livello: compreso dal livello 1.
- Serve un dispositivo: un dispositivo qualsiasi con l'agente di SoWay installato e collegato al tuo spazio. Senza un dispositivo collegato questo strumento non ha niente da comandare, e per comandarlo serve il consenso di chi ha il dispositivo.
Le 6 azioni
list-devices Elenca tutti i dispositivi dell'azienda corrente, online o no. Solo lettura.device-capabilities Dice cosa sa fare un dispositivo: le azioni sono le sue capacita' dichiarate con valore true. Solo lettura.pair-device Accoppia al tuo utente e alla tua azienda un dispositivo tuo, senza codice. Se esiste gia' (stesso tipo e install_id) lo riusa e gli emette un token nuovo: il vecchio token smette di funzionare. Vale come consenso del proprietario.get-result Ritira lo stato e il risultato di un comando rimasto in attesa (stato pending). Solo lettura.give-consent Registra il consenso del proprietario: il dispositivo potra' eseguire comandi, se anche il suo modo e' actuate. Scrive.revoke-consent Toglie il consenso: da subito il dispositivo non esegue piu' comandi. Scrive e traccia chi l'ha tolto.
Azioni Cliente
L'unica rotta per i CLIENTI di un'azienda (tenant): conoscere l'attività, vedere catalogo e noleggi pubblicati, comprare o prenotare pagando in Fiorini, gestire il proprio profilo, i pagamenti e le richieste di assistenza, fare domande.
Quando si usa. Usala quando chi è collegato è un cliente dell'azienda. Tutto resta nell'azienda a cui il cliente è collegato. Non serve per gestire il negozio: quello è del personale con gli altri strumenti.
- Livello: compreso dal livello 1.
Le 22 azioni
chi_siete Racconta l'attività: nome pubblico, quanti prodotti pubblicati per categoria, quanti a noleggio, recapiti pubblici (telefono, email, sito).dove_siete Dà l'indirizzo dell'azienda, gli orari di apertura (dal calendario di lavoro, con le fasce contigue unite), i punti di ritiro dei noleggi e il telefono.come_prenoto Spiega il percorso vero per comprare o prenotare in questa attività, secondo cosa è pubblicato: acquisto (list_products → get_product → buy_product), noleggio (list_rentals → get_product → book_rental) o, se non c'è nulla, fare una domanda con ask.mio_profilo Mostra i dati che l'attività ha del cliente collegato: nome, email, telefono, indirizzo, data da cui è cliente, e quali campi può cambiare.aggiorna_profilo SCRIVE: cambia i dati del cliente collegato, solo i suoi e solo i campi ammessi. Non cambia l'email di accesso (login), solo quella di contatto.storico_pagamenti Elenca le fatture e note di credito confermate del cliente con il loro stato di pagamento, quelle ancora da pagare, e gli addebiti in Fiorini fatti sulla carta.miei_ticket Elenca le richieste del cliente, di assistenza e di servizio extra (ognuna dice il suo tipo) e, se passi un id, mostra il dettaglio con la conversazione: lì arrivano anche i preventivi, col link.apri_ticket SCRIVE: apre una richiesta verso l'attività, a nome del cliente collegato: di assistenza (qualcosa non va) o di servizio (vuole un servizio in più, un lavoro su misura, un preventivo). L'oggetto viene tagliato a 200 caratteri.scrivi_su_ticket SCRIVE: aggiunge un messaggio del cliente a una sua richiesta di assistenza aperta. Se la richiesta era «in attesa» del cliente, torna «in corso».list_products Elenca i prodotti pubblicati e in vendita dell'attività, con prezzo in Fiorini, prezzo di listino e categoria.list_rentals Elenca solo i noleggi pubblicati dell'attività (come list_products con offer_type=rent).get_product Scheda completa di un prodotto pubblicato: prezzo in Fiorini, condizioni di vendita, specifiche; per i noleggi anche modalità, punto di ritiro, giorni/minuti minimi e massimi, orari e gli slot ancora liberi.my_balance Mostra i Fiorini del cliente: non è un saldo ricaricabile ma un limite di spesa (1 Fiorino = 1 euro) addebitato sulla carta autorizzata. Dice limite, speso, disponibile e quale carta è autorizzata.my_orders Elenca gli ultimi 30 ordini del cliente in questa attività, dal più recente.get_order Dettaglio di un ordine del cliente: stato, totale, stato di consegna e fatturazione, righe.buy_product SPENDE: crea un ordine per un prodotto pubblicato, addebita il costo in Fiorini sulla carta autorizzata del cliente e, se il pagamento riesce, conferma l'ordine. Se il pagamento fallisce l'ordine viene annullato. Non c'è un secondo passo di conferma: chiedi prima il consenso esplicito del cliente.book_rental SPENDE: prenota un noleggio pubblicato, addebita il prezzo in Fiorini sulla carta del cliente e conferma l'ordine; se usi uno slot lo segna come prenotato. Nessun secondo passo di conferma: chiedi prima il consenso del cliente.ask Fa una domanda all'assistente AI dell'attività, che risponde basandosi solo sul catalogo pubblicato (fino a 40 prodotti con prezzi in Fiorini).list_articles Elenca gli articoli dell'attività con titolo e un estratto di 200 caratteri.get_article Legge un articolo dell'attività per intero.list_pages Elenca le pagine del portale pubblicate dall'attività, con il loro indirizzo.chiudi_ticket SCRIVE: chiude una richiesta di assistenza del cliente. Il motivo, se c'e', resta nella conversazione come suo messaggio.
Bacheca e feed social
La bacheca sociale di SoWay: l'indice dei contenuti (post e reel) dei siti WordPress su cui l'utente è registrato, con reazioni, commenti, urla (ricondivisioni), siti aggiunti e creatori seguiti. I dati sono della persona, non del sito.
Quando si usa. Usala per leggere o animare la bacheca dell'utente collegato. Un contenuto si indica col suo 'link' pubblico; una ricondivisione (urlo) col suo 'id'. Per pubblicare davvero sui siti WordPress serve l'app, non questo strumento.
- Livello: compreso dal livello 1.
Le 16 azioni
contenuti Legge la bacheca a pagine. Mostra solo i contenuti dei siti aggiunti dall'utente, e fra questi: quelli degli amministratori, le urla, i creatori seguiti e i propri.commenti Legge i commenti di un contenuto, con le risposte annidate. I commenti tolti restano come «Qualcuno» senza testo.commenta SCRIVE e rende visibile: aggiunge un commento dell'utente a un contenuto, o una risposta a un altro commento. Se il contenuto non è ancora nell'indice lo crea dal link.togli-commento CANCELLA un commento proprio. Se ha risposte di altri resta un guscio vuoto segnato come tolto.reagisci SCRIVE: mette o cambia la reazione dell'utente a un contenuto. Rimettere la stessa reazione la toglie. Se il contenuto non è nell'indice lo crea dal link.leggi-voto Legge la reazione dell'utente a un contenuto nella forma vecchia (1, -1 o 0) più la reazione vera e i conteggi. Tenuta per le app già installate.vota SCRIVE: la forma vecchia di reagisci. voto 1 = mi_piace, -1 = rabbia (rimetterli uguali li toglie), 0 = toglie la reazione attuale.urla SCRIVE: registra un «urlo», cioè una ricondivisione di un contenuto già nell'indice, con un commento facoltativo e l'esito su ogni sito. Non pubblica sui siti: lo fa l'app, qui si registra solo dove è arrivato.indicizza SCRIVE: mette nell'indice un contenuto pubblico (o aggiorna quello che c'è) a partire dalla sua scheda, come la consegnano i siti WordPress. Senza link valido non entra.siti Elenca i siti che l'utente ha aggiunto: sono il confine di ciò che vede in bacheca.aggiungi-sito SCRIVE: dichiara che l'utente è registrato su un sito; da quel momento i suoi contenuti entrano nella sua bacheca. Non dà accesso al sito. Se il sito c'era già completa solo i dati mancanti.togli-sito CANCELLA un sito dall'elenco dell'utente: i suoi contenuti escono dalla bacheca.segui SCRIVE: l'utente comincia a seguire un creatore, così i suoi contenuti entrano in bacheca. Se lo seguiva ma l'aveva zittito, lo rimette nel feed.smetti-di-seguire CANCELLA: l'utente smette di seguire un creatore.seguiti Elenca i creatori seguiti dall'utente, con i due interruttori di ognuno.imposta-seguito SCRIVE: zittisce o riaccende un creatore seguito senza smettere di seguirlo. nel_feed decide se compare in bacheca, aggiornamenti se ne arrivano le notifiche.
Bot WhatsApp
Configura il bot WhatsApp dell'azienda (lo stesso della chat del sito), come la pagina /mio/bot: strumenti accesi per livello, domande di onboarding, numeri dello staff, informazioni per le risposte, conferma delle iscrizioni e casella email delle conferme.
Quando si usa. Quando il titolare vuole cambiare cosa fa o dice il bot. Tutte le azioni tranne documentazione sono solo per il titolare (o il superadmin): gli altri ricevono errore 403. Lavora sempre sull'azienda corrente. Parti da documentazione e stato.
- Livello: compreso dal livello 1.
Le 20 azioni
documentazione Spiega come funziona il bot e in che ordine si configura (stato, strumenti, domande, numeri, informazioni, posta, iscrizioni).stato Mostra il numero WhatsApp dell'azienda, se è collegato, lo stato del gateway, le parti attive, quanti strumenti sono accesi per livello, quante domande e numeri staff ci sono, e come si confermano le iscrizioni.strumenti Elenca cosa può fare il bot, per livello (cliente, dipendente, admin), con stato acceso/spento e le istruzioni del titolare. Mostra solo gli strumenti delle parti attive dell'azienda.strumento-imposta Accende o spegne uno strumento del bot, oppure gli dà istruzioni tue. Scrive la configurazione.campi-onboarding Elenca i campi che il bot può far compilare con le domande di onboarding, adatti alle parti attive dell'azienda.domande Elenca le domande di onboarding dell'azienda, ordinate per fase.domanda-aggiungi Crea una nuova domanda di onboarding. Il bot la fa una alla volta, in fondo alla risposta, e salva la risposta nel campo scelto.domanda-modifica Cambia testo, istruzioni o obbligatorietà di una domanda esistente dell'azienda.domanda-spegni Spegne una domanda di onboarding: il bot smette di farla. Non la cancella.domanda-accendi Riaccende una domanda di onboarding spenta.numeri Elenca i numeri dello staff registrati per il bot, con persona, email e livello.numero-imposta Abilita un numero WhatsApp come dipendente o amministratore, legato a un utente dell'azienda. Se il numero c'è già lo aggiorna.numero-togli Cancella un numero dall'elenco dello staff del bot.informazioni Elenca le voci informative che il bot usa per rispondere (indirizzo, come arrivare, parcheggio, orari, regole…), con il testo attuale. Mostra solo le voci delle parti attive.informazione-scrivi Scrive il testo di una voce informativa del bot, o la toglie con testo vuoto.iscrizione-imposta Sceglie come si conferma chi si iscrive come cliente al sito: solo codice via email, o email più codice WhatsApp.posta Mostra da dove partono le email di conferma ai clienti: la casella dell'azienda configurata (senza password) e il mittente usato adesso.posta-imposta Collega la casella SMTP dell'azienda per le conferme ai clienti e la prova subito. Crea o aggiorna un server di posta in uscita.posta-prova Riprova la connessione alla casella SMTP dell'azienda e aggiorna lo stato verificata/errore.posta-togli Torna al mittente di SoWay per le conferme: spegne (non cancella) il server di posta dell'azienda.
Bussola degli strumenti
La bussola degli strumenti SoWay: spiega come si chiamano, li cerca per parola nel catalogo, elenca le azioni e i parametri di uno strumento, mostra livelli e prezzi.
Quando si usa. Chiamalo per primo quando non sai quale strumento usare, e prima di concludere che una cosa non si può fare. Cerca e documenta, non esegue nulla. Per domande a parole libere sulla documentazione usa rag_search.
- Livello: compreso dal livello 1.
Le 6 azioni
come-si-usa La pagina uno: cos'è SoWay, le due forme di strumento (una operazione, o famiglie manage… con action), i tre passi per trovare quello giusto, l'indirizzo del proprio spazio.mappa Mostra gli strumenti raggruppati per categoria, con quante azioni hanno e se puoi chiamarli.cerca Cerca nel catalogo per parola: nome, descrizione, nomi ed etichette delle azioni, rotta; anche fra le azioni dichiarate dai dispositivi collegati.strumento Restituisce la guida di uno strumento con tutte le sue azioni, o il dettaglio di una sola.schema Dà i parametri esatti: per uno strumento a famiglia, obbligatori e facoltativi di ogni azione (o di una sola); per gli altri, lo schema annunciato al client.abbonamenti Elenca i livelli di abbonamento letti dal catalogo: nome, prezzo al mese, quanti strumenti, descrizione.
Chiavi dei dispositivi
La rubrica delle chiavi PUBBLICHE dei dispositivi (telefoni) dentro l'azienda: serve a cifrare un messaggio per tutti i dispositivi del destinatario. Si pubblica la chiave del proprio telefono, si leggono quelle di un'altra persona, si revoca un dispositivo.
Quando si usa. Per la chat cifrata fra persone dello stesso tenant. Qui passano solo chiavi pubbliche: non mandare mai una chiave privata. Il tenant si ricava da chi chiama e non si può indicare.
- Livello: compreso dal livello 1.
Le 4 azioni
pubblica Registra la chiave pubblica di un dispositivo, sempre a nome di chi chiama. Se lo stesso dispositivo aveva una chiave diversa, la vecchia viene revocata con traccia. Scrive.dispositivi-di Restituisce le chiavi ATTIVE dei dispositivi di una persona dello stesso tenant. Se la persona non è nel tenant la lista è vuota, come se non avesse dispositivi.i-miei Elenca i dispositivi di chi chiama, revocati compresi, con stato, data di revoca e ultimo accesso.revoca Spegne un proprio dispositivo (perso, rubato o vecchio): resta in elenco come revocato. Da quel momento nessuno gli scrive più, ma i messaggi già ricevuti restano leggibili sul dispositivo. Scrive, senza conferma.
Conto Stripe dell'azienda
Il conto Stripe dell'azienda, dove arrivano i pagamenti con carta del negozio del sito meno la commissione della piattaforma (come in /mio/pagamenti): stato del collegamento, link per collegarlo o completarlo, link al pannello Stripe, saldo, pagamenti del negozio, bonifici sull'IBAN, rimborsi.
Quando si usa. Quando il titolare chiede dei suoi incassi con carta, del conto Stripe, dei bonifici o vuole rimborsare un cliente. Solo il titolare e solo il conto della sua azienda: dipendenti e clienti ricevono 403. I dati dell'azienda e l'IBAN si inseriscono su Stripe, mai in chat.
- Livello: compreso dal livello 1.
Le 9 azioni
documentazione Spiega il conto Stripe e l'ordine delle azioni. Aperta a tutti.stato Dice se il conto e' collegato, se riceve pagamenti, se accetta carte, cosa chiede ancora Stripe, se nel negozio c'e' la carta di credito e quanto trattiene la piattaforma ogni 100 euro.aggiorna Rilegge lo stato del conto da Stripe, per esempio dopo che il titolare ha finito di inserire i dati.link_onboarding Il link di Stripe per collegare il conto (lo crea se manca) o completarne i dati. Il titolare lo apre nel browser.link_dashboard Il link personale e monouso al pannello Stripe del conto (pagamenti, bonifici, dati fiscali).saldo Soldi disponibili (pronti per il prossimo bonifico) e in arrivo sul conto.pagamenti Gli ultimi pagamenti con carta del negozio dell'azienda, con commissione della piattaforma, commissione Stripe e netto.bonifici I versamenti di Stripe sull'IBAN dell'azienda, con stato e data di arrivo prevista.rimborso Rimborsa al cliente un pagamento del negozio, tutto o in parte: i soldi tornano sulla sua carta e si tolgono dal conto dell'azienda insieme alla commissione. Due passi: la prima chiamata restituisce riepilogo e conferma_token, la seconda con il token rimborsa.
Dati del gestionale (CRUD)
Accesso generico ai dati del gestionale su qualsiasi modello: cerca, legge, crea, modifica, cancella record, chiama metodi, legge campi, viste e chatter, esporta in CSV/XLSX.
Quando si usa. Quando non c'è uno strumento dedicato (vendite, progetti, sito…): quelli dedicati vanno preferiti. L'amministratore di sistema vede tutto; gli altri utenti vedono solo i dati della propria azienda, entro i permessi del loro ruolo.
- Livello: compreso dal livello 1.
Le 25 azioni
get-api-schema Restituisce lo schema delle rotte API con l'elenco delle azioni di ciascuna.search-records Cerca record di un modello con un dominio del gestionale, a pagine.read-records Legge record precisi dati i loro id.create-record Crea un record. SCRIVE nel database. Per i non amministratori l'azienda (o il proprietario) viene impostata da sola ed è vietato assegnarne un'altra.update-record Modifica uno o più record con gli stessi valori. SCRIVE nel database.delete-record CANCELLA record, in due passi: senza force mostra solo cosa cancellerebbe (prova a vuoto); con force=true cancella davvero.call-method Esegue un metodo pubblico del modello sui record indicati (es. action_confirm). Può scrivere, inviare o confermare: dipende dal metodo.get-record-context Legge un record con tutti i campi memorizzati e in più i record collegati (many2one e fino a 10 elementi delle liste collegate).get-fields Elenca i campi di un modello con tipo, obbligatorietà, relazione, aiuto e valori ammessi delle selezioni.get-views Elenca le viste (form, list, kanban…) di un modello, escluse le qweb.whoami Dice con quale identità stai agendo in questa chiamata: utente, azienda attiva, ruolo (amministratore di sistema, titolare, dipendente, cliente) e da quale indirizzo sei entrato.get-access-rights Dice se l'utente corrente può leggere, scrivere, creare e cancellare su un modello (diritti di base del gestionale).get-messages Legge i messaggi del chatter di un record: commenti, note e cambi di campo tracciati, dal più recente.post-message Scrive un messaggio nel chatter di un record. Il tipo comment può notificare via email i follower; note è una nota interna.export-records Esporta record in un file CSV o XLSX restituito in base64. Solo lettura.batch-create Crea piu' record dello stesso modello in una chiamata (lista di valori); stessi controlli di azienda di create.batch-update Aggiorna piu' record in una chiamata; stessi controlli di azienda di update.bi-topn Sintesi: i primi N gruppi per una misura (es. i 10 clienti che spendono di piu').bi-pivot Sintesi: tabella pivot raggruppata su una o due dimensioni.bi-timeseries Sintesi: andamento di una misura nel tempo (giorno, settimana, mese).bi-funnel Sintesi: imbuto per fasi (es. opportunita' per stato).bi-cohort Sintesi: coorti nel tempo, solo sui dati della tua azienda.get-dashboard-data I dati di una dashboard gia' creata.create-dashboard Crea una dashboard dai dati e restituisce il link sul dominio del tuo sito.search-options Le opzioni di ricerca di un modello (campi, filtri, raggruppamenti).
Dispositivi e loro strumenti
Collega all'azienda un telefono Android, un PC (Windows, Linux, Raspberry), una cassa o un browser: da' i link per scaricare l'agente, il codice di accoppiamento e l'indirizzo del server, e mostra cosa sa fare un dispositivo gia' collegato.
Quando si usa. Usalo per il primo collegamento di un dispositivo e per scoprire i suoi strumenti. Per COMANDARE un dispositivo gia' collegato usa «Agent su PC Windows», «Agent su Linux o Raspberry», «Agent su telefono Android», «Agent nel browser» o «Agent nella cassa».
- Livello: compreso dal livello 1.
Le 4 azioni
list-devices Elenca i dispositivi dell'azienda, collegati o in attesa di accoppiamento.pairing-code Crea un nuovo dispositivo con il nome dato (o usa quello indicato) e genera il codice di accoppiamento da incollare nell'agente, valido 15 minuti. Scrive.how-to-connect Spiega in quattro passi come collegare un dispositivo, con i link per scaricare gli agenti (Android, Windows, Linux e Raspberry, estensione browser) e l'indirizzo del server.device-tools Mostra gli strumenti che un dispositivo collegato dichiara di saper fare, piu' le sue informazioni (modello, versione...).
Email (invio/lettura)
Legge e invia email dalla casella personale di chi chiama (IMAP per leggere, SMTP per inviare). Ogni utente usa solo le proprie credenziali, mai condivise.
Quando si usa. Per scrivere o leggere la posta dell'utente. Se la casella non è configurata parti da get-account e set-account. Per campagne a molti destinatari usa «Gestione Marketing».
- Livello: compreso dal livello 1.
- Nel pannello: Messaggi (
/mio/messaggi).
Le 7 azioni
get-account Mostra come è configurata la casella dell'utente: utenza, server e porte, se è attiva e se una password c'è. La password non torna mai.set-account Salva la casella dell'utente che chiama (solo la sua) e la accende. Scrive credenziali.send-email Invia davvero una email via SMTP dalla casella dell'utente; il mittente è sempre l'utenza configurata.read-emails Elenca le ultime email di una cartella, dalla più recente, con mittente, oggetto e data. Non le segna come lette.get-email Legge una email intera: intestazioni e testo semplice. Non la segna come letta.list-folders Elenca le cartelle IMAP della casella (INBOX, Sent, ecc.). Sola lettura.mark-read Segna una email come letta o non letta sul server. Scrive sulla casella.
Esecutori esterni e deleghe
Gestisce gli esecutori esterni dell'azienda (il programma gestionale-gpt-executor su Raspberry, Linux o Windows): accoppiamento con codice, elenco e stato, delega di comandi con ritiro del risultato, revoca e regole di instradamento. Tutto nella propria azienda; l'amministratore master vede tutte.
Quando si usa. Usalo per far eseguire lavori a una macchina esterna dell'azienda. Per comandare direttamente un agent su PC usa «Agent su PC Windows» o «Agent su Linux o Raspberry»; per collegare telefoni, casse o browser usa «Dispositivi e loro strumenti».
- Livello: compreso dal livello 1.
Le 7 azioni
list-executors Elenca gli esecutori dell'azienda (anche disattivati) con stato, azioni dichiarate e carico.pairing-code Crea un nuovo esecutore (o usa quello indicato) e genera un codice a sei cifre per accoppiarlo. Il codice vale 15 minuti e si consuma. Scrive.delegate Manda un comando a un esecutore e aspetta qualche secondo il risultato; se non ha finito torna job_id in stato di attesa. ESEGUE un'azione sulla macchina esterna.get-result Ritira lo stato e il risultato di una delega.revoke Revoca un esecutore: da subito non prende ne' consegna piu' lavoro. Per riusarlo va riaccoppiato.routing-list Elenca le regole di instradamento delle deleghe dell'azienda e quelle generali.routing-set Crea o aggiorna una regola di instradamento per tipo e azione: esecutore preferito, scadenza e comportamento alla scadenza. Scrive.
Fonti di Deep Research
Decide cosa possono leggere gli strumenti search e fetch: accende e spegne le fonti (web, magazzino vettoriale, pagine del sito, video, immagini, record del gestionale, WordPress), tiene l'elenco dei siti WordPress da interrogare e gestisce i documenti del magazzino vettoriale dell'azienda.
Quando si usa. Per cambiare DOVE si cerca o aggiungere un testo (manuale, regole dell'azienda) alla memoria cercabile. Per cercare davvero usa search e fetch, non questo strumento.
- Livello: compreso dal livello 1.
Le 9 azioni
list-sources Elenca le fonti con il loro stato (accesa/spenta) e i siti WordPress dell'azienda con l'esito dell'ultima prova.add-wordpress-site Aggiunge un sito WordPress all'elenco dell'azienda e lo prova subito leggendo la sua API REST pubblica; se non risponde non lo tiene. Se era già in elenco lo riaccende.remove-wordpress-site Toglie un sito dall'elenco dell'azienda (lo disattiva): non verrà più interrogato. Nessun dato da cancellare.test-wordpress-site Prova se un sito WordPress è leggibile tramite la sua API REST pubblica, senza salvarlo.toggle-source Accende o spegne una fonte delle ricerche per la TUA azienda: le altre aziende non cambiano. Senza una scelta dell'azienda vale l'impostazione generale.add-document Salva un testo nel magazzino vettoriale dell'azienda e lo indicizza, così search lo trova. Se l'indicizzazione fallisce il testo resta salvato e il sistema riprova da solo entro un'ora.list-documents Elenca i documenti del magazzino vettoriale visibili all'azienda (i suoi e quelli condivisi), con numero di pezzi, stato nell'indice ed eventuale problema.remove-document Cancella un documento dell'azienda dal magazzino e dall'indice. Non si recupera. I documenti condivisi di altre aziende non si toccano.reindex Rimette in pari l'indice: indicizza i documenti rimasti indietro e mostra quanti pezzi attivi ci sono per tipo di fonte.
Gestione Articoli (SEO)
Gestisce gli articoli di contenuto SEO di SoWay: titolo, testo HTML, titolo SEO, meta description, parole chiave, slug, categorie e video. Ogni articolo è legato a un dominio di sito (website_domain).
Quando si usa. Per testi SEO in questo archivio. NON pubblica sul blog del sito (per quello usa «Sito Vetrina (tenant)»). Passa sempre website_domain: se manca si usa l'indirizzo della chiamata e gli articoli di altri domini non si trovano.
- Livello: compreso dal livello 1.
Le 8 azioni
create-post Crea un nuovo articolo. Scrive nel database, non pubblica nulla.update-post Modifica i campi indicati di un articolo; i campi non passati restano invariati. Scrive.get-post Legge un articolo per intero. Solo lettura.search-post Cerca articoli per testo nel titolo o nel contenuto. Il risultato NON arriva subito: arriva un chunk_key, e gli articoli si leggono poi con get-chunk o get-transient (restano disponibili per un tempo breve, predefinito 60 minuti).append-content Aggiunge un pezzo di HTML all'articolo: all'inizio, alla fine, o prima/dopo il titolo H2 numero N. Scrive.replace-text Sostituisce TUTTE le occorrenze di un testo esatto nel contenuto HTML dell'articolo. Scrive. Se il testo non c'è non cambia nulla e non dà errore.update-seo-title Cambia solo il titolo SEO dell'articolo. Scrive.create-category Crea una categoria di articoli per l'azienda attiva. Scrive.
Gestione Contatti
Rubrica contatti dell'azienda: cerca contatti, li crea o aggiorna con etichette, e mostra lo storico di un contatto (messaggi, attività, ordini di vendita).
Quando si usa. Per clienti, fornitori e persone in anagrafica. Chi non è amministratore di sistema vede e scrive solo i contatti della propria azienda. Per scegliere il cliente di un preventivo va bene anche list_partners_sq di «Vendite & Noleggi (prodotti/prenotazioni)».
- Livello: compreso dal livello 1.
- Nel pannello: Rubrica (
/mio/team), Team e accessi (/mio/accessi).
Le 3 azioni
search-partners Cerca contatti per nome, email o telefono, con filtri e paginazione. Solo lettura.create-update-partner Crea un contatto nuovo, oppure aggiorna quello indicato da id. SCRIVE in anagrafica, senza conferma. Le etichette che non esistono vengono create.get-contact-history Mostra lo storico di un contatto: messaggi e note del chatter, attività pianificate, ordini di vendita. Solo lettura.
Gestione Memoria e Placeholder
Due cose: le memorie (procedure e appunti dell'utente, indicizzati nel RAG) e i placeholder, etichette come {{CHIAVE_STRIPE}} che il server sostituisce col valore vero prima di eseguire qualunque strumento.
Quando si usa. Usa le memorie per ricordare come si fa una cosa. Usa i placeholder quando la persona ti dà una chiave o una password: la salvi una volta e poi scrivi solo l'etichetta, così il valore non torna più in conversazione.
- Livello: compreso dal livello 1.
Le 9 azioni
list-placeholders Elenca i placeholder delle aziende dell'utente (gli amministratori di sistema vedono anche i globali). Il valore non viene mai restituito.create-placeholder Crea un placeholder nell'azienda corrente, con o senza il valore. Il nome viene messo nella forma {{NOME}}.set-placeholder-value Salva il valore vero di un placeholder esistente, e/o ne cambia descrizione e visibilità. Il valore non viene restituito.delete-placeholder Elimina un placeholder. Dopo, le chiamate che lo usano passano l'etichetta così com'è.add-memory Salva una memoria dell'utente nell'azienda corrente: un titolo, dei metadati e i passi da ricordare. Viene indicizzata nel RAG.update-memory Modifica una memoria propria: cambia solo i campi passati.delete-memory Elimina una memoria propria e la toglie dal RAG.list-memories Elenca le memorie dell'utente nell'azienda corrente.get-memory-markdown Restituisce le tue memorie in un unico testo Markdown, pronto da leggere o esportare.
Gestione Standard Tools
Legge lo schema degli strumenti e delle azioni SoWay (parametri, descrizioni) e gestisce i custom tool: piccoli strumenti in Python creati dall'amministratore.
Quando si usa. Usalo per scoprire quali parametri vuole un'azione prima di chiamarla (fetch_tool_parameter) o per elencare i custom tool. Crea, modifica ed elimina custom tool solo se sei amministratore di sistema: il codice Python viene eseguito sul server.
- Livello: compreso dal livello 1.
Le 8 azioni
fetch_tool_parameter Restituisce lo schema: indice delle rotte, azioni di una rotta, o parametri di un'azione o tool MCP. Solo le azioni che il tuo utente puo' usare.create_tool Crea un custom tool con codice Python eseguito dal server come superutente. SCRIVE ed ESEGUE codice.create_custom_tool Nome del tool MCP che esegue create_tool. Stessi parametri e stesso comportamento: crea un custom tool con codice Python eseguito.update_tool Modifica un custom tool esistente, cercato per nome. SCRIVE codice eseguito dal server.update_custom_tool Nome del tool MCP che esegue update_tool: modifica un custom tool per nome.delete_tool CANCELLA definitivamente un custom tool, cercato per nome. Nessuna conferma.delete_custom_tool Nome del tool MCP che esegue delete_tool: cancella un custom tool per nome.list_tools Elenca i custom tool attivi con nome, etichetta, descrizione e schema dei parametri. Solo lettura.
Link scraping e screenshot
Legge pagine web pubbliche: testo visibile, link, immagini e altri src, ricerca di pattern (email, telefoni, espressioni regolari), screenshot, e screenshot dopo aver iniettato CSS/JS. L'HTML scaricato resta in cache 24 ore.
Quando si usa. Per analizzare una pagina di un sito (SEO, contatti, contenuti, controllo grafico). Solo indirizzi http/https pubblici: localhost, .local e IP privati sono bloccati. Per pilotare un browser vero dell'utente usa gli strumenti browser_*, non questo.
- Livello: compreso dal livello 1.
Le 5 azioni
link_scraping Scarica la pagina (o la apre in un browser senza schermo) e restituisce tutto: anteprima del testo visibile, righe di testo, link, media, blocchi visibili e le corrispondenze dei pattern. Senza pattern cerca email e telefoni.read_visible_text Restituisce il testo visibile della pagina, riga per riga e a pagine (senza script, stili ed elementi nascosti). A richiesta aggiunge link e src.inspect_page Restituisce a pagine i link, i media (img, script, link rel), i blocchi visibili (titoli, paragrafi, pulsanti) e le righe di testo. I pattern si cercano solo se li passi.screenshot_page Apre la pagina in Chromium senza schermo, aspetta e restituisce lo screenshot PNG in base64. L'HTML finisce in cache (html_cache_key) e non nella risposta.inject_and_screenshot Come screenshot_page, ma prima dello scatto inietta CSS e/o ESEGUE JavaScript nella pagina (nel browser senza schermo del server, non sul sito vero). Utile per provare una modifica grafica prima di applicarla.
Onboarding e Reset
Configura l'azienda con un questionario guidato di 5 domande (tipo di attività, fatture elettroniche, e-commerce, nome pubblico, frase della home), accende le aree giuste e costruisce la home con tre blocchi; ha anche un reset che non tocca i dati gestionali.
Quando si usa. Per il primo avvio di un'azienda o per rifare la configurazione. Lavora sempre sull'azienda di chi chiama. Per ritoccare poi il sito usa «Sito Vetrina (tenant)». Nel corpo le azioni si scrivono con il trattino basso (imposta_setting).
- Livello: compreso dal livello 1.
Le 7 azioni
documentazione Restituisce la guida dello strumento: azioni, ordine consigliato (avvia → rispondi → applica → eventuale reset) ed esempi. Sola lettura.stato Dice dove sei nel questionario: passo corrente, se è completato, le risposte già date, la domanda corrente con le opzioni e il campo prossimo_passo con l'azione esatta da fare. Sola lettura (la prima volta crea il questionario vuoto).avvia Riporta il questionario alla prima domanda e lo segna come non completato. Non cancella le risposte già date né spegne le aree.rispondi Salva la risposta a una domanda e passa alla successiva dell'ordine fisso (attivita, fe, ecommerce, nome_pubblico, claim).imposta-setting Accende o spegne una singola area dell'azienda senza il questionario. Accendendola si attivano i suoi strumenti e pagine e, la prima volta, si prepara la sua cassa. Scrive.applica In base alle risposte accende le aree scelte (più il gestionale se si vuole la fattura elettronica) e aggiunge in fondo alla home tre blocchi: richtext con la frase, features3 con tre punti di forza, cta verso /scrivimi. Segna il questionario completato. Scrive sul sito.reset Ripristina le pagine di sistema del sito e azzera il questionario. Con modalita='contenuti' CANCELLA anche le pagine del sito aggiunte a mano (non di sistema). Non tocca prodotti, ordini, clienti, fatture né le aree accese. Non chiede conferma.
Pagamenti (Fiorini & MCP Coin)
I pagamenti di chi è collegato. Su SoWay (SaaS) si paga in Fiorini: un limite di spesa (1 Fiorino = 1 euro) addebitato davvero sulla carta autorizzata per quel tenant. Sulle installazioni self-hosted si paga un ordine tramite i fornitori di pagamento configurati nel gestionale.
Quando si usa. Per sapere quanto si può spendere, fissare il proprio tetto, autorizzare una carta o pagare. pay addebita soldi veri: chiedi sempre il sì esplicito della persona prima di chiamarla.
- Livello: compreso dal livello 1.
Le 4 azioni
payment_status Mostra lo stato dei pagamenti di chi chiama. SaaS: limite, spesi e disponibili in Fiorini e carte autorizzate per tenant. Self-hosted: fornitori di pagamento attivi e ordini da pagare. Sola lettura.set_spend_limit Fissa il tetto di spesa in Fiorini della persona che chiama (solo il suo). Scrive. Solo SaaS.pay SaaS: addebita subito l'importo sulla carta autorizzata per il tenant, entro il limite in Fiorini. SPENDE SOLDI VERI e non chiede token: serve prima il sì della persona. Self-hosted: restituisce il link del portale per pagare un ordine.save_card_link Restituisce il link dove la persona autorizza una carta per pagare un tenant in Fiorini. La carta si inserisce nel browser, mai in chat. Solo SaaS.
POS & Browser Agent
Gestisce le casse (sessioni POS via gestionale) e comanda a distanza un dispositivo accoppiato: la cassa nel browser o il browser con l'estensione SoWay (leggere, cliccare, compilare, schede, console, rete).
Quando si usa. Usalo per aprire/chiudere sessioni di cassa, preparare la cassa di un'area e pilotare un dispositivo già accoppiato. Per il browser con estensione c'è anche «Agent nel browser»; per stampare PDF su una cassa usa «POS Document Printer».
- Livello: compreso dal livello 1.
- Nel pannello: Punto vendita (
/mio/pos), Sala e tavoli (/mio/ristorante), Menu (/mio/menu), Cucina (/mio/cucina).
Le 38 azioni
list_devices Elenca i dispositivi accoppiati dell'azienda (cassa browser, estensione, Raspberry, telefono, PC).device_status Mostra i dati di un dispositivo: modo, stato, ultimo contatto, pagina aperta.pair_device Crea un dispositivo nuovo (o riprende uno esistente) e genera un codice di accoppiamento valido 15 minuti, con le istruzioni.ping Manda un ping al dispositivo e aspetta la risposta (fino a 8 secondi).observe Chiede al dispositivo una descrizione di cosa c'è ora sullo schermo o nella pagina.read Legge il testo di una parte della pagina indicata da un selettore CSS.screenshot Fotografa la pagina del dispositivo (attesa fino a 18 secondi).click Clicca un elemento della pagina, trovato per selettore CSS o per testo.click_xy Clicca in un punto della pagina indicato in pixel.fill Scrive un valore in un campo della pagina.press Preme un tasto, su un elemento o sulla pagina.wait_for Aspetta che nella pagina compaia (o succeda) qualcosa: un elemento, un testo, un indirizzo.scroll Scorre la pagina o porta in vista un elemento.select Sceglie una voce in un menu a tendina, per valore o per etichetta.get_value Legge il valore attuale di un campo della pagina.list_elements Elenca gli elementi cliccabili della pagina.eval Esegue codice JavaScript nella scheda del browser.storage Legge cookie (non httpOnly), localStorage e sessionStorage della scheda.console_logs Legge i messaggi e gli errori della console catturati nella scheda.dom_snapshot Restituisce una mappa degli elementi interattivi: selettore, testo, posizione.network Riassume le chiamate di rete della scheda: indirizzo, metodo, stato, errori.goto Apre un indirizzo nella scheda del browser.list_tabs Elenca le schede aperte nel browser, con il loro tab_id.new_tab Apre una nuova scheda, eventualmente su un indirizzo.switch_tab Porta in primo piano una scheda.close_tab Chiude una scheda.get_result Ritira il risultato di un comando rimasto in attesa (status pending).pos_session_status Dice se una cassa ha una sessione aperta e la mostra.pos_list_sessions Elenca le sessioni di cassa dell'azienda, le più recenti prima.pos_open_session Apre una sessione sulla cassa; se ce n'è già una non chiusa la restituisce.pos_setup_area Prepara la cassa di un'area come fa il portale: piano dei conti, contanti e carta, cassa del tipo giusto, sala coi tavoli per il ristorante.pos_close_session Avvia la chiusura di una sessione di cassa (passa al controllo di chiusura).pos_current_orders Elenca gli ordini di una sessione di cassa.pos_add_product Nella cassa aperta sul dispositivo, aggiunge un prodotto allo scontrino corrente.pos_pay Nella cassa sul dispositivo, passa alla schermata di pagamento.pos_select_payment Nella schermata di pagamento sceglie il metodo (contanti, carta…).pos_validate Conferma il pagamento e chiude lo scontrino nella cassa sul dispositivo.pos_open_cashbox Apre il cassetto dei contanti collegato alla cassa sul dispositivo.
Progetti & Task (team)
Gestisce progetti e attivita' (task) dell'azienda: elenco, creazione, modifica, assegnazione, cambio di stato, commenti, e i task operativi di un noleggio.
Quando si usa. Usala per il lavoro del team su progetti e task. Titolare o master gestiscono tutto nella loro azienda; il dipendente vede, commenta e sposta solo i task assegnati a lui. Per gli step dei servizi venduti usa «Step dei servizi».
- Livello: compreso dal livello 1.
- Nel pannello: Statistiche (
/mio/analytics), Alloggiati e tasse (/mio/alloggiati), Attività (/mio/attivita).
Le 14 azioni
list_projects Elenca i progetti dell'azienda in ordine di nome. Il dipendente vede solo i progetti dove ha task assegnati.create_project Crea un progetto nell'azienda collegata. Solo titolare o master.update_project Modifica un progetto dell'azienda. Accetta solo name, user_id (responsabile), partner_id e active (false = archivia). Solo titolare o master.list_tasks Elenca i task dell'azienda, prima i prioritari e i piu' recenti. Il dipendente vede solo i suoi.get_task Restituisce il dettaglio di un task dell'azienda, con la descrizione in testo semplice (max 2000 caratteri).create_task Crea un task in un progetto. Solo titolare o master.update_task Modifica un task. Accetta solo name, description, date_deadline, priority e stage_id. Il dipendente puo' modificare solo i task assegnati a lui.assign_task Sostituisce gli assegnatari di un task con quelli indicati (lista vuota = nessuno). Solo titolare o master.move_task Cambia lo stato (colonna) di un task, per id o per nome dello stato. Se il nome non esiste non cambia nulla. Il dipendente solo sui suoi task.comment_task Scrive un commento nel registro del task come messaggio (non nota interna): puo' arrivare ai follower, cliente compreso. Il dipendente solo sui suoi task.list_stages Elenca gli stati dei task in ordine. Con project_id: quelli del progetto piu' quelli senza progetto.list_users Elenca gli utenti interni dell'azienda, a cui si possono assegnare task.portal_context Dice chi e' collegato e cosa puo' fare: id, nome, se puo' gestire progetti (titolare/master), se e' master, azienda.generate_rent_tasks Crea i task operativi di un noleggio (predefiniti: Ritiro, Riconsegna, Verifica/Pulizia) nel progetto indicato, in quello del noleggio o in uno nuovo «Noleggi — <nome>». Scrive l'indirizzo di ritiro nella descrizione. Solo titolare o master.
Raccolta Dati (SEO/Web)
Raccoglie dati dal web per SEO e contenuti: risultati di Google tramite SerpAPI (ricerca, notizie, immagini, suggerimenti), ricerca di video YouTube e trascrizione di un video.
Quando si usa. Per ricerche di parole chiave, analisi della concorrenza, idee di contenuto. Ogni chiamata usa un servizio esterno a pagamento e consuma il tetto giornaliero di chiamate esterne; i risultati Google restano in cache 24 ore.
- Livello: compreso dal livello 1.
Le 8 azioni
serpapi-serp-analysis Restituisce i risultati organici di Google per una parola chiave, a blocchi (pagine). Solo lettura.serpapi-keyword-analysis Panoramica di una parola chiave su Google Italia: i primi 10 risultati (posizione, titolo, link, estratto) piu' la risposta completa di SerpAPI. Solo lettura.seo_analisys_serpapi_google_search Ricerca Google completa tramite SerpAPI: restituisce tutta la risposta (organici, annunci, domande correlate, mappe...). Lingua e paese predefiniti italiani. Solo lettura.seo_analisys_serpapi_google_news Cerca su Google News tramite SerpAPI e restituisce la risposta completa. Solo lettura.seo_analisys_serpapi_google_images Cerca su Google Immagini tramite SerpAPI e restituisce la risposta completa. Solo lettura. Le immagini hanno i loro diritti: non vanno riusate senza permesso.google_autocomplete_api Restituisce i suggerimenti di completamento di Google per un testo. Solo lettura.search-youtube-video Cerca video su YouTube e per i primi 5 risultati restituisce titolo, descrizione e un link diretto al file video. Solo lettura. Il risultato resta in cache 10 minuti.youtube-transcription Scarica la trascrizione di un video YouTube, la salva e la restituisce a pezzi (chunk). Le richieste successive dello stesso video leggono dalla copia salvata. Solo lettura verso l'esterno.
RAG Semantico
Ricerca semantica (per significato, non per parola esatta) nell'archivio vettoriale di SoWay: memorie dell'utente, trascrizioni, istruzioni di strumenti e azioni, PDF generati, documentazione. Vedi solo cio' che il tuo utente puo' vedere.
Quando si usa. Usalo per trovare come si usa un'azione, cosa dice il manuale o cosa c'e' nelle memorie. Le reindicizzazioni servono solo dopo modifiche ai contenuti e quasi tutte sono per amministratori.
- Livello: compreso dal livello 1.
- Nel pannello: Assistente AI (
/mio/bot).
Le 7 azioni
rag-search Cerca i pezzi di testo piu' simili alla domanda. Solo lettura.rag-deep-research Cerca la stessa domanda su piu' fonti insieme e le mette in ordine di somiglianza. Con context aggiunge l'elenco dei modelli del gestionale che puoi leggere. Solo lettura.rag-status Stato dell'indice: quanti pezzi vedi per fonte, totale attivo, modello e dimensioni di embedding. Solo lettura.rag-reindex-memory Ricalcola l'indice delle memorie. Senza all_users solo le tue memorie nell'azienda corrente. Scrive nell'indice, non tocca le memorie.rag-reindex-transcriptions Cancella e ricostruisce l'indice di tutte le trascrizioni YouTube. Operazione pesante.rag-reindex-tools Ricostruisce l'indice delle istruzioni degli strumenti e delle loro azioni attive (quelli con RAG attivo).rag-reindex-all Ricostruisce memorie di tutti gli utenti, trascrizioni e istruzioni degli strumenti. Operazione lunga e pesante.
Recensioni del sito
Le recensioni del sito dell'azienda. Interne: le scrive chi visita il sito sulla pagina /recensioni (ospite con email confermata e foto facoltativa, oppure cliente registrato del tenant) e compaiono solo dopo che il titolare le pubblica. Google: quelle della Scheda Google collegata, mostrate sul sito se accese. Le due fonti si accendono separatamente; le interne non toccano mai Google.
Quando si usa. Per vedere, approvare, nascondere o rispondere alle recensioni, e per accendere o spegnere le recensioni interne e quelle Google sul sito. Titolare: tutto; dipendenti: lettura.
- Livello: compreso dal livello 1.
- Nel pannello: Recensioni (
/mio/recensioni).
Le 8 azioni
documentazione Spiega come funzionano recensioni interne e Google, lo shortcode e il blocco.elenco Le recensioni dell'azienda con voto, testo, nome, stato, se e' di un cliente registrato, risposta.leggi Una recensione dell'azienda.statistiche Media e totale delle pubblicate, quante per stato, se interne e Google sono accese.pubblica Mette la recensione sul sito. Solo titolare. Non si puo' pubblicare una recensione con l'email non ancora confermata.nascondi Toglie la recensione dal sito (resta nell'elenco). Solo titolare.rispondi Risposta pubblica del titolare, mostrata sotto la recensione. Solo titolare. Non tocca Google.impostazioni Senza argomenti dice cosa e' acceso; con interne e/o google (true/false) accende o spegne le recensioni del sito e quelle Google (solo titolare).
Registrazione schermo (GIF)
Registra lo schermo di un dispositivo accoppiato (browser con estensione, cassa, telefono…) come GIF animata, scattando schermate a intervalli regolari entro limiti fissi. Restituisce un link che si apre senza login.
Quando si usa. Per vedere cosa succede sullo schermo per qualche secondo. Per una sola schermata usa modo='immagine' o gli strumenti del dispositivo. Il link GIF è pubblico per chi lo ha: condividilo solo con chi deve vederlo.
- Livello: compreso dal livello 1.
- Serve un dispositivo: un dispositivo con lo schermo con l'agente di SoWay installato e collegato al tuo spazio. Senza un dispositivo collegato questo strumento non ha niente da comandare, e per comandarlo serve il consenso di chi ha il dispositivo.
Le 2 azioni
record-gif Scatta schermate a intervalli e ne fa una GIF (max 900 px) salvata come allegato. Con 1 fotogramma o modo='immagine' dà una sola schermata. Valori fuori limite: stretti e segnalati in parametri_corretti.limits Dice i limiti della registrazione: intervallo minimo, massimo e predefinito, durata massima, fotogrammi massimi, larghezza massima. Solo lettura.
Sito Vetrina (tenant)
Modifica il sito web SoWay del tenant di chi chiama: testi, immagini, articoli del blog, SEO delle pagine, pubblicazione e voci di menu. Lavora solo sul sito dell'azienda dell'utente (solo il superadmin può indicare website_id).
Quando si usa. Per ritoccare il sito vetrina del tenant, non siti WordPress esterni. Permessi: il dipendente può solo info, testi e immagini; il redattore anche articoli, pagine, SEO e menu in lettura; il resto solo l'amministratore del sito.
- Livello: compreso dal livello 1.
- Nel pannello: SEO (
/mio/seo), Editor del sito (/mio/editor), Moduli (/mio/moduli).
Le 15 azioni
info Riassume il sito: dominio, nome, numero di pagine e di articoli, tema, lingua predefinita. Solo lettura.list_texts Elenca i testi modificabili del sito, pagina per pagina, con la chiave e il testo attuale. Solo lettura.edit_text Sostituisce il testo di un blocco identificato da una chiave. SCRIVE sul sito pubblico, senza conferma. Solo testo semplice: l'HTML non viene interpretato e il contenuto interno del blocco viene tolto.list_images Elenca gli spazi immagine del sito e dice quali sono già occupati. Solo lettura.set_image Mette un'immagine in uno slot del sito. SCRIVE sul sito pubblico, senza conferma. Se lo slot è logo, diventa anche la favicon.list_articles Elenca gli ultimi 20 articoli del blog del sito, dal più recente. Se il blog non esiste ancora lo crea.create_article Crea un articolo nel blog del sito e lo PUBBLICA subito, senza conferma. L'HTML viene ripulito prima di salvarlo.update_article Modifica titolo, contenuto o copertina di un articolo del sito. SCRIVE, senza conferma; non cambia lo stato di pubblicazione.list_pages Elenca le pagine del sito con id, URL, nome, stato di pubblicazione e SEO attuale. Solo lettura.set_page_seo Scrive titolo SEO, descrizione e parole chiave di una pagina, uguali in tutte le lingue del sito. SCRIVE, senza conferma.publish_page Pubblica o ritira (nasconde al pubblico) una pagina del sito. Cambia ciò che vedono i visitatori, senza conferma. Solo l'amministratore del sito.list_menus Elenca le voci del menu del sito in ordine, con id, nome, URL, sequenza e voce padre. Solo lettura.set_menu Rinomina una voce di menu, ne cambia il link o la posizione. Il nome viene scritto uguale in tutte le lingue del sito. SCRIVE, senza conferma. Solo l'amministratore del sito.publish_article Pubblica o ritira un articolo del blog del sito. Cambia ciò che vedono i visitatori, senza conferma.delete_article ELIMINA per sempre un articolo del blog del sito. Non chiede conferma e non si può annullare. Solo l'amministratore del sito.
Vendite & Noleggi (prodotti/prenotazioni)
Catalogo prodotti e servizi dell'azienda, noleggi e affitti (con periodi e prenotazioni, check-in e check-out), preventivi di vendita con stampa PDF e invio per email, inviti a dipendenti o clienti. Tutto resta dentro l'azienda di chi chiama.
Quando si usa. Usalo per creare o modificare prodotti e noleggi, gestire soggiorni prenotati e fare preventivi ai clienti. Per cercare o creare contatti in modo completo usa «Gestione Contatti»; qui c'è solo un elenco rapido dei partner.
- Livello: compreso dal livello 1.
- Nel pannello: Vendite (
/mio/vendite), Prenotazioni (/mio/prenotazioni), Noleggi (/mio/noleggi), Codici sconto (/mio/coupon).
Le 23 azioni
list_partners_sq Elenca i contatti dell'azienda (id, nome, email, città), in ordine di nome. Sola lettura.create_invite Crea un link di invito per far entrare una persona nell'azienda come dipendente (member) o cliente (customer). Scrive un invito; non manda email da sé.list_products Elenca i prodotti e servizi dell'azienda con prezzo, codice, unità, giacenza, pubblicazione sul sito e, per i noleggi, i dati del noleggio. Sola lettura.list_rentals Elenca solo i prodotti noleggiabili (beni o immobili) dell'azienda, con periodi, orari e regole di prenotazione, più le strutture Alloggiati/PayTourist collegabili. Sola lettura.create_rental Crea un prodotto noleggiabile, bene mobile o immobile, e lo pubblica subito sul sito. Scrive.add_rental_slot Aggiunge uno o più periodi prenotabili (con prezzo) a un noleggio. Scrive.create_manual_booking Registra a mano una prenotazione su un noleggio: crea l'ospite come contatto (con i dati per Alloggiati Web), apre il soggiorno già confermato e segna il periodo occupato. Scrive.list_stays Elenca i soggiorni/noleggi prenotati dell'azienda, dal più recente. Sola lettura.confirm_booking Conferma una prenotazione e segna il periodo come occupato (sparisce dai prenotabili). Scrive.refuse_booking Rifiuta una richiesta di prenotazione ancora in attesa: il periodo torna libero e il cliente riceve la risposta su WhatsApp se l'attività ha un numero collegato. Scrive.checkin Fa il check-in (o la consegna del bene): registra gli ospiti, allega i documenti e prova l'invio ad Alloggiati Web e a PayTourist se la struttura è collegata. Scrive e può comunicare con servizi esterni.checkout Segna il check-out (o la restituzione del bene) del soggiorno. Scrive.get_product Legge tutti i dati di un prodotto o noleggio dell'azienda. Sola lettura.create_product Crea un prodotto o servizio vendibile nell'azienda. Scrive.update_product Modifica un prodotto o noleggio dell'azienda. Scrive.list_quotations Elenca i preventivi e ordini di vendita dell'azienda, dal più recente. Sola lettura.get_quotation Legge un preventivo con le sue righe. Sola lettura.create_quotation Crea un preventivo per un cliente, con righe facoltative, legato all'azienda e al suo sito. Decidi tu se per accettarlo il cliente deve firmarlo, pagarlo online, tutti e due o nessuno dei due. Con ticket_id risponde a una richiesta del cliente: il preventivo gli arriva nella conversazione col link. Scrive.add_quotation_line Aggiunge una o più righe a un preventivo in bozza o inviato. Scrive.update_quotation Modifica i dati di testa di un preventivo. Scrive.confirm_quotation Conferma il preventivo e lo trasforma in ordine di vendita. Scrive, non si annulla da qui.print_quotation Genera il PDF del preventivo. Sola lettura.send_quotation Invia subito per email il PDF del preventivo al cliente e porta la bozza allo stato 'inviato'. Manda una email vera, senza conferma: chiedi prima all'utente.
WordPress & Dynamic cURL
Esegue gli «extra-tool»: operazioni di API esterne (per esempio un sito WordPress con WP GPT Automation Pro) che l'utente ha registrato da uno schema OpenAPI. Il server fa la chiamata HTTP vera, con URL, credenziali e segnaposto salvati nello schema.
Quando si usa. Quando serve un'API esterna registrata dall'utente che non ha uno strumento suo. Gli extra-tool non compaiono nell'elenco degli strumenti: si scoprono con list-extra-tools, si studiano con study-extra-tool, si eseguono con use-extra-tool.
- Livello: compreso dal livello 1.
- Nel pannello: Siti e API (
/mio/wordpress).
Le 3 azioni
list-extra-tools Elenca gli extra-tool attivi a cui l'utente ha accesso, in forma breve (senza lo schema completo). Sola lettura.study-extra-tool Mostra lo schema completo di UN extra-tool: metodo, percorso, parametri obbligatori e di percorso, schema d'ingresso, spiegazione scritta a mano, se usa un token Bearer, URL base. Sola lettura.use-extra-tool Esegue davvero la chiamata HTTP verso l'API esterna: i parametri di percorso ({id}) vanno nell'indirizzo, gli altri in query (GET) o nel corpo JSON. Può scrivere o pubblicare sul sistema esterno; non chiede conferma. Indirizzi di reti interne rifiutati.
Gestione Acquisti
Acquisti dai fornitori: crea una richiesta di preventivo (RFQ), la conferma come ordine d'acquisto e ne genera la fattura fornitore. Fornitori, prodotti e ordini devono essere dell'azienda attiva.
Quando si usa. Per il ciclo d'acquisto base; serve un magazzino nell'azienda. Per leggere ordini esistenti usa «Dati del gestionale (CRUD)». Nella chiamata HTTP diretta l'azione va col trattino basso (create_rfq); via MCP: create_rfq, confirm_po, create_vendor_bill.
- Livello: compreso dal livello 2.
Le 3 azioni
create-rfq Crea una richiesta di preventivo al fornitore (ordine d'acquisto in bozza) con le righe indicate. Scrive, non invia nulla al fornitore.confirm-po Conferma la richiesta di preventivo trasformandola in ordine d'acquisto: impegna l'azienda verso il fornitore e crea il ricevimento merce in magazzino. Nessuna conferma in due passi: chiedi prima il sì della persona.create-vendor-bill Genera la fattura fornitore (in bozza) dall'ordine d'acquisto confermato. Scrive in contabilità.
Gestione Calendario
Calendario del gestionale: trova fasce libere incrociando gli impegni, crea appuntamenti con invitati e promemoria, elenca i prossimi impegni.
Quando si usa. Per fissare riunioni e appuntamenti interni. Sulla rotta HTTP il nome dell'azione va con il trattino basso (get_availability, schedule_appointment, sync_check_meetings). Per prenotazioni di noleggi, palestra o risorse usa gli strumenti di quei verticali.
- Livello: compreso dal livello 2.
Le 3 azioni
get-availability Calcola le fasce libere in una finestra di date, saltando weekend, fuori orario e impegni delle persone indicate. Sola lettura.schedule-appointment Crea un evento in calendario con invitati (chi chiama è sempre incluso) e promemoria. Scrive.sync-check-meetings Elenca a pagine i prossimi impegni, per evitare sovrapposizioni. Sola lettura.
Gestione Documenti
Gli allegati dei record del gestionale: caricarli (base64, a pezzi o da link), elencarli, leggerli, cancellarli, spostarli su un altro record, e stampare il PDF di un report del gestionale (preventivo, fattura…).
Quando si usa. Per attaccare un documento a un record o avere il PDF di un documento del gestionale. Nel corpo l'azione si scrive col trattino basso (upload_and_link_doc). Chi non è amministratore di sistema vede solo allegati di record a cui ha accesso.
- Livello: compreso dal livello 2.
Le 9 azioni
require-document-type Dice quali documenti sono richiesti per lo stato attuale di un record (dalla configurazione dei passi, voci di tipo 'document') e quali risultano già caricati (confronto sul nome del file).upload-and-link-doc Carica un file (base64) come allegato di un record e scrive una nota nel suo storico. Scrive.upload-chunk-doc Carica un file grande a pezzi base64. Il primo pezzo crea l'allegato e torna upload_id; i successivi, con upload_id, si accodano; con is_last_chunk=true fissa il tipo e scrive la nota nello storico.upload-from-url Scarica un file da un indirizzo (controllato: niente reti interne) e lo allega a un record, con nota nello storico. Il nome viene da filename, dall'intestazione del server o dall'indirizzo.list-attachments Elenca gli allegati, dal più recente, a pagine. Chi non è amministratore di sistema deve indicare model e record_id di un record che può leggere.get-attachment Legge i dati di un allegato e, se chiesto, il contenuto in base64.delete-attachment Cancella definitivamente un allegato. Non chiede conferma.generate-erp-report Stampa in PDF un report del gestionale per uno o più record e lo restituisce in base64. Non salva allegati.link-existing-doc Sposta un allegato esistente su un altro record (cambia il record a cui è legato). Scrive.
Gestione Helpdesk
Gestisce i ticket di assistenza di SoWay dal lato di chi da' assistenza: aprire un ticket, cambiarne stato, urgenza o responsabile, rispondere al cliente.
Quando si usa. Per l'assistenza ai clienti dell'azienda. I ticket hanno quattro stati: nuovo, in_corso, in_attesa (del cliente), chiuso. Il cliente apre e legge i suoi ticket con gli strumenti del cliente (customer_apri_ticket, customer_miei_ticket).
- Livello: compreso dal livello 2.
Le 3 azioni
create-ticket Apre un ticket nell'azienda collegata, stato «nuovo». La descrizione diventa il primo messaggio della conversazione, visibile al cliente.update-ticket Cambia responsabile, stato o urgenza di un ticket. Con stato «chiuso» lo chiude, segna la data di chiusura e, se c'e' un motivo, lo scrive nella conversazione.reply-ticket Scrive una risposta nel ticket come messaggio visibile al cliente (non nota interna): puo' arrivargli anche per email.
Gestione Vendite
Tre operazioni di vendita di base sul gestionale: creare un preventivo, confermarlo in ordine, e segnare un'opportunità del CRM come vinta legandola a un cliente.
Quando si usa. Per operazioni rapide sugli ordini dell'azienda. Per cercare, modificare, inviare o stampare i preventivi ci sono altri strumenti (list_quotations, update_quotation, send_quotation, print_quotation). Nel corpo le azioni si scrivono con il trattino basso (create_quotation).
- Livello: compreso dal livello 2.
Le 3 azioni
create-quotation Crea un preventivo in bozza per un cliente, con le righe indicate. Se una riga non è valida non resta nessun preventivo a metà. Scrive.confirm-quotation Conferma un preventivo dell'azienda trasformandolo in ordine di vendita (può avviare consegne e approvvigionamenti). Se qualcosa fallisce la conferma viene annullata. Scrive, senza conferma della persona.convert-lead Lega un'opportunità del CRM a un cliente (quello indicato, oppure ne crea uno dai dati del lead se manca) e la segna come VINTA. Scrive.
Gestione Views
Interfacce generate dai dati del gestionale: descrive un modello in una chiamata, crea dashboard grafiche e moduli da compilare condivisibili con un link (magic link), e gestisce le configurazioni 'a passi' (quali campi mostrare in ogni stato di un record).
Quando si usa. Per mostrare dati a una persona con un link (dashboard) o farle compilare campi di un record (form). Per leggere o scrivere dati usa «Dati del gestionale (CRUD)». I nomi azione accettano sia il trattino sia il trattino basso (describe-model = describe_model).
- Livello: compreso dal livello 2.
- Nel pannello: Magic link (
/mio/magic).
Le 10 azioni
describe-model Descrive un modello in una sola chiamata: campi, misure numeriche aggregabili e tipi di vista disponibili.visualize Aggrega i dati di un modello (più misure, pivot) e crea una dashboard grafica con magic link. Crea solo il link, non cambia i dati.get-step-view Restituisce lo schema dei campi da mostrare per un record nel suo stato attuale, filtrato dalla configurazione a passi se esiste, con i valori attuali. Solo lettura.get-model-ui-schema Elenca i campi di un modello con il widget consigliato (text, select, many2one…), obbligatorietà, opzioni delle selezioni, e le informazioni sul campo di stato.register-step-config Crea o aggiorna un passo: per modello e stato, quali campi mostrare e richiedere e quali azioni abilitare. Scrive. Solo amministratore di sistema; vale per tutte le aziende.list-step-configs Elenca le configurazioni a passi attive, a pagine.create-magic-link Crea un magic link: un modulo per compilare campi di un record (form) o una pagina con il tuo HTML (dashboard). Si apre senza login, sul dominio dell'azienda.delete-step-config CANCELLA una configurazione a passi, per id oppure tutte quelle di un modello e stato. Solo amministratore di sistema. Nessuna conferma.get-record-state Dice lo stato attuale di un record, tutti i valori possibili dello stato e il passo successivo configurato con i suoi campi richiesti. Solo lettura.update_magic_link Aggiorna un magic link che hai creato (titolo, contenuto, scadenza, se richiede il login).
Gestione Workflows
Produzione e magazzino del gestionale (distinte base, prenotazioni, trasferimenti), avanzamento di stato di un record e azioni server Python (solo amministratore). Il codice accetta i nomi con il trattino basso (verify_bom_availability, list_pickings...), che sono anche i comandi MCP.
Quando si usa. Usalo per ordini di produzione e trasferimenti di magazzino. Per record generici usa search_records/update_record.
- Livello: compreso dal livello 2.
Le 8 azioni
verify-bom-availability Esplode i componenti di un ordine di produzione e controlla se in magazzino ce ne sono abbastanza. Sola lettura.reserve-materials Prenota i componenti di un ordine di produzione (come il pulsante «Controlla disponibilita'»). Scrive.validate-picking Valida uno o piu' trasferimenti di magazzino: segna le quantita' come fatte e chiude il movimento, SENZA creare arretrati (backorder). Scrive e muove lo stock.advance-workflow-step Fa avanzare lo stato di un record: controlla i campi obbligatori del passo configurato, poi chiama il metodo indicato o il primo standard disponibile (action_confirm, action_validate...). Scrive.get-workflow-state Mostra lo stato di un record, tutti gli stati possibili, i campi obbligatori mancanti, il passo successivo configurato e i metodi di transizione disponibili. Sola lettura.list-pickings Elenca i trasferimenti di magazzino della tua azienda, dal piu' recente, con filtri e pagine.list-production-orders Elenca gli ordini di produzione, dal piu' recente, con filtri e pagine.create-server-action Crea un'azione server del gestionale con codice Python (girera' con privilegi elevati). Solo amministratore di sistema. Operazione sensibile: aggiunge codice eseguibile.
Veicoli
I veicoli dell'azienda (auto, moto, barche, monopattini): anagrafica, chilometri o ore motore, scadenze di assicurazione, revisione e bollo, adattatore OBD e letture della centralina.
Quando si usa. Per consultare o aggiornare i mezzi dell'attività. Leggono tutti quelli che ci lavorano (non i clienti); modificano solo il titolare. Il dipendente può però registrare letture OBD. Non gestisce noleggi né prenotazioni.
- Livello: compreso dal livello 2.
- Nel pannello: Veicoli (
/mio/veicoli).
Le 10 azioni
list-vehicles Elenca i veicoli attivi dell'azienda. Sola lettura.get-vehicle La scheda completa di un veicolo. Sola lettura.expiring I veicoli con una scadenza (assicurazione, revisione, bollo) entro N giorni, compresi quelli già scaduti, ordinati dalla scadenza più vicina. Sola lettura.create-vehicle Aggiunge un veicolo all'azienda. SCRIVE, solo il titolare.update-vehicle Modifica i campi di un veicolo. SCRIVE, solo il titolare. Solo i campi ammessi (gli stessi di create-vehicle); gli altri vengono scartati e segnalati.set-mileage Aggiorna i chilometri (o le ore motore, per le barche). SCRIVE, solo il titolare. Rifiuta un valore più basso del precedente, salvo force.delete-vehicle Toglie un veicolo dall'elenco archiviandolo (non lo cancella: storia e letture restano). SCRIVE, solo il titolare.set-obd-adapter Lega a un veicolo l'adattatore Bluetooth OBD che legge la centralina, o lo stacca con obd_mac vuoto. SCRIVE, solo il titolare.push-obd-reading Registra una lettura della centralina fatta dal telefono. Aggiunge alla storia; può farlo anche un dipendente. I valori non vengono controllati. Se i km letti superano quelli del veicolo, li aggiorna.obd-readings Lo storico delle letture OBD di un veicolo, dalla più recente. Sola lettura.
AI & Discuss
Parla con le persone dell'azienda dentro Discuss (la chat interna del gestionale) attraverso il bot aziendale, apre viste nel gestionale di un utente e interroga direttamente un modello AI configurato.
Quando si usa. Per mandare o leggere messaggi nella chat utente↔bot, far lavorare il bot aziendale, mostrare a un utente una lista, un grafico o un pivot nel suo gestionale, o chiedere qualcosa a un modello AI senza il bot. Un utente dell'azienda raggiunge solo colleghi della propria azienda.
- Livello: compreso dal livello 3.
- Nel pannello: Contenuti (
/mio/contenuti), Chat del sito (/mio/chat).
Le 8 azioni
list-members Elenca gli utenti interni attivi dell'azienda con il loro stato (online, offline) e il bot aziendale.send-message SCRIVE: posta un messaggio COME BOT nella chat fra il bot aziendale e un utente; compare subito. Può anche aprire una vista nel gestionale dell'utente.ask-bot SCRIVE e avvia il bot: posta il messaggio come utente nella chat utente↔bot e fa partire l'agente, che risponde in chat a passi (con i suoi strumenti). La risposta non torna qui: va letta con read-messages.read-messages Legge gli ultimi messaggi della chat fra il bot e un utente, dal più recente, e dice se il bot sta ancora generando.view-fields Per un modello del gestionale restituisce i campi raggruppabili, misurabili e ordinabili, più le azioni e i menu che lo aprono e le viste supportate.open-view Apre una vista (lista, kanban, grafico, pivot o la scheda di un record) nel gestionale aperto dell'utente, già filtrata e raggruppata. Non modifica dati.ask-ai Interroga direttamente il modello AI configurato (Anthropic o compatibile OpenAI), senza bot e senza strumenti. Di norma la domanda e la risposta finiscono nella chat utente↔bot e la risposta si legge con read-messages; con sync=true la risposta torna subito qui.list-models Elenca i modelli disponibili presso il fornitore AI configurato e dice quale è in uso.
Contabilità
Fatture e pagamenti dell'azienda: crea e conferma fatture, registra incassi, e gestisce la fatturazione elettronica italiana via PEC verso lo SdI (verifica, XML, invio, stato, ricevute).
Quando si usa. Per il ciclo attivo della fattura. Lavora solo sui contatti, prodotti e fatture della propria azienda (il superadmin su tutte). Sulla rotta HTTP il nome dell'azione va con il trattino basso (create_invoice, fe_invia_fattura): con il trattino risponde «Unknown action».
- Livello: compreso dal livello 3.
- Nel pannello: Fatture (
/mio/fatture), Fatturazione elettronica (/mio/fatturazione).
Le 8 azioni
create-invoice Crea una fattura in bozza per un contatto dell'azienda. Scrive.post-invoice Conferma (valida) una fattura in bozza: prende il numero definitivo. Scrive.register-payment Registra un pagamento su una fattura confermata. Scrive in contabilità.fe-invia-fattura Genera l'XML FatturaPA di una fattura cliente confermata, lo valida e lo spedisce allo SdI dalla PEC dell'azienda; segna lo stato 'inviata'. Atto fiscale: serve la conferma in due passi (conferma_token dopo il sì della persona).fe-stato-fattura Mostra lo stato SdI di una fattura. Sola lettura.fe-genera-xml Genera l'XML FatturaPA di una fattura cliente confermata, con le validazioni fiscali, senza inviarlo. Allega il file XML alla fattura.fe-verifica Checklist di prontezza dell'azienda per la fatturazione elettronica: paese Italia, Partita IVA, Codice Fiscale, regime fiscale, sede, piano dei conti, PEC in uscita e in arrivo. Sola lettura.fe-leggi-ricevute Legge la PEC in arrivo dell'azienda e aggiorna lo stato delle fatture dalle ricevute SdI (consegna, mancata consegna, scarto). Idempotente. Gira anche da solo ogni 30 minuti.
Documenti PDF
Genera PDF dai report del gestionale (preventivi, fatture, ordini d'acquisto e ogni report QWeb) con stile personalizzabile e impaginazione controllata pagina per pagina dove c'e' un adattatore; salva il PDF come allegato e crea spazi online per rivederlo e annotarlo.
Quando si usa. Usalo quando serve il PDF di un documento del gestionale o un link per farlo vedere e annotare. Per la stampa self-service al punto cassa usa «POS Self-Service Documents».
- Livello: compreso dal livello 3.
Le 4 azioni
list-reports Elenca i report PDF/HTML disponibili, con modello, nome tecnico e se hanno l'impaginazione controllata.generate-pdf Genera il PDF di uno o piu' record con un report e lo salva come allegato (di norma sul record). Scrive un allegato. Controlla che tu possa leggere i record.get-pdf-document Legge i dati di un allegato PDF gia' generato e, se chiesto, il contenuto in base64.create-workspace Crea uno spazio online (link con token) dove vedere e annotare un PDF, partendo da un allegato o da un PDF in base64. Scrive.
Gestione Marketing
Campagne email di massa (Email Marketing del gestionale): crea la campagna, manda una prova a un indirizzo, poi la mette in invio a tutta la lista.
Quando si usa. Per una newsletter o campagna a molti destinatari. Richiede il modulo mailing.mailing installato. Per i flussi automatici a più passi usa «Flussi di marketing e orchestrazione»; per una singola email personale usa «Email (invio/lettura)».
- Livello: compreso dal livello 3.
Le 3 azioni
create-mailing Crea una campagna email in bozza con oggetto e corpo HTML. Non invia nulla.test-mailing Manda la campagna a un solo indirizzo di prova. Invia una email vera, ma solo a quell'indirizzo.send-mailing Mette in invio la campagna a tutti i destinatari della lista. Non si ritira: serve la conferma in due passi (conferma_token dopo il sì esplicito della persona).
Palestra — area gestione
Gestione della palestra per titolare e istruttori: iscritti, anagrafiche, formule in vendita, abbonamenti (iscrizione, sospensione, rinnovo, disdetta), scadenze, soci che non vengono più, ingressi di oggi, appunti sul socio.
Quando si usa. Usala quando chi chiama è personale della palestra (tessera titolare o dipendente, o utente interno). Un socio (cliente) viene rifiutato: per il socio c'è «Palestra — area socio». Lavora solo sulla palestra di chi chiama.
- Livello: compreso dal livello 3.
- Nel pannello: Palestra (
/mio/palestra), Iscritti (/mio/palestra/iscritti), Formule (/mio/palestra/formule), Andamento (/mio/palestra/andamento), Corsi (/mio/palestra/corsi), Agenda lezioni (/mio/palestra/agenda), Code attrezzi (/mio/palestra/code), Personal training (/mio/palestra/pt), Certificati (/mio/palestra/certificati), Anamnesi (/mio/palestra/anamnesi), Consensi (/mio/palestra/consensi), Misurazioni (/mio/palestra/misure), Catalogo (/mio/palestra/catalogo), Varchi (/mio/palestra/varchi).
Le 11 azioni
list-members Elenca gli iscritti della palestra con abbonamento attivo, scadenza, tessera e stato del certificato medico.get-member Scheda completa di un iscritto: dati, tutti gli abbonamenti di questa palestra con stato e pagamento, ultimi 10 appunti e ultimi 5 ingressi.create-member SCRIVE: crea un nuovo iscritto (solo anagrafica, l'abbonamento è un'altra azione). Se esiste già un contatto con lo stesso telefono in questa palestra non lo duplica: restituisce quello con already_existed.update-member SCRIVE: corregge l'anagrafica di un iscritto. Accetta solo name, email, city, street, zip, phone dentro 'values'.list-plans Elenca le formule di abbonamento in vendita (prodotti di tipo iscrizione) con il prezzo vero configurato dal titolare, dal più economico.create-subscription SCRIVE: iscrive un socio a una formula, crea l'abbonamento e prova ad attivarlo. Se l'attivazione fallisce l'abbonamento resta in bozza e lo dice in 'warning'.subscription-action SCRIVE: cambia lo stato di un abbonamento: attiva, sospendi, riattiva, rinnova o disdici.expiring-subscriptions Elenca gli abbonamenti attivi o confermati che scadono da oggi entro N giorni, dal più vicino.inactive-members Elenca i soci con abbonamento attivo che non hanno fatto ingressi negli ultimi N giorni, con l'ultima volta che sono stati visti.today-checkins Elenca gli ingressi di oggi, dal più recente, con l'esito del controllo all'ingresso.add-note SCRIVE: aggiunge un appunto su un socio (quello che l'istruttore si scriverebbe a mano).
Palestra — area socio
L'area del socio di palestra: abbonamento, certificato, scheda, piano alimentare, corsi, prenotazioni, misure e piccoli ordini al negozio. Lavora SEMPRE sul socio collegato al token: nessuna azione accetta l'id di un altro socio.
Quando si usa. Usalo quando parla il socio stesso (ruolo cliente). Per la gestione della palestra da parte del titolare o dello staff (iscritti, abbonamenti, check-in) usa gli strumenti gym_* dello staff, non questo.
- Livello: compreso dal livello 3.
Le 13 azioni
get-my-membership Stato del socio: abbonamento attivo, scadenza, giorni rimasti, pagamento, certificato medico e se oggi puo' entrare.get-my-workout-plan La scheda di allenamento attiva del socio, con giorni ed esercizi (serie, ripetizioni, carico, recupero, video).get-my-nutrition-plan Il piano alimentare emesso per il socio (pasti, alimenti, grammi, calorie). Serve il consenso ai dati sanitari.get-my-bookings Le prenotazioni future del socio (prenotate o in lista d'attesa).get-timetable I corsi aperti nei prossimi giorni, con posti liberi e se il socio e' gia' prenotato.book-session Prenota il socio su un corso; se e' pieno lo mette in lista d'attesa. Scrive. Applica le regole d'accesso (abbonamento, certificato, no-show).cancel-booking Disdice una prenotazione del socio. Scrive.log-workout Registra un allenamento svolto, collegato alla scheda attiva. Scrive.list-products Il catalogo del negozio della palestra, con prezzo e disponibilita'.create-order Crea per il socio un ordine con un solo prodotto del negozio. Scrive. Con ritiro si paga in palestra.my-orders Gli ultimi 10 ordini del socio, dal piu' recente.update-measures Aggiunge una nuova rilevazione di peso e circonferenze (non modifica le passate). Scrive.get-my-measures Le ultime 12 rilevazioni del socio, dalla piu' recente, con BMI.
Risorse Umane
Risorse umane di base: crea una richiesta di ferie o permesso per un dipendente e registra ore lavorate (foglio ore) su un progetto o un'attività.
Quando si usa. Per segnare un'assenza o le ore di un dipendente. Nel corpo della chiamata HTTP l'action si scrive con il trattino basso (create_leave_request, log_timesheet); il permesso si controlla sul nome col trattino. Per progetti e attività usa «Progetti & Task (team)».
- Livello: compreso dal livello 3.
Le 2 azioni
create-leave-request SCRIVE: crea una richiesta di assenza (ferie, permesso, malattia) per un dipendente, nel tipo di assenza indicato. La richiesta segue poi l'approvazione normale del gestionale.log-timesheet SCRIVE: registra ore lavorate da un dipendente su un progetto, ed eventualmente su un'attività, nel foglio ore. Serve il modulo Fogli ore (hr_timesheet).
Calcoli ed esecuzione di codice
Esegue codice Python scritto dall'assistente su dati che gli passa, dentro un recinto, sull'esecutore (macchina Linux) dell'azienda. Per i conti che gli strumenti fissi non fanno: riconciliare elenchi, sommare per mese, contare notti, trovare sovrapposizioni fra prenotazioni.
Quando si usa. Solo se l'azienda ha agganciato un suo esecutore Linux acceso (si aggancia con «Esecutori esterni e deleghe»). Il codice non vede del gestionale, la rete o i file: i dati dell'azienda vanno letti prima con gli altri strumenti e passati in 'dati'.
- Livello: compreso dal livello 4.
Le 3 azioni
documentazione Dice se il calcolo è disponibile per questa azienda e quali funzioni pronte ha il recinto (date, periodi, somme, raggruppamenti, testo), con un esempio.esegui ESEGUE CODICE: manda codice e dati all'esecutore dell'azienda e aspetta l'esito. I dati arrivano nella variabile `dati`; torna ciò che assegni a `risultato` e ciò che stampi con print. Se non finisce in tempo, torna un job_id da ritirare con stato.stato Ritira l'esito di un calcolo rimasto in sospeso, se è dell'azienda.
Database esterni
I database del gestionale collegati a Meridian, il gateway MCP di Working With Web / DCSystem: MySQL, MariaDB, PostgreSQL e il gestionale in SOLA LETTURA. L'assistente li usa con l'account Meridian di chi ha collegato: il superadmin di Meridian vede e gestisce tutti i database, un cliente vede solo i suoi. Oltre alle azioni fisse, ogni strumento di Meridian e' un'azione db.<nome> con i parametri in `argomenti`: db.list_clienti, db.show_tables, db.read, db.query, db.leggi_istruzioni, db.modifica_istruzioni, db.nuovo_cliente, db.assegna_cliente, db.list_utenti. Le password dei database non passano da qui: si inseriscono nel pannello di Meridian, mostrato in /mio/myexternaldb.
Quando si usa. Per rispondere con i numeri veri del gestionale (fatturato, clienti, magazzino, scadenze). Ordine consigliato: db.list_clienti -> db.leggi_istruzioni -> db.show_tables -> db.query con una SELECT. Per aggiungere un database: db.nuovo_cliente, poi la password nel pannello.
- Livello: compreso dal livello 4.
- Serve un collegamento: il tuo account Meridian, che colleghi tu una volta dal pannello, pagina
/mio/myexternaldb (pulsante «Collega con Meridian»).
Le 7 azioni
documentazione Spiega cosa fa il connettore Meridian, cosa serve, chi puo' fare cosa, esempi e gli strumenti di Meridian.stato Dice se l'account Meridian e' collegato, da chi, quando, scadenza del token, permessi concessi e ultimo errore.strumenti-remoti Cerca fra gli strumenti che Meridian espone, per parola nel nome o nella descrizione.aggiorna-strumenti Rilegge da Meridian l'elenco dei suoi strumenti (dopo un aggiornamento di Meridian).registro Le modifiche fatte su Meridian da SoWay (istruzioni, nuovi clienti, assegnazioni): quando, chi, strumento, esito.collega Non collega da qui: risponde con il link di /mio/myexternaldb, dove il titolare entra con il suo account Meridian.scollega Non scollega da qui: risponde con il link della pagina, dove il titolare preme Scollega.
Facebook e Instagram (MCP ufficiale di Meta)
L'account Meta (Facebook e Instagram) collegato dall'azienda, tramite il server MCP ufficiale di Meta: inserzioni, cataloghi, report e diagnostica. Ogni strumento di Meta si chiama come azione 'meta.<nome>' con 'argomenti'. Non pubblica post organici sulla Pagina e non risponde ai commenti.
Quando si usa. Per le inserzioni Meta dell'azienda: titolare e dipendenti (questi solo strumenti di sola lettura), con l'area Meta accesa. L'account si collega dal portale /mio/facebook, mai dalla conversazione.
- Livello: compreso dal livello 4.
- Serve un collegamento: il tuo account Meta, che colleghi tu una volta dal pannello, pagina
/mio/facebook (pulsante «Collega con Facebook»).
Le 13 azioni
documentazione Spiega lo strumento: cosa fa e cosa no, se l'account è collegato, le azioni fisse, le regole, e l'elenco degli strumenti del fornitore (meta.<nome>) con sola_lettura e puoi_usarlo per il tuo ruolo.stato Dice se l'account Meta dell'azienda è collegato, da chi e quando, la scadenza, i permessi concessi, quanti strumenti ha il fornitore e l'ultimo errore.strumenti-remoti Cerca fra gli strumenti dichiarati dal server di Meta, per nome o descrizione.aggiorna-strumenti Rilegge dal server di Meta l'elenco dei suoi strumenti e lo salva.registro Mostra il registro delle modifiche fatte con gli strumenti di scrittura di Meta: chi, quando, quale strumento, argomenti ed esito. Solo per il titolare.collega Non collega nulla: risponde con il link al portale (/mio/facebook) dove il titolare preme «Collega con Facebook». La password non passa mai dalla conversazione.scollega Non scollega nulla: risponde con il link al portale (/mio/facebook) da cui il titolare scollega l'account.flussi Elenca i flussi di dati dell'azienda con Meta (in entrata da Meta a SoWay o in uscita da SoWay a Meta), con strumento, mappa, intervallo e ultimo esito.flussi-pronti Mostra i flussi già pronti per questo fornitore (per Meta l'elenco può essere vuoto), i modelli SoWay usabili in entrata e in uscita e come si scrive una mappa.flusso-prova Prova a vuoto un flusso (esistente o descritto nella chiamata): mostra cosa farebbe senza scrivere niente, né in SoWay né su Meta. Solo titolare.flusso-salva SCRIVE, con conferma in due passi: crea o cambia un flusso di dati. Un flusso acceso con intervallo lavora da solo; in uscita scrive su Meta. Solo titolare.flusso-esegui Esegue subito un giro di un flusso salvato. In entrata porta dati da Meta a SoWay; in uscita SCRIVE su Meta (può creare contenuti o spendere) e chiede conferma in due passi con conferma_token. Solo titolare.flusso-elimina CANCELLA, con conferma in due passi: elimina un flusso. I record già portati restano, ma si perde la memoria di cosa è già passato. Solo titolare.
Flussi di marketing e orchestrazione
Costruisce e gestisce flussi a passi (marketing automation) su contatti, lead, ordini o attivita' dell'azienda: email del gestionale, attivita' da fare o un qualunque strumento SoWay, con bivi su aperture, clic, risposte e attese.
Quando si usa. Usalo per campagne automatiche e sequenze (benvenuto, riattivazione, follow-up). Solo il titolare (o l'amministratore di sistema): per gli altri ogni azione tranne documentazione risponde 403. Parti da documentazione. Per una singola campagna email senza passi usa «Gestione Marketing».
- Livello: compreso dal livello 4.
- Nel pannello: Flussi (
/mio/flussi).
Le 20 azioni
documentazione Spiega come funzionano i flussi, i tipi di passo, l'ordine di costruzione e il formato del filtro.modelli Elenca i modelli su cui un flusso puo' lavorare: res.partner (contatti), crm.lead, sale.order, project.task (solo quelli installati).bivi Elenca i valori ammessi per 'quando' di un passo (start, after_step, mail_open, mail_not_open, mail_click, mail_reply, mail_bounce, activity_done...) e dopo che tipo di passo si possono usare.strumenti Elenca gli strumenti SoWay che la persona collegata puo' usare in un passo di tipo soway_tool (esclusi i flussi stessi).elenca-flussi Elenca i flussi dell'azienda, dal piu' recente, con stato e numeri.dettaglio-flusso Mostra un flusso con tutti i suoi passi e le statistiche di ciascun passo.crea-flusso Crea un flusso in bozza (non parte nulla finche' non lo avvii). Scrive.aggiorna-flusso Cambia nome, filtro o periodicita' di un flusso esistente. Scrive.elimina-flusso Cancella un flusso con i suoi passi e partecipanti. Irreversibile.crea-email Crea un mailing del gestionale (con disiscrizione e report) da usare in un passo di tipo mailing. Non invia nulla.aggiungi-passo Aggiunge un passo (mailing, attivita' o strumento SoWay) con bivio e attesa. Scrive.aggiorna-passo Cambia nome, attesa, unita' o argomenti (solo per soway_tool) di un passo. Scrive.togli-passo Cancella un passo dal flusso.prova-flusso Fa girare il flusso in prova su un solo record ed esegue subito i passi iniziali. Senza invia_a le email non partono; con invia_a partono davvero ma solo a quell'indirizzo. Attenzione: i passi soway_tool vengono eseguiti.avvia-flusso Avvia un flusso in bozza o riprende uno fermato, e lo esegue subito: le email partono davvero e i passi eseguono gli strumenti. Chiede conferma con token in due passi.ferma-flusso Mette in pausa un flusso. Si riprende con avvia-flusso.statistiche I numeri del flusso passo per passo (inviate, aperte, cliccate, risposte, rimbalzate, errori). Stessa risposta di dettaglio-flusso.modelli-pronti Elenca i flussi gia' fatti da cui partire: benvenuto, riattivazione, lead_caldi, dopo_acquisto.crea-da-modello Crea in bozza un flusso completo da un modello pronto, con mailing e passi gia' scritti da ritoccare. Non invia nulla.cerca-record Cerca per nome fino a 15 record dell'azienda su un modello ammesso.
Fogli di calcolo
I fogli di calcolo dell'azienda (come Excel o Google Fogli, nel portale in /mio/fogli): elenca, cerca anche dentro le celle, legge e scrive celle e formule, crea, rinomina, elimina, importa ed esporta .xlsx, prende fogli da link condivisi e da Nextcloud.
Quando si usa. Quando la persona parla di un foglio di calcolo, una tabella Excel o un .xlsx dell'azienda. Solo il titolare (o l'amministratore di sistema); dipendenti e clienti ricevono 403. Ogni foglio resta dentro l'azienda di chi chiede.
- Livello: compreso dal livello 4.
- Nel pannello: Fogli (
/mio/fogli).
Le 18 azioni
documentazione Spiega come funzionano i fogli, come si indicano celle e intervalli, e in che ordine usare le azioni. Sola lettura, aperta a tutti.elenca Elenca i fogli dell'azienda, dai più modificati, con nome, revisione, schede e numero di celle piene.cerca Cerca un testo (senza distinguere maiuscole) nei nomi dei fogli e dentro tutte le celle, formule comprese.dettaglio Mostra un foglio con le sue schede, quante celle piene ha ciascuna e fino a quale cella arrivano i dati (es. F42).leggi Legge le celle piene di una scheda o di un intervallo. Le formule arrivano come testo; i loro risultati solo se il foglio è stato salvato dal portale dopo l'ultima modifica.scrivi Scrive o svuota celle di una scheda, anche formule (testo che inizia con =). Scrive davvero e alza la revisione.crea Crea un nuovo foglio vuoto (una scheda 'Foglio1'), e se passi celle le scrive subito.aggiungi-scheda Aggiunge una scheda vuota in fondo a un foglio.rinomina Cambia il nome di un foglio.elimina Elimina un foglio con tutte le sue schede. Non si recupera. Via MCP chiede conferma in due passi: la prima chiamata torna un riepilogo e un conferma_token; dopo il sì della persona si richiama con gli stessi argomenti più conferma_token.importa-xlsx Crea un nuovo foglio da un file Excel .xlsx: per ogni scheda valori e formule (senza stili né grafici).esporta-xlsx Restituisce un foglio come file .xlsx in base64. Con stili e grafici se l'ultima modifica è stata fatta dal portale (fonte 'browser'), altrimenti solo valori e formule (fonte 'server').importa-da-link Scarica come .xlsx un foglio condiviso con «chiunque abbia il link» da Google Fogli, Google Drive, OneDrive / Office 365 o Nextcloud, e ne crea un foglio. Solo link https verso indirizzi pubblici, massimo 20 MB.nextcloud-collega Salva il Nextcloud dell'azienda (uno per azienda) e prova subito l'accesso; se la cartella non esiste la crea. Sovrascrive un collegamento precedente.nextcloud-elenca Elenca i file .xlsx presenti nella cartella Nextcloud collegata.nextcloud-importa Scarica un .xlsx dalla cartella Nextcloud e ne crea un nuovo foglio.nextcloud-esporta Salva un foglio come <nome>.xlsx nella cartella Nextcloud. Se esiste già un file con lo stesso nome lo sovrascrive.nextcloud-scollega Cancella il collegamento a Nextcloud dell'azienda (indirizzo, utente e password per app salvati). I file su Nextcloud restano.
Google Ads
L'account Google Ads collegato dall'azienda (/mio/google-ads), con l'API ufficiale di Google. Oltre alle azioni fisse, ogni strumento di Google è un'azione gads.<nome> con i parametri in `argomenti` (es. gads.search con GAQL, gads.report_campagne).
Quando si usa. Per campagne, annunci, parole chiave e metriche, o per i flussi di dati. Titolare e dipendenti, area Google Ads accesa. Chi modifica (solo titolare) conferma in due passi. Parti da documentazione.
- Livello: compreso dal livello 4.
- Serve un collegamento: il tuo account Google Ads, che colleghi tu una volta dal pannello, pagina
/mio/google-ads (pulsante «Collega con Google»).
Le 13 azioni
documentazione Dice cosa sa fare lo strumento, se l'account è collegato, le azioni fisse e l'elenco degli strumenti gads.* con sola_lettura e puoi_usarlo. Con action=documentazione_gads.<nome> dà i parametri di uno strumento.stato Dice se l'account Google Ads è collegato, da chi, quando, i permessi concessi, la scadenza, quanti strumenti ci sono e l'ultimo errore. Sola lettura.strumenti-remoti Cerca fra gli strumenti gads.* disponibili, per nome o descrizione. Sola lettura.aggiorna-strumenti Rilegge l'elenco degli strumenti del fornitore.registro Mostra le modifiche fatte sull'account tramite SoWay: quando, chi, strumento, argomenti, esito. Solo titolare. Sola lettura.collega Non collega nulla: risponde con il link del portale dove il titolare fa il login con Google. La password non passa mai dalla chat.scollega Non scollega nulla: risponde con il link del portale dove il titolare scollega l'account.flussi Elenca i flussi di dati dell'azienda fra SoWay e Google Ads. Sola lettura.flussi-pronti Mostra i flussi già pronti per questo fornitore (per Google Ads oggi l'elenco è vuoto), i modelli SoWay usabili in entrata e in uscita e come si scrive una mappa.flusso-prova Prova a vuoto un flusso (salvato o descritto nella chiamata): legge e mostra cosa farebbe, senza scrivere né in SoWay né su Google. Solo titolare.flusso-salva Crea o cambia un flusso di dati. Solo titolare, con conferma in due passi (conferma_token dopo il sì). Un flusso acceso lavora da solo.flusso-esegui Esegue subito un giro del flusso. In entrata scrive in SoWay; in uscita scrive su Google Ads e chiede la conferma in due passi. Solo titolare.flusso-elimina Elimina un flusso. I record già portati restano, ma si perde la memoria di cosa è già passato. Solo titolare, conferma in due passi.
POS Document Printer
Stampa documenti PDF sulla stampante documentale (A4) configurata per un punto vendita: elenca le casse con stampante, ne verifica lo stato e manda il PDF.
Quando si usa. Per stampare in negozio un preventivo, una fattura o un file. La stampante va prima abilitata e configurata sulla cassa. Per sessioni e scontrini usa «POS & Browser Agent».
- Livello: compreso dal livello 4.
Le 3 azioni
list-pos-printers Elenca le casse con i dati della stampante documentale e delle stampanti di preparazione, a pagine.printer-status Verifica se la stampante documentale di una cassa è pronta (connessione TCP o chiamata allo stato del gateway).print-document Manda un PDF alla stampante documentale della cassa: generato da un report, preso da allegati o passato in base64. Salva una copia come allegato.
POS Self-Service Documents
Gestisce gli ordini documento del punto cassa self-service: il cliente manda un file (WhatsApp, caricamento o scansione), il documento viene diviso in pagine, pagato e stampato sulla stampante documenti della cassa. Include anche l'invio e la lettura di messaggi WhatsApp dall'account collegato all'utente.
Quando si usa. Usalo per copisterie e stampa self-service al POS. Gli ordini sono sempre ristretti alle aziende di chi chiama. Per la vendita normale al POS usa gli strumenti pos_*; per i PDF dei report del gestionale usa «Documenti PDF».
- Livello: compreso dal livello 4.
Le 19 azioni
create-document-order Crea un ordine documento per una cassa, con codice casuale (DOC-AAAAMMGG-...) e link QR per WhatsApp. Scrive.list-document-orders Elenca gli ordini documento delle tue aziende, dal piu' recente, con paginazione.get-document-order Legge un ordine documento e le sue pagine. Se ci sono file allegati e non e' ancora diviso, lo divide in un ordine per pagina.attach-document-file Allega un file in base64 all'ordine, lo porta in stato editing e lo divide in pagine. Scrive.bind-pos-line Collega l'ordine documento a un ordine o a una riga della cassa e aggiorna la riga POS con codice, QR e stato del documento. Scrive.whatsapp-message-received Registra un messaggio WhatsApp arrivato per un ordine: allega i file, salva telefono e testo, divide in pagine. Scrive.whatsapp-status Controlla sul gateway lo stato della sessione WhatsApp collegata al tuo utente e lo aggiorna nel gestionale.whatsapp-send-message Invia un messaggio di testo WhatsApp dall'account collegato al tuo utente. Manda un messaggio vero a una persona.whatsapp-list-accounts Mostra l'account WhatsApp che usi (il tuo, o quello di sistema se sei amministratore con l'opzione master attiva).whatsapp-list-conversations Elenca le chat WhatsApp dell'account collegato, lette dal gateway.whatsapp-list-messages Legge i messaggi di una chat WhatsApp dell'account collegato.whatsapp-reply-message Risponde citando un messaggio WhatsApp preciso. Manda un messaggio vero.request-scan Acquisisce una scansione per l'ordine. Con file_data_b64 allega il file direttamente (modalita' simulata); altrimenti chiede la scansione al gateway hardware della cassa (POST a <gateway>/scan). Scrive.create-edit-workspace Prepara il PDF da stampare e crea uno spazio di modifica online (link) dove il cliente puo' ritoccarlo. Scrive.record-payment Registra un pagamento sull'ordine documento (somma a quanto gia' pagato). Se raggiunge il totale lo segna pagato e, con auto_print, stampa subito. Scrive.hardware-event Registra un evento dell'hardware di cassa (gettoniera, pagamento, scanner, stampante). coin_credit, cash_completed e card_approved registrano il pagamento; card_rejected lo segna fallito. Scrive.print-order Stampa il documento dell'ordine sulla stampante documenti della cassa (usa la versione modificata se c'e'). Senza dry_run stampa davvero.print-pos-order-documents Per un ordine POS: segna come pagati (metodo pos) gli ordini documento collegati e stampa quelli che hanno il file. Scrive e stampa.reset-document-order Annulla l'ordine documento: stato e pagamento passano a cancelled. Non cancella il record.
Provenienza lead e conversioni
Provenienza delle lead e conversioni dell'azienda: da dove arriva ogni lead (fonte, campagna, UTM, click-id, consenso), la sua cronologia commerciale e le regole che decidono quali eventi diventano conversioni per Google Ads e Meta. Le lead nascono dai moduli del sito, dalla chat, da WhatsApp e da Roylead; la stessa persona resta una lead sola con piu' arrivi. L'invio a Meta (Conversions API) e a Google Ads (conversioni con gclid ed Enhanced Conversions for Leads) si accende per installazione e per azienda; finche' e' spento le regole riempiono solo la coda.
Quando si usa. Per sapere quale campagna porta clienti veri, seguire una lead fino alla vendita e decidere cosa rimandare alle piattaforme pubblicitarie. Titolare e dipendenti, dal livello 4, con l'area «Provenienza lead e conversioni» accesa. Parti da lead-cerca o da fonti.
- Livello: compreso dal livello 4.
Le 15 azioni
documentazione Spiega come funziona: arrivi, cronologia, regole, coda, tipi di evento e destinazioni.lead-cerca Cerca le lead dell'azienda per nome, email o telefono. Per ognuna: stadio, fonte del primo arrivo, se e' pre-registrazione o utente registrato.lead-origine Da dove arriva una lead: primo e ultimo arrivo con fonte, campagna, UTM, pagina, consenso e quali click-id sono presenti (solo si/no: il valore non si mostra).lead-cronologia La storia della lead: ricevuta, contattata, qualificata, appuntamento, preventivo, vinta, persa, registrata, con data vera, chi e versione; piu' le conversioni in coda con stato e abbinamento.fonti Quante lead sono arrivate per fonte (sito, modulo, chat, WhatsApp, Roylead...) e per campagna negli ultimi giorni.regole-elenco Le regole dell'azienda: quale evento diventa una conversione, per quale piattaforma, con che nome e valore, se richiede il consenso.regola-imposta Crea o cambia la regola per un evento e una piattaforma (una sola per coppia). Solo titolare, in due passi con conferma_token.regola-elimina Elimina una regola. Solo titolare, in due passi con conferma_token.coda Le conversioni in coda: evento, piattaforma, valore, stato (in_attesa, bloccata_consenso, bloccata_proprietario, inviata, accettata, rifiutata, errore) e abbinamento. Accettata non vuol dire abbinata a una campagna.evento-registra Registra a mano un evento commerciale (contattata, qualificata, non qualificata, appuntamento, preventivo). Anche i dipendenti. Vinta e persa passano dalla lead.diagnostica Dice cosa e' configurato per l'invio: dataset e token Meta (presente si/no), collegamento Google Ads e account predefinito, i due interruttori dell'invio (installazione e azienda) e quante conversioni ci sono per destinazione e stato.meta-imposta Imposta per Meta il dataset (pixel) id, il token della Conversions API (salvato cifrato, non si rilegge) e il codice degli eventi di prova. Solo titolare, due passi con conferma_token.tiktok-imposta Imposta per TikTok (Events API) il pixel code oppure l'id dell'event set CRM, dove vanno gli eventi (fonte web = pixel del sito, crm = event set per le campagne di generazione contatti), il token Events API (salvato cifrato, non si rilegge) e il codice degli eventi di prova. Solo titolare, due passi con conferma_token.conversione-invia Manda ora a Google, Meta e TikTok le conversioni in attesa dell'azienda. Solo titolare, con conferma, e solo se l'invio e' acceso per l'installazione e per l'azienda. Email e telefono escono solo come hash SHA-256; lo stesso evento non parte due volte.conversione-riprova Rimette in coda una conversione rifiutata, in errore, abbandonata o bloccata per consenso (quest'ultima solo se ora il consenso c'e'). Solo titolare, con conferma.
Report
Report per l'azienda: salute tecnica e SEO di un dominio, posizioni su Google, PageSpeed, gestionale (fatturato, ordini, abbonamenti), sito WordPress collegato, traffico Google Analytics e Cloudflare. Alcuni salvano un PDF col marchio dell'azienda.
Quando si usa. Per analisi e report da consegnare.Il nome dell'azione si scrive col trattino o col trattino basso: vanno bene tutti e due.
- Livello: compreso dal livello 4.
Le 11 azioni
documentazione Restituisce una breve guida testuale dello strumento.analizza-dominio Analizza un sito qualsiasi: raggiungibilità, HTTPS, redirect, titolo, meta description, H1, immagini senza alt, viewport, canonico, certificato SSL, scadenza del dominio.visibilita-seo Cerca su Google (via SerpAPI) la posizione del dominio per una o più parole chiave, con i primi 3 risultati.genera-dominio Unisce analisi del dominio, visibilità SEO (se passi keyword) e PageSpeed (se la chiave di piattaforma c'è) in un report salvato con PDF col marchio dell'azienda e punteggio su 100.performance Misura il sito con Google PageSpeed Insights: punteggi performance, SEO, accessibilità, best practices e Core Web Vitals (LCP, CLS, TBT, FCP).genera-gestionale Report gestionale dell'azienda su un periodo: fatturato, incassato, ordini, fatture, valore medio, 5 prodotti più venduti, abbonamenti, confronto col periodo precedente; aggiunge Analytics e Cloudflare se collegati. Salva un PDF.report-wordpress Controlla il sito WordPress collegato all'azienda: REST API, nome, numero di articoli e pagine, ultimo articolo, HTTPS, SSL, scadenza dominio.report-analytics Traffico del sito da Google Analytics 4: utenti, nuovi utenti, sessioni, visualizzazioni sul periodo.report-cloudflare Traffico lato server da Cloudflare per il dominio dell'azienda: richieste, visitatori unici, banda.lista-report Elenca i report salvati dall'azienda, i più recenti prima.dettaglio-report Restituisce un report salvato con tutti i dati.
Roylead
Usa l'account Roylead collegato dall'azienda (landing, offerte, lead, pixel, creatività, campagne Meta sempre in pausa, ROI) e gestisce i flussi di dati fra SoWay e Roylead. Ogni strumento di Roylead si chiama come azione roylead.<nome> con gli argomenti in «argomenti».
Quando si usa. Per lavorare su Roylead dell'azienda. Lo usano titolare e dipendenti (i dipendenti solo in lettura), mai i clienti finali. L'area Roylead deve essere accesa. Il collegamento si fa dal portale /mio/roylead.
- Livello: compreso dal livello 4.
- Serve un collegamento: il tuo account Roylead, che colleghi tu una volta dal pannello, pagina
/mio/roylead (pulsante «Collega con Roylead»).
Le 13 azioni
documentazione Spiega lo strumento: cosa fa, se l'account è collegato, le azioni fisse e l'elenco degli strumenti di Roylead con sola_lettura e puoi_usarlo.stato Dice se l'account Roylead è collegato, da chi, quando, scadenza, permessi e ultimo errore.strumenti-remoti Cerca fra gli strumenti che Roylead espone, per parola nel nome o nella descrizione.aggiorna-strumenti Rilegge da Roylead l'elenco dei suoi strumenti.registro Mostra le modifiche fatte su Roylead da SoWay: quando, chi, strumento, argomenti, esito.collega Non collega da qui: risponde con il link del portale dove il titolare fa il login su Roylead.scollega Non scollega da qui: risponde con il link del portale dove farlo.flussi Elenca i flussi di dati dell'azienda con Roylead (in entrata o in uscita).flussi-pronti Mostra i flussi già pronti per Roylead (lead_crm, roi_giornaliero, offerte, prodotti_landing, immagini_galleria) e come si scrive una mappa. Per le lead c'e' «lead_crm_v2» (Lead di Roylead -> CRM con provenienza: campagna e landing come arrivo, dato originale in un campo tecnico, descrizione del commerciale intatta, ritorno delle conversioni lasciato a Roylead), da preferire alla vecchia «lead_crm».flusso-prova Prova a vuoto un flusso: mostra cosa farebbe senza scrivere niente, né in SoWay né su Roylead.flusso-salva Crea o modifica un flusso di dati con Roylead.flusso-esegui Esegue subito un flusso salvato.flusso-elimina Elimina un flusso. I record già portati restano, ma si perde la memoria di cosa è già passato.
Scheda Google
La Scheda Google (Google Business Profile) collegata dall'azienda da /mio/google-business, con le API ufficiali di Google. Oltre alle azioni fisse, ogni strumento e' un'azione gbp.<nome> con i parametri in `argomenti`: gbp.account_elenco, gbp.sedi_elenco, gbp.sede_predefinita, gbp.scheda_leggi, gbp.aggiornamenti_google, gbp.attributi_leggi, gbp.recensioni_elenco, gbp.post_elenco, gbp.link_azione_elenco, gbp.prestazioni, gbp.parole_ricerca. SCRITTURE (solo titolare, due passi con conferma_token): gbp.recensione_rispondi (recensione, testo), gbp.recensione_risposta_togli (recensione), gbp.post_pubblica (tipo novita|evento|offerta, testo, titolo, inizio, fine, pulsante, link, foto, codice_sconto), gbp.post_togli (post), gbp.scheda_aggiorna (orari per tutti e 7 i giorni, descrizione, sito, telefono; validate_only=true controlla senza cambiare e non chiede conferma). Non cambia nome, indirizzo o categorie.
Quando si usa. Per leggere la scheda dell'attivita' su Google Ricerca e Maps: dati, orari, recensioni, post, link di prenotazione, visualizzazioni e parole cercate. Titolare e dipendenti, dal livello 4, con l'area Scheda Google accesa. Primo passo dopo il collegamento: gbp.account_elenco, gbp.sedi_elenco, poi gbp.sede_predefinita (titolare, con conferma).
- Livello: compreso dal livello 4.
- Serve un collegamento: il tuo account Scheda Google, che colleghi tu una volta dal pannello, pagina
/mio/google-business (pulsante «Collega con Google»).
Le 13 azioni
documentazione Dice cosa sa fare lo strumento, se l'account è collegato, le azioni fisse e l'elenco degli strumenti gbp.* con sola_lettura e puoi_usarlo. Con action=documentazione_gbp.<nome> dà i parametri di uno strumento.stato Dice se la Scheda Google è collegato, da chi, quando, i permessi concessi, la scadenza, quanti strumenti ci sono e l'ultimo errore. Sola lettura.strumenti-remoti Cerca fra gli strumenti gbp.* disponibili, per nome o descrizione. Sola lettura.aggiorna-strumenti Rilegge l'elenco degli strumenti del fornitore.registro Mostra le modifiche fatte sull'account tramite SoWay: quando, chi, strumento, argomenti, esito. Solo titolare. Sola lettura.collega Non collega nulla: risponde con il link del portale dove il titolare fa il login con Google. La password non passa mai dalla chat.scollega Non scollega nulla: risponde con il link del portale dove il titolare scollega l'account.flussi Elenca i flussi di dati dell'azienda fra SoWay e Scheda Google. Sola lettura.flussi-pronti Mostra i flussi pronti per la Scheda Google (oggi nessuno), i modelli SoWay usabili in entrata e come si scrive una mappa. La Scheda Google non ha flussi in uscita: non si modifica da un flusso.flusso-prova Prova a vuoto un flusso (salvato o descritto nella chiamata): legge e mostra cosa farebbe, senza scrivere né in SoWay né su Google. Solo titolare.flusso-salva Crea o cambia un flusso di dati. Solo titolare, con conferma in due passi (conferma_token dopo il sì). Un flusso acceso lavora da solo.flusso-esegui Esegue subito un giro del flusso. In entrata scrive in SoWay; in uscita scrive su Scheda Google e chiede la conferma in due passi. Solo titolare.flusso-elimina Elimina un flusso. I record già portati restano, ma si perde la memoria di cosa è già passato. Solo titolare, conferma in due passi.
Server Plesk del titolare
Gestisce i server Plesk che il titolare ha collegato dal portale (/mio/plesk): stato, registro, REST API v2, API XML, CLI di Plesk, e gli strumenti che il pannello dichiara (azioni plesk.<nome>, argomenti in `argomenti`). Solo il titolare, con l'area «Server Plesk» accesa.
Quando si usa. Per lavorare su domini, posta, DNS, certificati di un server Plesk dell'azienda. Ogni modifica vuole il codice di conferma (conferma_token, in due passi) (salvo esecuzione diretta accesa) e finisce nel registro. Per un server Linux generico usa invece le connessioni SSH. `server` si omette se ce n'è uno solo.
- Livello: compreso dal livello 4.
Le 14 azioni
documentazione La guida dello strumento, più l'elenco dei server collegati con gli strumenti che ogni pannello dichiara (azione plesk.<nome>, descrizione, sola_lettura).elenca-server Elenca i server Plesk collegati dall'azienda, senza credenziali. Sola lettura.stato-server Controlla un server: versione del pannello e dati di sistema (via API key) e raggiungibilità MCP (ping via OAuth). Sola lettura.aggiorna-strumenti Rilegge dal pannello (estensione MCP di Plesk) l'elenco dei suoi strumenti e aggiorna le azioni plesk.*.strumenti-remoti Cerca fra gli strumenti che il pannello dichiara, per nome o descrizione (massimo 100). Se la cache è vuota prova a rileggerla. Sola lettura.registro Mostra le modifiche fatte sui server dell'azienda: chi, quando, cosa, esito, come è stata confermata. Sola lettura.api-rest Esegue qualunque chiamata alla REST API v2 del pannello. GET parte subito; POST/PUT/PATCH/DELETE SCRIVONO sul server e vogliono il codice di conferma (conferma_token, in due passi) (salvo esecuzione diretta), e vanno nel registro.api-xml Invia un pacchetto all'API XML di Plesk. Le operazioni get* partono subito; tutte le altre SCRIVONO e vogliono il codice di conferma (conferma_token, in due passi), e vanno nel registro.cli Esegue un'utility CLI di Plesk (come `plesk bin <comando>`) via POST /api/v2/cli/<comando>/call. ESEGUE COMANDI sul server: vuole sempre il codice di conferma (conferma_token, in due passi) (salvo esecuzione diretta) e va nel registro. Non è una shell.cli-elenco Elenca i comandi CLI disponibili sul pannello (GET /api/v2/cli/commands). Sola lettura.cli-guida L'aiuto di un comando CLI: legge /api/v2/cli/<comando>/ref, e se non esiste chiama il comando con --help (non cambia niente, parte senza conferma).esplora-api La mappa della REST API del pannello, letta dalla sua specifica OpenAPI (openapi.json o .yml). Sola lettura.collega-server Non collega nulla: risponde col link al portale (/mio/plesk), dove il titolare collega il server, così le credenziali non passano dalla conversazione e l'OAuth si apre nel browser.scollega-server Non scollega nulla: risponde col link al portale (/mio/plesk), dove il titolare toglie il server.
SSH Connection
Esegue comandi su un server remoto via SSH e gestisce le connessioni salvate per etichetta, cosi' host, utente e password non ripassano dalla conversazione. Le uscite lunghe si leggono a pezzi (transient).
Quando si usa. Per lavorare su un server Linux. Eseguire comandi e leggere i pezzi e' riservato agli amministratori di sistema; salvare, elencare e cancellare le PROPRIE connessioni e' permesso anche agli altri via MCP. Per i server Plesk esiste anche il connettore del pannello.
- Livello: compreso dal livello 4.
Le 7 azioni
list-connections Elenca le connessioni SSH salvate da chi e' collegato, senza mai mostrare password o chiavi. Solo lettura.save-connection Crea o aggiorna una connessione SSH personale sotto un'etichetta. Se l'etichetta esiste, aggiorna solo i campi passati. Salva credenziali nel database.delete-connection Cancella una connessione SSH salvata, con le sue credenziali. Non si recupera.ssh-connection Esegue un comando sul server remoto (timeout 120 secondi) e restituisce l'uscita. Puo' modificare o cancellare qualunque cosa sul server. Vengono rifiutati i comandi che saltano su altri server (ssh, scp, nc...) o aprono shell remote, e gli host vietati (loopback, macchina ponte). Solo amministratori di sistema.get_ssh_connection_response_list_in_chunk Elenca le chiavi delle uscite SSH lunghe salvate, 20 per pagina. Solo lettura. Solo amministratori di sistema.get_ssh_connection_single_response_in_chunk Legge un pezzo di un'uscita SSH lunga. Solo lettura. Solo amministratori di sistema.delete_ssh_connection_transients Cancella tutte le uscite SSH lunghe salvate (tutte, non solo le tue). Non si recuperano. Solo amministratori di sistema.
Step dei servizi
Lavora sugli step (pulsanti) delle attivita' nate dai servizi venduti: leggerli, compilarli, eseguirli, approvarli, mandarli a un dispositivo con Claude. Il titolare ci costruisce anche le ricette dei servizi (domande, attivita', step, parametri) e le importa o esporta.
Quando si usa. Usala per i task che hanno step di un servizio (campo servizio). Per i task normali di progetto usa «Progetti & Task (team)». Agisce con i permessi di chi e' collegato: titolare, o dipendente assegnato al task; l'AI solo sugli step aperti all'AI (puo_ai).
- Livello: compreso dal livello 4.
Le 35 azioni
documentazione Restituisce la guida dello strumento, l'elenco dei mattoni interni e due testi: come funziona il lavoro sugli step e come si costruisce una ricetta. Con action «documentazione_<mattone>» (es. documentazione_approvazione) da' la scheda di un mattone.mattoni Elenca i mattoni interni di SoWay (strumento «soway» negli step) con parametri, uscite ({{...}} da usare negli step dopo) e se il loro step si puo' forzare. Esempi: analizza_zip_wordpress, leggi_chiave_ssh, link_file_temporaneo, scadi_link, prepara_wp_config, verifica_sito, valida_wordpress_org, consegna_accesso, verifica_scelta, attendi_ritorno, approvazione, report_al_cliente.elenca-task Elenca le attivita' con step dell'azienda collegata: il titolare le vede tutte, il dipendente solo quelle a cui e' assegnato. Massimo 100.stato-task Mostra ogni step di un'attivita': numero, nome, stato (da_fare, fatto, errore, saltato, in_attesa), se e' abilitato o forzabile, se l'AI puo' eseguirlo, istruzioni, campi da compilare (origine form_task o ai, i segreti senza valore), cosa manca e l'ultimo esito.compila-campo Scrive il valore di un campo di uno step (origine form_task o ai). Il valore viene controllato secondo il tipo del campo. Scrive nel task.esegui-step Esegue uno step con i permessi di chi e' collegato. Lo step chiama uno strumento o un mattone: puo' scrivere, pubblicare o eseguire comandi, secondo lo step. Registra l'esito e passa al successivo.salta-step Salta uno step facoltativo: resta registrato come saltato e l'attivita' va avanti. Gli step obbligatori non si saltano.avvia-servizio Avvia a mano un servizio dell'azienda (partenza manuale): crea le attivita' con i loro step, per un cliente se indicato. Solo il titolare. Crea record.elenca-servizi Elenca i servizi dell'azienda (fino a 200) con le domande al cliente e le partenze (manuale, ricorrente con cadenza, evento). Solo il titolare.approva Decide uno step fermo in attesa di approvazione: lo approva o lo rifiuta. Spetta a chi indica l'attesa (titolare, o dipendente assegnato) e lo step deve essere aperto all'AI.stato-attese Elenca gli step fermi in attesa (di un ritorno o di un'approvazione) nelle attivita' che puoi vedere, fino a 200.chiedi-ai Fa proporre all'AI i valori dei campi con origine «ai» di uno step. I valori restano modificabili (segnati come proposti dall'AI). Scrive nel task.elenca-device Elenca i dispositivi dell'azienda del task su cui gira Claude, dicendo se possono agire e perche' no, e propone un prompt gia' compilato per il task (o per lo step indicato).manda-a-device Manda un prompt a un dispositivo con Claude, in una sessione dedicata al task. La risposta torna nel task come nota interna col conto dei token; non addebita niente. Il dispositivo puo' agire sul suo computer.ritira-da-device Ritira il risultato di una richiesta a un dispositivo rimasta in attesa e lo scrive nel task come nota interna. Se la richiesta e' gia' chiusa restituisce lo stato e la risposta salvata.crea-servizio Crea un servizio nuovo (prodotto di tipo servizio, vendibile) nell'azienda. Solo il titolare. Crea un record.aggiorna-servizio Cambia i dati di un servizio dell'azienda. Cambia solo i campi che passi. Solo il titolare.aggiungi-domanda Aggiunge una domanda che il cliente vede al checkout. La risposta diventa {{richiesta.<nome>}} negli step. Solo il titolare.aggiorna-domanda Cambia una domanda al cliente di un servizio. Cambia solo i campi che passi. Solo il titolare.togli-domanda Cancella una domanda al cliente dal servizio. Chiede conferma: senza confermo=true risponde «vuole confermo=true». Gli step che leggevano {{richiesta.<nome>}} restano senza valore.aggiungi-attivita Aggiunge un'attivita' al servizio: e' il task che nascera' quando il servizio parte. Solo il titolare.aggiorna-attivita Cambia titolo, ordine obbligato degli step o assegnatario di un'attivita' del servizio. Solo i campi che passi. Solo il titolare.aggiungi-step Aggiunge uno step a un'attivita': chiama uno strumento MCP dell'azienda o «soway» (mattoni). I parametri dell'azione nascono da soli come form_task. Se rompe la ricetta non salva. Solo il titolare.aggiorna-step Cambia uno step: solo i campi che passi, con gli stessi valori di aggiungi-step. Se usa un segnaposto che a quel punto non esiste, non salva. Solo il titolare.togli-step Cancella uno step e i suoi parametri dalla ricetta. Chiede conferma: serve confermo=true. I task aperti perdono quel pulsante; le esecuzioni fatte restano.sposta-step Sposta uno step di una posizione su o giu' dentro la sua attivita' e rinumera gli altri. Solo il titolare.aggiungi-parametro Aggiunge un argomento a uno step. Se rompe la ricetta (segnaposto inesistente) non salva. Solo il titolare.aggiorna-parametro Cambia un parametro di uno step. Solo i campi che passi. Se rompe la ricetta non salva. Solo il titolare.togli-parametro Cancella un parametro da uno step. Chiede conferma: serve confermo=true. Se era obbligatorio, lo step smette di funzionare finche' non lo rimetti.valida-servizio Dice se il servizio si puo' vendere (nessun problema di livello errore) e cosa manca; restituisce anche la scheda completa del servizio con attivita', step, parametri e domande con i loro id. Solo il titolare.esporta-ricetta Esporta la ricetta del servizio in JSON (formato soway-servizio), senza nessun dato del tenant. Solo il titolare.importa-ricetta Crea un servizio nuovo nell'azienda da una ricetta JSON o da una ricetta inclusa nel modulo. Solo il titolare. Crea record.elenca-ricette-incluse Elenca le ricette pronte che il modulo porta con se' (anche quelle con partenze e attese). Solo il titolare.ricette-da-aggiornare Elenca i servizi importati da una ricetta inclusa che sono indietro rispetto alla versione pubblicata, con i cambi che l'allineamento farebbe. Solo il titolare; con tutte=true solo un master vede tutte le aziende.allinea-ricetta Riscrive un servizio sulla ricetta pubblicata, confrontando per nome: aggiorna, crea e toglie passi, parametri e domande. I passi usati da task aperti vengono spenti, non cancellati. Chiede conferma: serve confermo=true. Rilanciarlo non cambia niente.
TikTok (MCP ufficiale inserzioni)
L'account TikTok for Business dell'azienda (collegato da /mio/tiktok) tramite il server MCP ufficiale di TikTok: campagne, report, pubblico e creatività delle inserzioni. Ogni strumento di TikTok è un'azione `tiktok.<nome>` con i dati in `argomenti`.
Quando si usa. Per le INSERZIONI TikTok, non per i video organici («TikTok (video organici)»). Solo titolare e dipendenti con l'area TikTok accesa; i dipendenti solo in lettura.
- Livello: compreso dal livello 4.
- Serve un collegamento: il tuo account TikTok, che colleghi tu una volta dal pannello, pagina
/mio/tiktok (pulsante «Collega con TikTok for Business»).
Le 13 azioni
documentazione Dice cosa fa lo strumento, se l'account è collegato, il link per collegarlo, le azioni fisse, e l'elenco degli strumenti dichiarati da TikTok con sola_lettura e puoi_usarlo per il tuo ruolo.stato Dice se l'account TikTok è collegato, da chi e quando, la scadenza, i permessi concessi, quanti strumenti ha il fornitore e l'ultimo errore.strumenti-remoti Elenca gli strumenti che TikTok dichiara (compresi i report pronti di SoWay), filtrando per un testo nel nome o nella descrizione.aggiorna-strumenti Rilegge dal server di TikTok l'elenco dei suoi strumenti e lo salva.registro Mostra le modifiche fatte su TikTok da SoWay: quando, chi, quale strumento, con quali argomenti e l'esito.collega Non collega nulla: risponde con il link al portale (/mio/tiktok) dove il titolare fa il login TikTok nel browser. La password non passa mai dalla conversazione.scollega Non scollega nulla: risponde con il link al portale dove il titolare scollega l'account.flussi Elenca i flussi di dati dell'azienda con TikTok (ricette che portano dati da TikTok a SoWay o viceversa), con stato, strumento, mappa, ultimo giro ed esito.flussi-pronti Mostra i flussi già pronti per questo fornitore, i modelli SoWay dove un flusso in entrata può scrivere (crm.lead, res.partner, dati grezzi) e da cui uno in uscita può leggere, e la sintassi della mappa ("email", "a.b", "x|y", "=fisso", "@json", segnaposto {oggi} {ieri} {dal} {al}).flusso-prova Prova a vuoto un flusso (salvato o descritto nella chiamata): legge e mostra cosa farebbe, senza scrivere né in SoWay né su TikTok. Solo il titolare.flusso-salva Crea un flusso nuovo o cambia quello indicato da flusso_id. Solo il titolare, con conferma in due passi: la prima chiamata torna riepilogo e conferma_token, la seconda (stessi argomenti + conferma_token) salva. Un flusso con intervallo_minuti lavora da solo.flusso-esegui Esegue subito un giro del flusso. Se è in uscita (scrive su TikTok e può spendere) chiede conferma in due passi con conferma_token; in entrata esegue subito. Solo il titolare.flusso-elimina Elimina un flusso. I record già portati restano, ma si perde la memoria di cosa è già passato. Solo il titolare, con conferma in due passi (conferma_token).
TikTok (video organici)
Il profilo TikTok dell'azienda, collegato dal portale (/mio/tiktok-video), con la Content Posting API ufficiale: info del profilo, pubblicazione di video organici, bozze nella casella TikTok, stato della pubblicazione. Gli strumenti sono azioni `ttv.<nome>` con i dati in `argomenti`.
Quando si usa. Per i VIDEO ORGANICI su TikTok. Per le inserzioni usa «TikTok (MCP ufficiale inserzioni)». Solo titolare e dipendenti, con l'area accesa; pubblicare e mandare bozze solo il titolare.
- Livello: compreso dal livello 4.
- Serve un collegamento: il tuo account TikTok, che colleghi tu una volta dal pannello, pagina
/mio/tiktok-video (pulsante «Collega il profilo TikTok»).
Le 17 azioni
documentazione Dice cosa fa lo strumento, se il profilo è collegato, il link per collegarlo, le azioni fisse e i 4 strumenti ttv.* con sola_lettura e puoi_usarlo per il tuo ruolo.stato Dice se il profilo TikTok è collegato, da chi e quando, la scadenza, i permessi concessi, quanti strumenti e l'ultimo errore.strumenti-remoti Elenca gli strumenti ttv.* disponibili, filtrabili per testo.aggiorna-strumenti Rilegge e salva l'elenco degli strumenti ttv.* (per TikTok video è un elenco fisso di SoWay).registro Mostra pubblicazioni e bozze mandate da SoWay: quando, chi, strumento, argomenti, esito. Solo il titolare.collega Non collega nulla: risponde col link al portale (/mio/tiktok-video) dove il titolare fa il login TikTok nel browser. La password non passa dalla conversazione.scollega Non scollega nulla: risponde col link al portale dove il titolare scollega il profilo.flussi Elenca i flussi di dati dell'azienda con TikTok video (ricette che portano dati fra SoWay e TikTok).flussi-pronti Mostra i flussi pronti (per TikTok video l'elenco è vuoto), i modelli SoWay dove un flusso in entrata può scrivere e da cui uno in uscita può leggere, e la sintassi della mappa.flusso-prova Prova a vuoto un flusso (salvato o descritto nella chiamata): mostra cosa farebbe senza scrivere né in SoWay né su TikTok. Solo il titolare.flusso-salva Crea o cambia un flusso. Solo il titolare, in due passi: la prima chiamata torna riepilogo e conferma_token, la seconda (stessi argomenti + conferma_token, dopo il sì della persona) salva. Con intervallo_minuti lavora da solo.flusso-esegui Esegue subito un giro del flusso. In uscita (scrive su TikTok) chiede conferma in due passi con conferma_token; in entrata esegue subito. Solo il titolare.flusso-elimina Elimina un flusso; i record già portati restano. Solo il titolare, in due passi con conferma_token.ttv.info_creator Legge il profilo TikTok collegato: nome, avatar, visibilità permesse (privacy_level_options), se commenti/duetti/stitch sono consentiti, durata massima dei video. Sola lettura.ttv.pubblica_video PUBBLICA un video sul profilo. Solo il titolare, in due passi: la prima chiamata dà riepilogo e conferma_token, la seconda (stessi argomenti + conferma_token) pubblica. Senza approvazione dell'app da TikTok, solo SELF_ONLY.ttv.invia_bozza Manda il video come BOZZA nella casella TikTok: la persona lo apre nell'app, sceglie musica e visibilità e pubblica. Funziona anche prima dell'approvazione dell'app. Solo il titolare, in due passi con conferma_token.ttv.stato_pubblicazione Legge lo stato di una pubblicazione o bozza: PROCESSING_UPLOAD, PROCESSING_DOWNLOAD, SEND_TO_USER_INBOX, PUBLISH_COMPLETE o FAILED col motivo. Sola lettura.