Créditos de IA

Los créditos de IA son lo que paga el trabajo de la inteligencia artificial en
Aloha Hospitality: cada pregunta a Kai y cada respuesta de un agente IA gasta
créditos de un mismo saldo. Se administran en Facturación → Créditos de IA,
junto a la pestaña Suscripción de las propiedades.

Antes se llamaban "créditos de Kai". Cambió el nombre porque ya no los gasta solo
Kai; el saldo y las reglas son los mismos.

La regla que explica casi todo: un saldo por cuenta, no por propiedad

Hay una sola bolsa de créditos para toda la cuenta, y todas las propiedades
gastan de ella. No se reparten créditos entre propiedades ni se compra un plan por
propiedad: la pantalla lo dice tal cual, "Un plan por cuenta: todas tus
propiedades gastan de los mismos créditos".

De ahí salen dos consecuencias que sorprenden:

Una propiedad con mucho movimiento puede dejar sin créditos a las demás.
Comprar los primeros créditos activa Kai en todas las propiedades de la
cuenta, sin pedírselo a nadie de Aloha y sin nada más que configurar.

Un solo saldo para Kai y los agentes

Kai y los Agentes IA (hoy, el Guest Co-Manager que atiende a los huéspedes por
WhatsApp) gastan del mismo saldo. Los agentes no tienen precio propio ni un cupo
aparte: la pantalla de Agentes IA muestra el mismo número bajo Saldo
compartido de créditos de IA, con el botón Comprar créditos.

Qué consume créditos

Se cobra por trabajo hecho, no por mensaje ni por tiempo:

Qué	Cuándo se cobra
Una pregunta a Kai	Cuando Kai termina de contestar.
Una respuesta de un agente IA	Cada vez que el agente procesa un mensaje del huésped, la mande o no.
Una tarea automática de la IA	Cuando la tarea termina.

Cuántos créditos cuesta cada una depende de cuánto trabajo le dio a la IA: una
pregunta corta cuesta poco y un análisis largo cuesta más. Ninguna acción cobrada
cuesta menos de 1 crédito. Por eso no hay un precio fijo por pregunta.

Mientras una tarea está en curso, la IA retiene unos créditos para asegurarse
de que alcanza; al terminar se cobra el precio real y se libera el resto. Por eso
la pantalla puede decir "N créditos están retenidos por trabajo de IA en curso", y
el número grande ya viene descontado de eso.

Lo que no gasta créditos: un mensaje que el agente ni siquiera procesó (por
ejemplo, porque estaba en modo desactivado o la conversación la tenía una
persona), ni una tarea que falló antes de llegar a la IA.

Planes y recargas

El saldo se llena de dos formas, y se pueden combinar:

Un plan de créditos. Una suscripción mensual de la cuenta: los créditos
llegan y se renuevan solos cada mes. Hay tres planes, Starter,
Professional y Business, y cada uno muestra en pantalla su precio y sus
créditos por mes. Se contrata con Contratar.
Una recarga. Una compra única con Recargar, en cualquier momento, tenga
la cuenta plan o no. Los créditos se suman a los que ya hay.

Los precios se leen en vivo del procesador de pago: la cifra en pantalla es la que
se cobra, y se paga en una página de pago aparte. Al volver, los créditos pueden
tardar unos segundos en aparecer: Estamos confirmando tu pago no es un error.
Volver a contratar después de un pago que no se completó no cobra dos veces.

Qué vence y qué no

Cada compra entra como un lote propio, y la pantalla los lista en De dónde
salen tus créditos, con su Origen, lo que queda Disponible y cuándo
Vence. Los orígenes son Plan, Recarga y Otorgado por Hospitality.

Lote	Cuándo vence
Recarga	Nunca. Se queda hasta que se gaste.
Plan	Al terminar el mes del plan. Lo que no se usó pasa una sola vez al mes siguiente cuando el plan se renueva, y aparece como Acumulado del mes anterior.
Acumulado del mes anterior	En la renovación siguiente. Ahí se pierde: no vuelve a pasar.
Otorgado por Hospitality	En la fecha que muestra su fila.

Siempre se gasta primero el lote que vence antes, y las recargas, que no
vencen, al final. Así los créditos de plan no se pierden mientras hay recargas
guardadas. Cuando hay créditos por vencer, la pantalla avisa cuántos y qué día.

Los créditos de plan solo pasan al mes siguiente si el plan se renueva. Con el
plan cancelado no hay renovación, y cada lote vence en su propia fecha.

Cambiar o cancelar el plan

Con Cambiar de plan, la pantalla marca cada opción como Subes o Bajas y
explica antes de confirmar cuál de las dos es:

Subir de plan se cobra hoy. Se cobra a la tarjeta la diferencia proporcional
de lo que queda del mes, y los créditos del plan nuevo llegan hoy mismo.
Bajar de plan no cobra nada hoy. El cambio se aplica en la próxima
renovación, y hasta entonces se conservan los créditos del plan actual.

Cancelar plan tampoco corta nada en el momento: el plan sigue activo hasta el
final del periodo pagado y después no se renueva. Los créditos ya entregados no se
pierden; vencen en su propia fecha. Mientras tanto el plan aparece como Se da de
baja.

Una cancelación no se puede deshacer desde la pantalla: hasta que termine el
periodo actual no se puede volver a contratar un plan. Las recargas sí siguen
disponibles.

Qué pasa al llegar a cero

Sin créditos, la IA deja de trabajar, y cada parte lo resuelve a su manera:

Kai contesta "Esta cuenta se quedó sin créditos de IA. Recarga para seguir
preguntando." en vez de responder. Antes de llegar ahí, el cuadro de preguntas
avisa Te quedan pocos créditos de IA.
El Guest Co-Manager se pausa. No contesta al huésped y le pasa la
conversación al equipo como cualquier otra transferencia: en la bandeja aparece
como Pausado · sin créditos, con el botón Recargar créditos, y el agente
se ve como En pausa · sin créditos. Nada le llega al huésped desde el agente
mientras dura la pausa.

Se reanuda solo en cuanto vuelve a haber créditos; no hay que reactivar nada.
Una conversación que se transfirió durante la pausa se queda con el equipo hasta
que alguien se la devuelva al agente.

Avisos

El saldo avisa dos veces, antes y al llegar a cero:

Notificación	Cuándo
Créditos de IA bajos	El saldo bajó a una fracción pequeña de lo que se cargó en el periodo.
Créditos de IA agotados	Se acabó el saldo, o una tarea de IA no pudo empezar por falta de créditos.

Llegan a la campana, por correo y como notificación push, con la acción Ver
facturación. Cada una se manda una sola vez por cruce: no se repite con cada
pregunta, y vuelve a quedar lista después de una recarga o una renovación.

Las reciben el dueño de la cuenta, siempre, y las personas activas con el permiso
Administrar la facturación y suscripción, que son las que pueden recargar. Ver
Notificaciones.

El saldo también se ve sin abrir Facturación: al pie del menú lateral, la tarjeta
Créditos de IA muestra cuántos quedan (o Sin créditos) y cuándo se
renuevan; y en Agentes IA, cada agente muestra sus Créditos usados de los
Últimos 7 días.

Ver en qué se gastan

Lo que llevas gastado muestra los créditos usados en el mes calendario, en toda
la cuenta, comparados con el mes pasado. Debajo se desglosa:

Por propiedad: qué propiedad los está gastando.
Por acción: qué tipo de trabajo (preguntas, respuestas de agentes, tareas
automáticas).
Por agente: Kai y cada agente IA.

Un desglose con una sola fila repetiría el total, así que solo aparece cuando hay
más de una. El mes se cuenta en hora UTC, no en la de la propiedad, porque el saldo
es de una cuenta que puede tener propiedades en varios husos horarios.

Quién puede comprar

Ver el saldo, los lotes y el gasto pide el permiso Ver la facturación y
suscripción.
Contratar, cambiar o cancelar el plan y recargar pide Administrar la
facturación y suscripción.

No hace falta nadie de Aloha para comprar: la compra la hace la cuenta y Kai queda
activo en todas sus propiedades.

Preguntas frecuentes

¿Puedo asignarle créditos a una sola propiedad?
No. El saldo es de la cuenta; el desglose Por propiedad dice quién gasta, pero
no reparte.

¿Si recargo y tengo plan, cuáles se gastan primero?
Los del plan, porque vencen antes. La recarga queda de reserva.

¿Pierdo los créditos si cancelo el plan?
No en el momento. Cada lote vence en su fecha; lo que se pierde es el paso al mes
siguiente, que solo ocurre cuando el plan se renueva.

¿Cuánto cuesta una pregunta a Kai?
Depende de cuánto trabajo le da a la IA, con un mínimo de 1 crédito. Lo que
llevas gastado muestra el consumo real.