Pruebas y revisión de apps
Cómo una nueva app de Linked billing sale de las pruebas y se abre a tus clientes, y qué sucede cuando cambias una app activa.
Con Linked billing, un cliente vincula su organización de Claude a tu app de OAuth. Una nueva app de Linked billing comienza en pruebas, donde solo los “test users” (usuarios de prueba) que designas pueden vincular sus organizaciones a ella. Para abrir la app a tus clientes, la publicas y Anthropic la revisa.
Si tu organización tiene facturación mediante factura, Anthropic no revisa tu app. Consulta Facturación mediante factura.
Una app está activa cuando Anthropic la ha aprobado o cuando la has publicado con facturación mediante factura. Cualquier cliente elegible puede vincular su organización a una app activa, y los vínculos que hicieron sus usuarios de prueba se mantienen. En la página de apps de OAuth de la Claude Console, el estado de una app activa indica Active.
Hasta que la app esté activa, la Console muestra uno de estos estados para ella:
| Estado | Qué significa |
|---|---|
| Testing | No has publicado la app. |
| In review | Anthropic está revisando la app o un cambio que hiciste mientras estaba activa. |
| Not approved | Anthropic revisó la app o el cambio y no lo aprobó. |
Una app que vuelve a revisión después de un cambio no vuelve a estar activa hasta que Anthropic aprueba el cambio. Cada app de Linked billing tiene su propio estado y sus propios usuarios de prueba. Consulta la nota en Paso 1: Crea la app de la guía de Linked billing.
Antes de comenzar
Termina el Proceso de configuración de la guía de Linked billing.
Administrar usuarios de prueba
Agregar usuarios de prueba
- Abre la página de la app desde la página de apps de OAuth en la Console.
- En la pestaña Settings, ve a la lista Test users debajo de Who can link.
- Ingresa la dirección de correo electrónico de la cuenta de Claude de un usuario de prueba y haz clic en Add. Repite para cada usuario de prueba.
- Haz clic en Save changes.
Después de guardar, las personas de la lista pueden vincular sus organizaciones a tu app. Hasta que tu app esté activa, la página de aprobación de Claude, donde una persona aprueba el vínculo, rechaza a cualquier otra persona. Para saber qué recibe entonces tu app, consulta Tu URI de redirección recibe error=access_denied en la guía de Linked billing.
Who can link permanece en Test users only mientras la app no está activa, y no puedes cambiarlo. La lista admite hasta 10 usuarios de prueba. Cada dirección tiene que coincidir exactamente con la dirección de la cuenta, pero las mayúsculas y minúsculas no importan. Una dirección con una etiqueta de signo más, como name+test@example.com, cuenta como una dirección diferente de name@example.com.
Vincular la organización de un usuario de prueba
Un usuario de prueba vincula su organización desde tu app y aprueba el vínculo en la página que usan tus clientes. Necesita el rol Administrador o Facturación en esa organización. Los pasos son los Pasos 4 a 8 de la guía de Linked billing. Prueba como cliente en esa guía te guía por ellos e indica cómo verificar que se creó el vínculo.
Para probar la app tú mismo, agrega tu propia dirección de correo electrónico a la lista. La organización propietaria de la app no puede vincularse a ella, así que usa una segunda organización de Claude tuya.
Después de que un usuario de prueba haya vinculado su organización, envía solicitudes que facturas a ella para probar tu app. Las pruebas usan dinero real. Anthropic cobra a la organización de cada usuario de prueba por las solicitudes que le facturas, igual que lo hace con cualquier cliente.
Hasta que tu app esté activa, cada vínculo nuevo necesita un “spend cap” (tope de gasto) mensual de $50 USD o menos. Para conocer las reglas del tope, consulta Mientras tu app está en pruebas en la guía.
Eliminar un usuario de prueba
La eliminación de un usuario de prueba surte efecto de inmediato. Termina cada vínculo con tu app que la persona aprobó. Después de que termina un vínculo, la Claude API rechaza las solicitudes que facturas a esa organización. Consulta Errores esperados.
- Si la pestaña Settings tiene cambios sin guardar, haz clic en Save changes o Discard. Hasta que lo hagas, la Console no te permite eliminar un usuario de prueba guardado.
- Quita la dirección del usuario de prueba de la lista Test users.
- Cuando la Console te lo pida, haz clic en Remove para confirmar. No necesitas hacer clic en Save changes.
Publicar la app
La publicación puede pedirte demostrar que controlas el dominio de tu app, agregando un registro DNS. Luego, Anthropic revisa la app. Un cambio de DNS toma tiempo, así que comienza antes de que necesites que los clientes se vinculen.
Antes de publicar, verifica lo siguiente:
- La autenticación del cliente está configurada. No puedes publicar la app hasta que lo esté.
- Tu app tiene una página de inicio, que estableces en la pestaña Appearance.
- Puedes cambiar los registros DNS del dominio de la página de inicio.
- Cada “redirect URI” (URI de redirección) está en el dominio de la página de inicio o en uno de sus subdominios.
Para saber qué cuenta como el dominio de la página de inicio y conocer las excepciones, consulta Reglas de dominio.
Sigue estos pasos para publicar la app:
- En la página de la app en la Console, haz clic en Publish app. Se abre un cuadro de diálogo.
- Si el cuadro de diálogo muestra Prove your domain, agrega el registro DNS TXT que te da donde administras el DNS de tu dominio. De lo contrario, ve al paso 5.
- Haz clic en Check. Si el dominio sigue mostrando Not proven yet, consulta Si no puedes demostrar el dominio.
- Cuando el dominio muestre Proven, haz clic en Continue.
- Si el cuadro de diálogo muestra una casilla para aceptar los Linked Billing Terms, selecciónala. Luego, haz clic en Publish app en el cuadro de diálogo para confirmar.
Mientras Anthropic revisa la app, su estado es In review. Para conocer los resultados, consulta La revisión.
Si no puedes demostrar el dominio
- El dominio sigue mostrando Not proven yet: Un cambio de DNS puede tardar hasta 48 horas en surtir efecto. Puedes cerrar el cuadro de diálogo y volver más tarde. Si estabas publicando, haz clic en Publish app de nuevo. Si estabas cambiando una app activa, vuelve a hacer la misma modificación, y la Console te da el mismo registro hasta que caduque.
- Check indica que el registro caducó: El registro DNS funciona durante 30 días desde que la Console lo muestra por primera vez. Después de eso, haz clic en Get a new record y agrega el nuevo registro. Un dominio que muestra Proven sigue demostrado.
- El cuadro de diálogo muestra un mensaje en lugar de un registro: Por ejemplo, el mensaje puede indicar que tu organización ya tiene 20 nombres de dominio. No puedes continuar hasta que eso se resuelva. Si necesitas ayuda, contacta al soporte.
Reglas de dominio
Un dominio es un nombre de host sin un www. inicial, y tu dominio es el de tu página de inicio. Por ejemplo, el dominio de una página de inicio en https://www.example.com es example.com. Un dominio demostrado se cubre a sí mismo y a sus subdominios.
- Dominios compartidos: El dominio compartido de un servicio de hosting no califica, así que usa un dominio propio.
- URI de redirección locales: Las URI de redirección en
localhost,127.0.0.1o[::1]no tienen que estar en el dominio de la página de inicio. - Subdominios hermanos: Si tu página de inicio está en
app.example.com, tu dominio es ese subdominio, y no cubre una URI de redirección enauth.example.com. Una forma de usar ambos es poner tu página de inicio enexample.com, que los cubre. - Un dominio que tu organización ya demostró: Es posible que tu organización haya demostrado un dominio antes, por ejemplo para otra app. Si cubre tu página de inicio y cada URI de redirección que no sea local, el cuadro de diálogo omite Prove your domain. Entonces, las URI de redirección no tienen que estar en el dominio de la página de inicio. Por ejemplo, con
example.comdemostrado, la página de inicio y una URI de redirección pueden estar en subdominios diferentes de este.
La revisión
Cuando termina la revisión, la página de la app en la Console muestra el resultado:
- Anthropic aprueba la app: La app queda activa. Who can link muestra entonces Any Claude user sin que tengas que hacer nada, y la Console oculta la lista Test users.
- Anthropic no aprueba la app: El estado de la app cambia a Not approved.
Durante la revisión y después de un resultado Not approved, tus usuarios de prueba conservan sus vínculos, y todavía puedes agregar y eliminar usuarios de prueba.
Si la app no se aprueba
No puedes volver a publicar la app por tu cuenta. Para consultar sobre la decisión, contacta al soporte. Todavía puedes cambiar la app, pero un cambio no inicia una nueva revisión.
Cambiar una app activa
Un cambio en el nombre, el logotipo, la página de inicio o las URI de redirección de una app activa devuelve la app a revisión. Hasta que Anthropic apruebe el cambio, solo tus usuarios de prueba pueden vincular sus organizaciones a la app. Consulta Hasta que Anthropic apruebe el cambio. Otros cambios, como los permisos o la autenticación del cliente, no devuelven la app a revisión.
Sigue estos pasos para cambiar el nombre, la página de inicio o las URI de redirección:
- Cambia la app en su pestaña Appearance (nombre y página de inicio) o en su pestaña Settings (URI de redirección).
- Haz clic en Save changes. Se abre un cuadro de diálogo antes de que se guarde nada.
- Si el cuadro de diálogo muestra Prove your domain, demuestra cada dominio que indica:
- Agrega el registro DNS TXT para el dominio. Luego, haz clic en Check. Si el dominio sigue mostrando Not proven yet, consulta Si no puedes demostrar el dominio.
- Cuando el dominio muestre Proven, haz clic en Next domain si queda otro dominio. De lo contrario, haz clic en Continue.
- Haz clic en Save and send to review.
Luego, la Console guarda el cambio, y el cambio surte efecto sin esperar la revisión. Mientras Anthropic revisa el cambio, el estado de la app es In review.
Para cambiar el logotipo, elígelo o elimínalo en la pestaña Appearance. El cuadro de diálogo se abre de inmediato. Haz clic en Send to review. Si cancelas, el logotipo no cambia.
Para volver a cambiar la app mientras su estado es In review o Not approved, consulta Cambiar una app que no está activa.
Cuando la Console te pide demostrar un dominio
La Console lo pide solo si cambiaste la página de inicio o una URI de redirección. También verifica la página de inicio y las URI de redirección que no cambiaste, así que el cuadro de diálogo también puede indicar sus dominios. Solo indica dominios que no cubre ningún dominio demostrado de tu organización. No verifica las URI de redirección locales, pero un cambio en una de ellas igualmente devuelve la app a revisión.
Después de un cambio, las URI de redirección pueden estar en dominios distintos del de la página de inicio si tu organización demuestra cada uno.
Hasta que Anthropic apruebe el cambio
Estas reglas se aplican desde que envías el cambio a revisión:
- Clientes que ya se vincularon: Sus organizaciones siguen vinculadas, y las solicitudes que les facturas siguen funcionando. Un cliente que se desvincula no puede volver a vincularse, a menos que la persona que realiza el vínculo esté en la lista Test users.
- Nuevos vínculos: La configuración Who can link vuelve a Test users only. La Console vuelve a mostrar la lista Test users con las personas que estaban en ella antes.
- Usuarios de prueba: Puedes agregar y eliminar personas de la lista. Eliminar a una persona también termina un vínculo que hizo con la organización de un cliente mientras la app estaba activa. Consulta Eliminar un usuario de prueba.
- Topes de gasto de las organizaciones vinculadas: Una organización vinculada conserva su configuración actual de tope de gasto incluso si su tope es superior a $50 USD o no tiene tope. Una configuración que cambie tiene que seguir las reglas de Mientras tu app está en pruebas.
Cuando termina la revisión del cambio
La revisión termina de una de dos maneras:
- Anthropic aprueba el cambio: La app vuelve a estar activa. Cualquier cliente elegible puede vincularse, la Console oculta la lista Test users y las reglas del tope para una app que no está activa ya no se aplican.
- Anthropic no aprueba el cambio: El estado de la app cambia a Not approved. El cambio sigue en vigor, y las reglas de Hasta que Anthropic apruebe el cambio siguen aplicándose. Consulta Si la app no se aprueba.
Cambiar una app que no está activa
Sigue estos pasos mientras el estado de la app es Testing, In review o Not approved:
- Cambia la app en su pestaña Appearance (nombre, logotipo y página de inicio) o en su pestaña Settings (URI de redirección).
- Haz clic en Save changes. Un cambio de logotipo se guarda cuando eliges o eliminas el logotipo.
Ningún cuadro de diálogo te pide confirmar, y el cambio no altera el estado de la app.
Cuando guardas un cambio en la página de inicio o en una URI de redirección, la Console verifica los dominios solo mientras el estado es In review. Una app en pruebas se somete a la verificación de dominio cuando la publicas. Durante una revisión, la página de inicio de la app modificada y cada URI de redirección que no sea local tienen que estar en dominios demostrados de tu organización. De lo contrario, la Console rechaza el cambio, y no te pide demostrar un dominio. Para pasar a un dominio que no esté demostrado, espera a que termine la revisión.
Facturación mediante factura
Con la “invoiced billing” (facturación mediante factura), Anthropic factura a la organización propietaria de tu app por su uso de la API, y esa organización no compra créditos prepagados. Tu app igualmente comienza en pruebas, y las reglas para los usuarios de prueba y el tope de gasto siguen aplicándose. Después de eso, hay tres diferencias:
- Publicar la app: En la página de la app, haz clic en Publish app. Luego, haz clic en Publish app en el cuadro de diálogo para confirmar. Anthropic no revisa la app, así que queda activa en cuanto la publicas.
- Página de inicio y dominio: No demuestras ningún dominio, así que el cuadro de diálogo omite Prove your domain. Tu app no necesita una página de inicio para publicarse, y la regla para las URI de redirección de Publicar la app no se aplica. La autenticación del cliente igualmente tiene que configurarse primero.
- Cambiar una app activa: La Console guarda un cambio cuando haces clic en Save changes o cuando eliges o eliminas un logotipo. No te pide demostrar un dominio ni confirmar, y después no hay ninguna revisión.
¿Te resultó útil esta página?