Cómo guardar claves de API y secretos en ChanTan Studio

Guarda la clave de un servicio como Stripe o Resend para que tu app la use de forma segura: se pega una vez, se cifra y nunca aparece en el chat ni en tu código.

Algunas funciones necesitan una clave de un servicio externo: una pasarela de pagos, un servicio de correo, un servicio de mapas. Una clave es como una contraseña que permite a tu app hablar con esa empresa.

Cuando Estudio Andino empieza a cobrar sus planes mensuales en línea, esa clave es la de Stripe.

ChanTan las guarda en «Secretos» — «Agrega información sensible, como claves de API, que tu app necesita para funcionar de forma segura.»

Lo más fácil es no hacer nada. Cuando una función necesita tu clave, la IA muestra una tarjeta enmascarada de «pega tu clave» justo debajo de su mensaje en el chat. La clave va directo al almacenamiento cifrado, se usa solo en el servidor y nunca aparece en el chat ni en tu código.

Esta página es para cuando quieras agregar o cambiar una tú mismo.

1. Abre «Gestionar ▾» → «Base de datos»

Arriba en tu proyecto, pulsa «Gestionar ▾» y luego «Base de datos».

2. Ve a «Avanzado» → «Secretos»

Desde «La sala de máquinas de tu app», busca la fila más discreta «Avanzado» y abre «Secretos».

3. Pulsa «Agregar nuevo secreto»

Aparece un formulario que pide un nombre y un valor.

4. Escribe el nombre y pega el valor

El «Nombre» es una etiqueta (por ejemplo, el nombre que el servicio te indicó usar). El «Valor» es la clave en sí: pégala tal cual, sin espacios de más.

⚠️ Los nombres que empiezan con CHANTAN_ se rechazan. Están reservados: «Chantan gestiona algunos secretos por ti tras bambalinas para que tu app pueda usar IA. Se mantienen seguros y ocultos aquí.» No puedes cambiarlos ni eliminarlos, y tampoco te hace falta.

5. Pulsa «Crear secretos»

✅ Listo. Tu clave aparece ahora en la lista mostrando solo su nombre y la fecha, nunca el valor. Es a propósito: después de guardarla, el valor no se te vuelve a mostrar, ni siquiera a ti.

Reemplazar una clave que cambió

Pídelo en el chat — algo como «cambió mi clave de Stripe» — y aparecerá una tarjeta para pegar la nueva.

Eliminar una clave

Para eliminar tendrás que escribir antes la palabra eliminar, porque quitar una clave puede dejar sin funcionar una parte de tu app.

⚠️ Apunta tus claves en un lugar seguro tuyo. ChanTan nunca vuelve a mostrar un valor guardado, así que si eliminas una y no la tienes en otro sitio, tendrás que pedir una clave nueva al servicio.

Límites

Relacionado: el código de servidor que usa tus claves

Los webhooks y las integraciones del lado del servidor (por ejemplo, las respuestas de una pasarela de pagos) corren como «Edge Functions» — «Pequeños fragmentos de código de servidor que impulsan cosas como webhooks de pago e integraciones. Pídele a la IA en el chat que agregue uno.»

Esa pantalla es una lista de solo lectura: deliberadamente no hay botón para crear. Para agregar una, describe lo que necesitas en el chat.

Límites honestos y seguridad

• Tus claves nunca se suben a GitHub. Si usas «Subir a GitHub», se te avisa: «Tus claves de base de datos se reemplazaron por marcadores — nunca se suben a GitHub.»
• Las claves se usan solo del lado del servidor: no llegan al navegador de quienes visitan tu app.
• Las funciones de IA dentro de tu app no necesitan ninguna clave. Los chatbots, la generación de imágenes y la lectura de imágenes funcionan de entrada, cobrados a tu billetera de créditos.
• ChanTan no puede recuperar una clave por ti. Si la perdiste, pide una nueva al servicio que la emitió y pega esa.

Si algo sale mal