Zum Inhalt springen
Kaiross

ERP

bexio

Kontakte, Rechnungen, Offerten, Aufträge und Artikel aus dem bexio ERP.

  • Zugang mit Verbinden (OAuth)
  • Aktionen mit Bestätigung

Tools für den Agenten

Der Agent wählt selbst das passende Tool für die Frage. Im Tab MCP und Datenbanken des Agenten können Sie nicht benötigte Tools deaktivieren.

ToolFunktionTyp
search_contacts Kontakte (Kunden, Lieferanten) nach Name, E-Mail oder Ort suchen. Lesen
list_invoices Rechnungen (neueste zuerst), nach Status filterbar; gibt eine Tabelle zurück. Lesen
get_invoice Details einer Rechnung mit Positionen. Lesen
list_documents Offerten oder Aufträge (neueste zuerst) als Tabelle. Lesen
list_articles Artikel und Dienstleistungen mit Preis und Bestand. Lesen
create_contact Einen Kontakt erstellen (Firma oder Person). Erfordert Bestätigung. Mit Bestätigung

Aktionen, die Daten ändern, sind standardmässig deaktiviert. Sie werden in der Verbindung mit der Option Erstellen von Kontakten erlauben (mit Bestätigung) aktiviert; danach zeigt jede Aktion im Chat eine Zusammenfassung und wird erst mit Bestätigen und ausführen ausgeführt.

Einrichtung Schritt für Schritt

Öffnen Sie in Kaiross Integrationen, wählen Sie bexio und klicken Sie auf Neue Verbindung. Das Formular zeigt denselben Leitfaden unter Leitfaden und empfohlene Berechtigungen.

  1. Einfacher Weg: Erstellen Sie in bexio ein Personal Access Token (Benutzer mit nur den nötigen Rechten) und fügen Sie es hier ein.
  2. Alternativ registrieren Sie auf developer.bexio.com eine App mit dem unten angezeigten Redirect URI und den Lese-Scopes; dann Verbinden.
  3. Rechnungen, Offerten und Aufträge werden zu Tabellen: Sie können nach Diagrammen und Export fragen.

Felder des Formulars: Client ID (für Verbinden).

Einzufügen (im Vault verschlüsselt, danach nicht mehr sichtbar): Personal Access Token (Alternative zu Verbinden), Client secret (für Verbinden).

Zugang mit «Verbinden» (OAuth)

  1. Kopieren Sie im Formular der Verbindung den Wert Rücksprungadresse (Redirect URI), die in der OAuth-App registriert werden muss (Symbol Rücksprungadresse kopieren).
  2. Registrieren Sie die OAuth-App beim Anbieter (Schritte oben) und fügen Sie diese Redirect URI ein.
  3. Geben Sie in Kaiross Client ID und Client secret ein und klicken Sie auf Speichern und verbinden: Das Fenster des Anbieters öffnet sich, melden Sie sich mit dem gewünschten Konto an und erteilen Sie die Berechtigung.
  4. Meldet der Test später «Zugang abgelaufen», klicken Sie in der Verbindung auf Neu verbinden.

Statt des Ablaufs «Verbinden» können Sie auch ein Token in das dafür vorgesehene Feld einfügen (siehe Schritte oben).

Erforderliche Berechtigungen (Scopes)

Kaiross verlangt beim Anbieter nur diese Berechtigungen; Schreibaktionen bleiben deaktiviert, bis Sie sie einschalten.

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

Mit einem Agenten verbinden

  1. Öffnen Sie Agenten, wählen Sie den Agenten und gehen Sie zum Tab MCP und Datenbanken.
  2. Wählen Sie unter Hinzufügen die Option Bestehende Integration verbinden und die Verbindung, oder Aus dem Katalog für eine neue (die Schaltfläche heisst dann Speichern und verknüpfen).
  3. Prüfen Sie unter Aktivierte Tools die aktiven Tools und unter Aktionsbestätigung, welche Aktionen eine Bestätigung verlangen.
  4. Klicken Sie auf Im Chat testen und stellen Sie eine Frage, die Daten aus dem Dienst braucht.

Häufige Fehler

Ungültige Zugangsdaten
Prüfen Sie Token, Passwort oder API-Schlüssel: Oft fehlt ein Zeichen oder das Token ist abgelaufen. Erstellen Sie ein neues und aktualisieren Sie die Verbindung.
Konto nicht verbunden oder Zugang abgelaufen
Die OAuth-Verbindung wurde nie abgeschlossen oder ist nicht mehr gültig: Klicken Sie in der Verbindung auf Verbinden oder Neu verbinden.
Unzureichende Berechtigungen
Dem Konto fehlen Scopes: Vergleichen Sie sie mit der Liste oben.
Zu viele Anfragen
Der Dienst begrenzt die Anzahl der Aufrufe: Versuchen Sie es in ein paar Minuten erneut.

Weitere Integrationen der Kategorie ERP

Alle Integrationen