archi bot Documentación del producto

Esta traducción se generó automáticamente (beta). La guía en inglés es la versión autoritativa.

Facturación

Facturación y créditos de ArchibotChat

Revisa los planes, el grupo compartido de créditos de chat y API, los controles de presupuesto mensual, el pago con Stripe y el portal del cliente desde la pantalla de Facturación del chat.

Administradores del clienteMiembros del clienteOperadores de la plataforma

Última actualización

Pantalla de Facturación de ArchibotChat que muestra los créditos restantes y usados, el estado de la cuenta, los controles de presupuesto mensual y la tarjeta del plan actual.
Ejemplo renderizado en la Console con datos seguros: la pantalla de Facturación del chat muestra el grupo compartido de créditos, los controles de presupuesto mensual y tu plan activo.

La facturación controla si tu cuenta puede usar ArchibotChat y cuántos créditos tiene. Los mensajes de chat y las solicitudes a la API pública consumen del mismo grupo compartido de créditos, por lo que esta única pantalla cubre ambos.

Abre la pantalla de Facturación

  1. Inicia sesión en la Console y abre Chat desde la navegación de la izquierda.
  2. Abre la pantalla de Facturación del espacio de trabajo de chat. El encabezado dice Billing con la nota de que el chat y la API comparten el mismo grupo de créditos.
  3. Usa Back to chat en la parte superior de la pantalla para volver a la vista de conversación en cualquier momento.

Pantalla de Facturación de ArchibotChat con el grupo de créditos, los controles de presupuesto mensual y la tarjeta del plan.

La tarjeta superior muestra tres valores en vivo:

CampoSignificado
RestantesCréditos aún disponibles en el grupo compartido de chat y API.
UsadosCréditos ya consumidos en este periodo.
EstadoEl estado de facturación actual, como active, trial o un estado aprobado por un operador.

Qué cubre un crédito

Un crédito es la unidad compartida que tanto el chat como la API pública consumen.

  • Un mensaje de chat que le pide a Archibot que responda consume del grupo.
  • Una solicitud a un endpoint público realizada con una clave de API consume del mismo grupo.

Como el grupo es compartido, el chat del navegador y las solicitudes a la API reducen el mismo saldo Restantes. Lo siguiente no consume créditos por separado:

  • Los fragmentos de respuesta en streaming de una sola contestación.
  • Los rastros de herramientas y las citas adjuntas a una respuesta.
  • Ver los metadatos de facturación, presupuesto o claves de API.
  • Descargar un artefacto que ya generaste.

Para el comportamiento de los artefactos, consulta Artefactos de ArchibotChat. Para la mecánica de las solicitudes a la API, consulta Claves de API de ArchibotChat.

Controles de presupuesto mensual

Las cuentas facturadas pueden establecer un presupuesto mensual de créditos estricto, similar a un límite de facturación de API. El presupuesto es un techo aplicado por la Console por encima de tu plan, no un reemplazo de este.

La tarjeta Monthly budget controls muestra:

CampoSignificado
Presupuesto usadoCréditos consumidos contra el presupuesto en este periodo.
Límite del presupuestoEl tope que has establecido, o No cap cuando el presupuesto es cero.
PeriodoLa fecha en que se reinicia el periodo de presupuesto actual.

Para establecer o cambiar el presupuesto:

  1. Ingresa una cantidad de créditos en el campo de entrada, o usa un botón predefinido. Los valores predefinidos son No cap, 40 credits, 80 credits, 200 credits y 800 credits.
  2. Establece el valor en 0 (el preset No cap) si no quieres ningún tope aplicado por la Console.
  3. Elige Save budget.

La barra de progreso encima del campo de entrada muestra qué tan cerca está el presupuesto usado del límite del presupuesto.

Si el campo de presupuesto y Save budget están deshabilitados, la tarjeta muestra una nota de que los controles de presupuesto aparecen después de que la cuenta sea aprobada. Los controles quedan disponibles una vez que tu cuenta está en un estado de facturación elegible.

Planes

Cada tarjeta de plan indica el nombre del plan y su asignación compartida de créditos, por ejemplo Team con 1,000 shared credits. Los planes, precios y asignaciones exactos disponibles para tu cuenta provienen de los productos de Stripe configurados para tu entorno.

  • La tarjeta de tu plan activo muestra Current plan y su botón no es seleccionable.
  • Las demás tarjetas de plan muestran un botón que puedes elegir para iniciar el pago.

Tu cuenta también puede estar en un estado de prueba, aprobado por un operador, suspendido o con pago fallido, independientemente del plan mostrado.

Iniciar el pago con Stripe

Cuando el pago con Stripe está configurado para tu entorno y un plan tiene un precio configurado:

  1. En la pantalla de Facturación, elige el botón de la tarjeta del plan que quieras.
  2. La Console abre Stripe Checkout en el navegador.
  3. Completa el pago en Stripe.

Después de que el pago tenga éxito, ArchibotChat espera el webhook firmado de Stripe antes de actualizar el estado de facturación y otorgar el lote de créditos correspondiente. Si el navegador regresa de Stripe antes de que termine el webhook, actualiza la pantalla de Facturación.

El botón de un plan permanece deshabilitado si el pago no está listo para tu entorno o el plan no tiene un precio configurado. Si un plan que esperas no es seleccionable, pregunta a tu administrador del cliente o al soporte de ISM si el pago está completamente configurado para tu entorno.

Portal del cliente

Después de que exista un cliente de Stripe para tu cuenta, elige Customer portal en la parte superior derecha de la pantalla de Facturación para abrir el portal del cliente alojado por Stripe.

Usa el portal para administrar los detalles de pago, las facturas y la configuración de suscripción que Stripe expone para tu cuenta. ArchibotChat sigue tratando los webhooks firmados de Stripe como la fuente de verdad después de cualquier cambio en el portal, por lo que las actualizaciones de plan y créditos aparecen en la pantalla de Facturación una vez que se procesa el webhook.

El botón Customer portal está deshabilitado hasta que exista un cliente de Stripe para tu cuenta.

Lotes de créditos y caducidad

Los créditos se rastrean en lotes. Cada otorgamiento o compra crea un lote con una fecha de otorgamiento, una fecha de caducidad, un producto, una cantidad original y una cantidad restante. Los débitos consumen primero el lote elegible que caduca más pronto, y los lotes caducados no están disponibles para uso de chat o API.

Los registros de lotes de créditos y los ajustes de caducidad se administran del lado del operador. Si necesitas que se revise un lote, se verifique una caducidad o se aplique un otorgamiento, plantéalo al soporte de ISM en lugar de esperar editar lotes desde la pantalla de Facturación del chat. Consulta Casos de soporte de ArchibotChat.

Fallo de pago

Si el pago falla:

  • Los nuevos mensajes de chat o llamadas a la API pueden quedar bloqueados.
  • El historial de conversaciones existente puede permanecer visible según la política.
  • Las claves de API pueden seguir apareciendo en la lista pero fallar en nuevas solicitudes.
  • El administrador del cliente o el responsable de facturación debe actualizar los detalles de pago a través del portal del cliente.

ArchibotChat verifica el estado de facturación antes de consumir créditos, por lo que las cuentas en un estado de pago fallido, suspendido o pendiente no deberían perder créditos por solicitudes bloqueadas. Si el pago se ha corregido pero el acceso sigue bloqueado, contacta al soporte de ISM.

Notificaciones de uso

Si las notificaciones de uso están habilitadas en la configuración y la entrega de correo está configurada para tu entorno, ArchibotChat envía un correo al usuario de la cuenta cuando el saldo compartido de créditos cae al 20% o menos. Solo se envía una notificación de saldo bajo por cuenta para ese umbral.

Si las notificaciones del ciclo de vida de facturación están habilitadas, ArchibotChat puede enviar un correo al usuario de pago o de facturación después de que los webhooks firmados de Stripe actualicen el estado del plan u otorguen créditos. La evidencia de entrega, rebote y supresión de correo se registra para que el soporte pueda distinguir un problema de configuración de cuenta de un problema de entrega de correo.

Para activar las notificaciones, consulta Configuración de ArchibotChat. Para revisar los eventos de entrega y facturación registrados, consulta Actividad y auditoría de ArchibotChat.

Guías relacionadas

Listo cuando

  • El plan activo coincide con lo esperado.
  • Hay créditos restantes disponibles en el grupo compartido de chat y API.
  • El estado de facturación es activo, de prueba o aprobado por un operador.