archi bot Documentation produit

Cette traduction est générée automatiquement (bêta). Le guide en anglais fait foi.

Facturation

Facturation et crédits ArchibotChat

Consultez les forfaits, le pool de crédits partagé entre le chat et l'API, les contrôles de budget mensuel, le paiement Stripe et le portail client depuis l'écran de Facturation du chat.

Administrateurs clientMembres clientOpérateurs de la plateforme

Dernière mise à jour

Écran de Facturation ArchibotChat affichant les crédits restants et utilisés, le statut du compte, les contrôles de budget mensuel et la carte du forfait actuel.
Exemple rendu dans la Console avec des données sûres : l'écran de Facturation du chat affiche le pool de crédits partagé, les contrôles de budget mensuel et votre forfait actif.

La facturation détermine si votre compte peut utiliser ArchibotChat et combien de crédits il possède. Les messages du chat et les requêtes de l’API publique puisent dans le même pool de crédits partagé, c’est pourquoi ce seul écran couvre les deux.

Ouvrir l’écran de Facturation

  1. Connectez-vous à la Console et ouvrez Chat depuis la navigation de gauche.
  2. Ouvrez l’écran de Facturation de l’espace de travail du chat. L’en-tête indique Billing avec la note que le chat et l’API partagent le même pool de crédits.
  3. Utilisez Back to chat en haut de l’écran pour revenir à la vue de conversation à tout moment.

Écran de Facturation ArchibotChat avec le pool de crédits, les contrôles de budget mensuel et la carte du forfait.

La carte du haut affiche trois valeurs en direct :

ChampSignification
RestantsCrédits encore disponibles dans le pool partagé du chat et de l’API.
UtilisésCrédits déjà consommés sur cette période.
StatutLe statut de facturation actuel, tel que active, trial ou un état approuvé par un opérateur.

Ce qu’un crédit couvre

Un crédit est l’unité partagée que le chat et l’API publique consomment tous deux.

  • Un message de chat qui demande à Archibot de répondre puise dans le pool.
  • Une requête vers un point de terminaison public effectuée avec une clé API puise dans le même pool.

Comme le pool est partagé, le chat du navigateur et les requêtes API réduisent le même solde Restants. Les éléments suivants ne consomment pas de crédits séparés :

  • Les fragments de réponse en streaming d’une même réponse.
  • Les traces d’outils et les citations jointes à une réponse.
  • La consultation des métadonnées de facturation, de budget ou de clés API.
  • Le téléchargement d’un artefact que vous avez déjà généré.

Pour le comportement des artefacts, voir Artefacts ArchibotChat. Pour le fonctionnement des requêtes API, voir Clés API ArchibotChat.

Contrôles de budget mensuel

Les comptes facturés peuvent fixer un budget mensuel de crédits strict, similaire à une limite de facturation d’API. Le budget est un plafond appliqué par la Console au-dessus de votre forfait, et non un remplacement de celui-ci.

La carte Monthly budget controls affiche :

ChampSignification
Budget utiliséCrédits consommés par rapport au budget sur cette période.
Limite de budgetLe plafond que vous avez défini, ou No cap lorsque le budget est nul.
PériodeLa date à laquelle la période de budget actuelle se réinitialise.

Pour définir ou modifier le budget :

  1. Saisissez un montant de crédits dans le champ de saisie, ou utilisez un bouton prédéfini. Les valeurs prédéfinies sont No cap, 40 credits, 80 credits, 200 credits et 800 credits.
  2. Définissez la valeur sur 0 (le préréglage No cap) si vous ne voulez aucun plafond appliqué par la Console.
  3. Choisissez Save budget.

La barre de progression au-dessus du champ de saisie montre à quel point le budget utilisé est proche de la limite de budget.

Si le champ de budget et Save budget sont désactivés, la carte affiche une note indiquant que les contrôles de budget apparaissent après l’approbation du compte. Les contrôles deviennent disponibles une fois que votre compte est dans un état de facturation éligible.

Forfaits

Chaque carte de forfait indique le nom du forfait et son allocation de crédits partagée, par exemple Team avec 1,000 shared credits. Les forfaits, prix et allocations exacts disponibles pour votre compte proviennent des produits Stripe configurés pour votre environnement.

  • La carte de votre forfait actif affiche Current plan et son bouton n’est pas sélectionnable.
  • Les autres cartes de forfait affichent un bouton que vous pouvez choisir pour lancer le paiement.

Votre compte peut également être dans un état d’essai, approuvé par un opérateur, suspendu ou en échec de paiement, indépendamment du forfait affiché.

Lancer le paiement Stripe

Lorsque le paiement Stripe est configuré pour votre environnement et qu’un forfait a un prix configuré :

  1. Sur l’écran de Facturation, choisissez le bouton de la carte du forfait souhaité.
  2. La Console ouvre Stripe Checkout dans le navigateur.
  3. Effectuez le paiement dans Stripe.

Une fois le paiement réussi, ArchibotChat attend le webhook Stripe signé avant de mettre à jour le statut de facturation et d’accorder le lot de crédits correspondant. Si le navigateur revient de Stripe avant la fin du webhook, actualisez l’écran de Facturation.

Le bouton d’un forfait reste désactivé si le paiement n’est pas prêt pour votre environnement ou si le forfait n’a pas de prix configuré. Si un forfait que vous attendez n’est pas sélectionnable, demandez à votre administrateur client ou au support ISM si le paiement est entièrement configuré pour votre environnement.

Portail client

Une fois qu’un client Stripe existe pour votre compte, choisissez Customer portal en haut à droite de l’écran de Facturation pour ouvrir le portail client hébergé par Stripe.

Utilisez le portail pour gérer les détails de paiement, les factures et les paramètres d’abonnement que Stripe expose pour votre compte. ArchibotChat continue de traiter les webhooks Stripe signés comme la source de vérité après toute modification du portail, de sorte que les mises à jour de forfait et de crédits apparaissent sur l’écran de Facturation une fois le webhook traité.

Le bouton Customer portal est désactivé jusqu’à ce qu’un client Stripe existe pour votre compte.

Lots de crédits et expiration

Les crédits sont suivis par lots. Chaque octroi ou achat crée un lot avec une date d’octroi, une date d’expiration, un produit, un montant initial et un montant restant. Les débits consomment d’abord le lot éligible qui expire le plus tôt, et les lots expirés ne sont pas disponibles pour une utilisation du chat ou de l’API.

Les enregistrements de lots de crédits et les ajustements d’expiration sont gérés du côté de l’opérateur. Si vous avez besoin qu’un lot soit examiné, qu’une expiration soit vérifiée ou qu’un octroi soit appliqué, signalez-le au support ISM plutôt que de vous attendre à modifier les lots depuis l’écran de Facturation du chat. Voir Cas de support ArchibotChat.

Échec de paiement

Si le paiement échoue :

  • Les nouveaux messages du chat ou appels API peuvent être bloqués.
  • L’historique des conversations existant peut rester visible selon la politique.
  • Les clés API peuvent rester répertoriées mais échouer sur les nouvelles requêtes.
  • L’administrateur client ou le responsable de la facturation doit mettre à jour les détails de paiement via le portail client.

ArchibotChat vérifie le statut de facturation avant de prélever des crédits, de sorte que les comptes en état d’échec de paiement, suspendu ou en attente ne devraient pas perdre de crédits pour des requêtes bloquées. Si le paiement a été corrigé mais que l’accès reste bloqué, contactez le support ISM.

Notifications d’utilisation

Si les notifications d’utilisation sont activées dans la configuration et que la distribution d’e-mails est configurée pour votre environnement, ArchibotChat envoie un e-mail à l’utilisateur du compte lorsque le solde de crédits partagé tombe à 20 % ou moins. Une seule notification de solde faible est envoyée par compte pour ce seuil.

Si les notifications de cycle de vie de facturation sont activées, ArchibotChat peut envoyer un e-mail à l’utilisateur de paiement ou de facturation après que les webhooks Stripe signés ont mis à jour le statut du forfait ou accordé des crédits. Les preuves de distribution, de rebond et de suppression d’e-mails sont enregistrées afin que le support puisse distinguer un problème de paramétrage de compte d’un problème de distribution d’e-mails.

Pour activer les notifications, voir Configuration d’ArchibotChat. Pour examiner les événements de distribution et de facturation enregistrés, voir Activité et audit ArchibotChat.

Guides associés

Terminé quand

  • Le forfait actif correspond aux attentes.
  • Des crédits restants sont disponibles dans le pool partagé du chat et de l'API.
  • Le statut de facturation est actif, en essai ou approuvé par un opérateur.