Vai al contenuto
Kaiross

Gestionali

bexio

Contatti, fatture, offerte, ordini e articoli del gestionale bexio.

  • Accesso con Connetti (OAuth)
  • Azioni con conferma

Strumenti per l’agente

L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.

StrumentoCosa faTipo
search_contacts Cerca contatti (clienti, fornitori) per nome, email o città. Lettura
list_invoices Fatture (le più recenti prima), filtrabili per stato; restituisce una tabella. Lettura
get_invoice Dettaglio di una fattura con le posizioni. Lettura
list_documents Offerte o ordini (i più recenti prima) come tabella. Lettura
list_articles Articoli e servizi con prezzo e giacenza. Lettura
create_contact Crea un contatto (azienda o persona). Richiede conferma. Con conferma

Le azioni che modificano dati sono spente di default. Si attivano nella connessione con l’opzione Consenti la creazione di contatti (con conferma); poi ogni azione mostra in chat un riepilogo e parte solo con Conferma ed esegui.

Configurazione passo per passo

In Kaiross apri Integrazioni, scegli bexio e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.

  1. Via semplice: in bexio crea un Personal Access Token (utente con i soli diritti necessari) e incollalo.
  2. In alternativa registra un’app su developer.bexio.com con il Redirect URI mostrato qui sotto e gli scope di lettura; poi Connetti.
  3. Fatture, offerte e ordini diventano tabelle: puoi chiedere grafici ed export.

Campi del modulo: Client ID (per Connetti).

Da incollare (cifrato nel Vault, poi non più visibile): Personal Access Token (alternativa a Connetti), Client secret (per Connetti).

Accesso con «Connetti» (OAuth)

  1. Nel modulo della connessione copia il valore Indirizzo di ritorno (Redirect URI) da registrare nell’app OAuth (icona Copia indirizzo di ritorno).
  2. Registra l’app OAuth presso il fornitore (passi qui sopra) incollando quel Redirect URI.
  3. Inserisci in Kaiross Client ID e Client secret e premi Salva e connetti: si apre la finestra del fornitore, accedi con l’account da usare e autorizza.
  4. Se in seguito il test segnala «Accesso scaduto», premi Ricollega nella connessione.

In alternativa al flusso «Connetti» puoi incollare un token nel campo dedicato (vedi i passi qui sopra).

Permessi (scope) richiesti

Kaiross chiede solo questi permessi al fornitore; le azioni di scrittura restano comunque spente finché non le attivi.

  • contact_show
  • kb_invoice_show
  • kb_offer_show
  • kb_order_show
  • article_show
  • contact_edit

Collegarla a un agente

  1. Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
  2. In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
  3. Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
  4. Premi Prova in chat e fai una domanda che richiede i dati del servizio.

Errori frequenti

Credenziali non valide
Controlla token, password o chiave API: spesso manca un carattere o il token è scaduto. Creane uno nuovo e aggiorna la connessione.
Account non collegato o accesso scaduto
Il collegamento OAuth non è mai stato completato o non è più valido: premi Connetti o Ricollega nella connessione.
Permessi insufficienti
All’account mancano gli scope necessari: confrontali con l’elenco qui sopra.
Troppe richieste
Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.

Altre integrazioni della categoria Gestionali

Tutte le integrazioni