archi bot Produktdokumentation

Diese Übersetzung wurde maschinell erstellt (Beta). Maßgeblich ist die englische Anleitung.

Abrechnung

ArchibotChat Abrechnung und Guthaben

Überprüfen Sie Tarife, den gemeinsamen Guthaben-Pool für Chat und API, die monatlichen Budgetkontrollen, das Stripe-Checkout und das Kundenportal über den Abrechnungsbildschirm des Chats.

KundenadministratorenKundenmitgliederPlattformbetreiber

Zuletzt aktualisiert

ArchibotChat-Abrechnungsbildschirm mit verbleibendem und verbrauchtem Guthaben, Kontostatus, monatlichen Budgetkontrollen und der Karte des aktuellen Tarifs.
In der Console gerendertes Beispiel mit sicheren Daten: Der Abrechnungsbildschirm des Chats zeigt den gemeinsamen Guthaben-Pool, die monatlichen Budgetkontrollen und Ihren aktiven Tarif.

Die Abrechnung steuert, ob Ihr Konto ArchibotChat nutzen kann und über wie viel Guthaben es verfügt. Chatnachrichten und Anfragen der öffentlichen API ziehen aus demselben gemeinsamen Guthaben-Pool, daher deckt dieser eine Bildschirm beides ab.

Den Abrechnungsbildschirm öffnen

  1. Melden Sie sich bei der Console an und öffnen Sie Chat über die linke Navigation.
  2. Öffnen Sie den Abrechnungsbildschirm für den Chat-Arbeitsbereich. Die Kopfzeile lautet Billing mit dem Hinweis, dass Chat und API denselben Guthaben-Pool teilen.
  3. Verwenden Sie Back to chat oben im Bildschirm, um jederzeit zur Konversationsansicht zurückzukehren.

ArchibotChat-Abrechnungsbildschirm mit dem Guthaben-Pool, den monatlichen Budgetkontrollen und der Tarifkarte.

Die obere Karte zeigt drei Live-Werte:

FeldBedeutung
VerbleibendIm gemeinsamen Chat- und API-Pool noch verfügbares Guthaben.
VerbrauchtIn diesem Zeitraum bereits verbrauchtes Guthaben.
StatusDer aktuelle Abrechnungsstatus, etwa active, trial oder ein vom Betreiber genehmigter Zustand.

Was ein Guthaben abdeckt

Ein Guthaben ist die gemeinsame Einheit, die sowohl der Chat als auch die öffentliche API abbuchen.

  • Eine Chatnachricht, die Archibot um eine Antwort bittet, zieht aus dem Pool.
  • Eine mit einem API-Schlüssel ausgeführte Anfrage an einen öffentlichen Endpunkt zieht aus demselben Pool.

Da der Pool gemeinsam genutzt wird, reduzieren Browser-Chat und API-Anfragen denselben Verbleibend-Saldo. Folgendes bucht kein separates Guthaben ab:

  • Streaming-Antwortfragmente für eine einzelne Antwort.
  • An eine Antwort angehängte Tool-Traces und Quellenangaben.
  • Das Anzeigen von Abrechnungs-, Budget- oder API-Schlüssel-Metadaten.
  • Das Herunterladen eines bereits von Ihnen erzeugten Artefakts.

Zum Verhalten von Artefakten siehe ArchibotChat-Artefakte. Zur Funktionsweise von API-Anfragen siehe ArchibotChat-API-Schlüssel.

Monatliche Budgetkontrollen

Abgerechnete Konten können ein striktes monatliches Guthabenbudget festlegen, ähnlich einer API-Abrechnungsgrenze. Das Budget ist eine von der Console durchgesetzte Obergrenze zusätzlich zu Ihrem Tarif, kein Ersatz dafür.

Die Karte Monthly budget controls zeigt:

FeldBedeutung
Budget verbrauchtIn diesem Zeitraum gegen das Budget verbrauchtes Guthaben.
BudgetgrenzeDie von Ihnen festgelegte Obergrenze oder No cap, wenn das Budget null beträgt.
ZeitraumDas Datum, an dem der aktuelle Budgetzeitraum zurückgesetzt wird.

So legen Sie das Budget fest oder ändern es:

  1. Geben Sie einen Guthabenbetrag in das Eingabefeld ein oder verwenden Sie eine voreingestellte Schaltfläche. Die Voreinstellungen sind No cap, 40 credits, 80 credits, 200 credits und 800 credits.
  2. Setzen Sie den Wert auf 0 (die Voreinstellung No cap), wenn Sie keine von der Console durchgesetzte Obergrenze wünschen.
  3. Wählen Sie Save budget.

Der Fortschrittsbalken über dem Eingabefeld zeigt, wie nah das verbrauchte Budget an der Budgetgrenze liegt.

Wenn das Budget-Eingabefeld und Save budget deaktiviert sind, zeigt die Karte einen Hinweis, dass die Budgetkontrollen nach der Genehmigung des Kontos erscheinen. Die Kontrollen werden verfügbar, sobald sich Ihr Konto in einem berechtigten Abrechnungsstatus befindet.

Tarife

Jede Tarifkarte führt den Tarifnamen und sein gemeinsames Guthabenkontingent auf, zum Beispiel Team mit 1,000 shared credits. Die genauen Tarife, Preise und Kontingente, die für Ihr Konto verfügbar sind, stammen aus den konfigurierten Stripe-Produkten für Ihre Umgebung.

  • Die Karte Ihres aktiven Tarifs zeigt Current plan und ihre Schaltfläche ist nicht auswählbar.
  • Andere Tarifkarten zeigen eine Schaltfläche, die Sie wählen können, um das Checkout zu starten.

Ihr Konto kann sich unabhängig vom angezeigten Tarif auch in einem Testzeitraum, einem vom Betreiber genehmigten, gesperrten oder zahlungsgescheiterten Zustand befinden.

Stripe-Checkout starten

Wenn das Stripe-Checkout für Ihre Umgebung konfiguriert ist und ein Tarif einen konfigurierten Preis hat:

  1. Wählen Sie auf dem Abrechnungsbildschirm die Schaltfläche auf der gewünschten Tarifkarte.
  2. Die Console öffnet Stripe Checkout im Browser.
  3. Schließen Sie die Zahlung in Stripe ab.

Nach erfolgreichem Checkout wartet ArchibotChat auf das signierte Stripe-Webhook, bevor es den Abrechnungsstatus aktualisiert und das passende Guthaben-Los gewährt. Wenn der Browser von Stripe zurückkehrt, bevor das Webhook abgeschlossen ist, aktualisieren Sie den Abrechnungsbildschirm.

Eine Tarif-Schaltfläche bleibt deaktiviert, wenn das Checkout für Ihre Umgebung nicht bereit ist oder der Tarif keinen konfigurierten Preis hat. Wenn ein von Ihnen erwarteter Tarif nicht auswählbar ist, fragen Sie Ihren Kundenadministrator oder den ISM-Support, ob das Checkout für Ihre Umgebung vollständig eingerichtet ist.

Kundenportal

Sobald ein Stripe-Kunde für Ihr Konto existiert, wählen Sie Customer portal oben rechts im Abrechnungsbildschirm, um das von Stripe gehostete Kundenportal zu öffnen.

Verwenden Sie das Portal, um Zahlungsdetails, Rechnungen und Abonnementeinstellungen zu verwalten, die Stripe für Ihr Konto bereitstellt. ArchibotChat behandelt signierte Stripe-Webhooks auch nach jeder Portaländerung weiterhin als Quelle der Wahrheit, sodass Tarif- und Guthabenaktualisierungen auf dem Abrechnungsbildschirm erscheinen, sobald das Webhook verarbeitet wurde.

Die Schaltfläche Customer portal ist deaktiviert, bis ein Stripe-Kunde für Ihr Konto existiert.

Guthaben-Lose und Ablauf

Guthaben wird in Losen erfasst. Jede Gewährung oder jeder Kauf erzeugt ein Los mit einem Gewährungsdatum, einem Ablaufdatum, einem Produkt, einem ursprünglichen Betrag und einem verbleibenden Betrag. Abbuchungen verbrauchen zuerst das am frühesten ablaufende, berechtigte Los, und abgelaufene Lose stehen nicht für die Chat- oder API-Nutzung zur Verfügung.

Guthaben-Los-Datensätze und Ablaufanpassungen werden auf der Betreiberseite verwaltet. Wenn ein Los überprüft, ein Ablauf geprüft oder eine Gewährung angewendet werden muss, wenden Sie sich an den ISM-Support, anstatt zu erwarten, Lose über den Abrechnungsbildschirm des Chats zu bearbeiten. Siehe ArchibotChat-Supportfälle.

Zahlungsfehler

Wenn eine Zahlung fehlschlägt:

  • Neue Chatnachrichten oder API-Aufrufe können blockiert werden.
  • Bestehender Konversationsverlauf bleibt je nach Richtlinie möglicherweise sichtbar.
  • API-Schlüssel bleiben möglicherweise gelistet, scheitern aber bei neuen Anfragen.
  • Der Kundenadministrator oder Abrechnungsverantwortliche sollte die Zahlungsdetails über das Kundenportal aktualisieren.

ArchibotChat prüft den Abrechnungsstatus, bevor es Guthaben abbucht, sodass Konten in einem zahlungsgescheiterten, gesperrten oder ausstehenden Zustand kein Guthaben für blockierte Anfragen verlieren sollten. Wenn die Zahlung korrigiert wurde, der Zugriff aber weiterhin blockiert ist, wenden Sie sich an den ISM-Support.

Nutzungsbenachrichtigungen

Wenn Nutzungsbenachrichtigungen in der Einrichtung aktiviert und die E-Mail-Zustellung für Ihre Umgebung konfiguriert ist, sendet ArchibotChat dem Kontonutzer eine E-Mail, wenn das gemeinsame Guthaben auf 20 % oder weniger fällt. Pro Konto wird für diesen Schwellenwert nur eine Benachrichtigung über niedriges Guthaben gesendet.

Wenn Benachrichtigungen zum Abrechnungslebenszyklus aktiviert sind, kann ArchibotChat dem Checkout- oder Abrechnungsnutzer eine E-Mail senden, nachdem signierte Stripe-Webhooks den Tarifstatus aktualisiert oder Guthaben gewährt haben. Nachweise zu Zustellung, Bounce und Unterdrückung von E-Mails werden aufgezeichnet, damit der Support ein Problem mit den Kontoeinstellungen von einem Problem mit der E-Mail-Zustellung unterscheiden kann.

Um Benachrichtigungen zu aktivieren, siehe ArchibotChat-Einrichtung. Um aufgezeichnete Zustellungs- und Abrechnungsereignisse zu überprüfen, siehe ArchibotChat-Aktivität und -Audit.

Verwandte Anleitungen

Fertig, wenn

  • Der aktive Tarif entspricht den Erwartungen.
  • Verbleibendes Guthaben ist im gemeinsamen Chat- und API-Pool verfügbar.
  • Der Abrechnungsstatus ist aktiv, Testphase oder vom Betreiber genehmigt.