Documentación

Créditos y medición

Comprende el sistema de créditos, sigue el consumo y configura las alertas de presupuesto.

betool cobra por uso en créditos: 1 crédito = 0,0001 € (una diezmilésima de euro). Recargas tu saldo por adelantado; cada ejecución descuenta el coste correspondiente.

Por qué créditos

El sistema de créditos permite:

  • Granularidad fina — una llamada de API de $0.000003 es medible sin redondeo.
  • Estabilidad de precios — tus precios unitarios en créditos no cambian cuando un proveedor revisa sus tarifas.
  • Separación por organización — cada organización tiene su propio saldo y sus propias alertas.

¿Qué se factura?

Consulta los detalles en Precios. Resumen:

  • LLM — con un modelo gestionado, por tokens de entrada / salida. En BYOK, nada: pagas directamente a tu proveedor y betool no cobra nada sobre los tokens.
  • Voz — ASR por segundo, TTS por carácter.
  • Telefonía — sin precio por minuto en sí: una llamada se factura por sus componentes (transcripción, síntesis de voz, LLM).
  • Operadores HTTP / BD / transform — no medidos.

Recargar tu saldo

Dos modos:

  • Manual — desde Ajustes de la organización → Plan (botón Recargar), añade un importe puntual.
  • Recarga automática — recarga automática cuando el saldo cae por debajo de un umbral. Recomendado para evitar interrupciones.

Seguir el consumo

Ajustes de la organización → Consumo:

  • Saldo actual
  • Historial de consumo filtrable por periodo
  • Desglose por nodo de pipeline y por tipo de recurso

La tabla es exportable como Excel para integrarla en tu seguimiento interno.

Alertas

Dos alertas automáticas protegen tu saldo:

  • Saldo bajo — cuando el saldo cae por debajo de un umbral, se notifica a los administradores de la organización (en la aplicación + email).
  • Saldo agotado — cuando el saldo llega a cero, se envía de inmediato una alerta distinta.

Combínalas con la recarga automática (umbral + importe, configurables por organización) para no llegar nunca a la interrupción.

Rechazo previo a la llamada

Si tu saldo es insuficiente para ejecutar una llamada LLM o una llamada telefónica, betool rechaza la ejecución antes de cualquier débito, con un error explícito out of credits visible en el historial.

Ningún sobrecargo es posible: una llamada nunca comienza sin crédito disponible.

Almacenamiento de archivos

Tu plan puede fijar un almacenamiento autorizado: el volumen de archivos que tu organización conserva en betool — archivos de la base de conocimiento, adjuntos recibidos, archivos producidos por tus procesos. Un plan sin límite muestra Almacenamiento ilimitado.

El uso se sigue en Ajustes de la organización → Plan, sección Almacenamiento: volumen utilizado, parte del plan consumida, y un indicador que señala el paso del 80 % y luego el almacenamiento lleno.

El límite se controla en cada escritura de archivo, antes del envío al almacenamiento:

  • Escrituras decididas por tu organización — importación en la base de conocimiento, archivos producidos por un nodo (descarga, extracción de archivo comprimido, división de PDF, exportación Excel…): por encima del límite, la escritura se rechaza y no se escribe nada. El nodo afectado pasa por su ruta de error; un nodo que produce varios archivos retira los que ya había escrito.
  • Archivos enviados por tus contactos — adjuntos de emails, medios de mensajería, archivos recibidos por webhook: siempre aceptados, incluso por encima del límite (nunca se pierde el mensaje de un cliente), y contabilizados en tu uso.

Para recuperar margen: elimina archivos (eliminar un documento de la base de conocimiento elimina su archivo) o pasa a un plan superior.

Para desarrolladores

Si llamas a la API de administración, el endpoint GET /api/admin/billing/state devuelve tu plan, tu saldo y el estado de la recarga automática; GET /api/admin/billing/storage-usage devuelve tu uso de almacenamiento y su límite. Una escritura de archivo rechazada por almacenamiento lleno responde 507 Insufficient Storage.