Documentation

Crédits & metering

Comprendre le système de crédits, suivre la consommation, configurer les alertes budget.

betool facture à l'usage en crédits : 1 crédit = 0,0001 € (un dix-millième d'euro). Vous rechargez votre solde à l'avance ; chaque exécution débite le coût correspondant.

Pourquoi des crédits

Le système de crédits permet :

  • Une granularité fine — un appel API à $0.000003 est métrable sans arrondi.
  • Une stabilité de prix — vos prix unitaires en crédits ne changent pas quand un provider revoit son tarif.
  • Un découpage par organisation — chaque org a son propre solde, ses propres alertes.

Que paye-t-on ?

Voir le détail dans Tarifs. Résumé :

  • LLM — sur un modèle managé, par tokens entrée / sortie. En BYOK, rien : vous payez votre provider directement, betool ne prend rien sur les tokens.
  • Voix — ASR par seconde, TTS par caractère.
  • Téléphonie — pas de prix à la minute en soi : un appel est facturé par ses composantes (transcription, synthèse vocale, LLM).
  • Opérateurs HTTP / DB / transform — non métrés.

Recharger son solde

Deux modes :

  • Manuel — depuis Paramètres de l'organisation → Plan (bouton Recharger), ajouter un montant ponctuellement.
  • Auto-recharge — recharge automatique quand le solde passe sous un seuil. Conseillé pour éviter les coupures.

Suivre la consommation

Paramètres de l'organisation → Consommation :

  • Solde courant
  • Historique de consommation filtrable par période
  • Répartition par nœud de pipeline et par type de ressource

Le tableau est exportable en Excel pour intégration à votre suivi interne.

Alertes

Deux alertes automatiques protègent votre solde :

  • Solde bas — quand le solde passe sous un seuil, les administrateurs de l'org sont notifiés (in-app + email).
  • Solde épuisé — quand le solde tombe à zéro, une alerte distincte part immédiatement.

Combinez-les à l'auto-recharge (seuil + montant, configurables par organisation) pour ne jamais atteindre la coupure.

Refus pre-call

Si votre solde est insuffisant pour exécuter un LLM call ou un appel téléphonique, betool refuse l'exécution avant tout débit, avec une erreur explicite out of credits visible dans l'historique.

Aucune surfacturation possible : un appel ne démarre jamais sans crédit disponible.

Stockage de fichiers

Votre plan peut fixer un stockage autorisé : le volume de fichiers que votre organisation conserve dans betool — fichiers de la base de connaissances, pièces jointes reçues, fichiers produits par vos processus. Un plan sans limite affiche Stockage illimité.

L'usage se suit dans Paramètres de l'organisation → Plan, section Stockage : volume utilisé, part du plan consommée, et une jauge qui signale le passage de 80 % puis le stockage plein.

La limite est contrôlée à chaque écriture de fichier, avant l'envoi au stockage :

  • Écritures décidées par votre organisation — import dans la base de connaissances, fichiers produits par un nœud (téléchargement, extraction d'archive, découpe de PDF, export Excel…) : au-delà de la limite, l'écriture est refusée et rien n'est écrit. Le nœud concerné passe par son chemin d'erreur ; un nœud qui produit plusieurs fichiers retire ceux qu'il avait déjà écrits.
  • Fichiers envoyés par vos contacts — pièces jointes d'emails, médias de messageries, fichiers reçus par webhook : toujours acceptés, même au-delà de la limite (on ne perd jamais le message d'un client), et comptés dans votre usage.

Pour retrouver de la marge : supprimez des fichiers (supprimer un document de la base de connaissances supprime son fichier) ou passez à un plan supérieur.

Pour les développeurs

Si vous appelez l'API admin, l'endpoint GET /api/admin/billing/state renvoie votre plan, votre solde et l'état de l'auto-recharge ; GET /api/admin/billing/storage-usage renvoie votre usage de stockage et sa limite. Une écriture de fichier refusée pour stockage plein répond 507 Insufficient Storage.