Claude Platform Docs
AdministraçãoClaude Platform OAuth

Teste e análise de apps

Como um novo app de Linked billing sai do teste e se abre para seus clientes, e o que acontece quando você altera um app ativo.

Com o Linked billing, um cliente vincula sua organização Claude ao seu app OAuth. Um novo app de Linked billing começa em teste, onde apenas os “test users” (usuários de teste) que você indica podem vincular suas organizações a ele. Para abrir o app aos seus clientes, você o publica, e a Anthropic o analisa.

Se sua organização tem cobrança por fatura, a Anthropic não analisa seu app. Consulte Cobrança por fatura.

Um app está ativo quando a Anthropic o aprovou ou quando você o publicou com cobrança por fatura. Qualquer cliente elegível pode vincular sua organização a um app ativo, e os vínculos que seus usuários de teste fizeram permanecem. Na página de apps OAuth no Claude Console, o status de um app ativo aparece como Active.

Até que o app esteja ativo, o Console mostra um destes status para ele:

StatusO que significa
TestingVocê não publicou o app.
In reviewA Anthropic está analisando o app ou uma alteração que você fez enquanto ele estava ativo.
Not approvedA Anthropic analisou o app ou a alteração e não a aprovou.

Um app que volta para análise após uma alteração não fica ativo novamente até que a Anthropic aprove a alteração. Cada app de Linked billing tem seu próprio status e seus próprios usuários de teste. Consulte a nota em Etapa 1: Criar o app no guia de Linked billing.

Antes de começar

Conclua o Processo de configuração no guia de Linked billing.

Gerenciar usuários de teste

Adicionar usuários de teste

  1. Abra a página do app a partir da página de apps OAuth no Console.
  2. Na aba Settings, vá até a lista Test users em Who can link.
  3. Insira o endereço de e-mail da conta Claude de um usuário de teste e clique em Add. Repita para cada usuário de teste.
  4. Clique em Save changes.

Depois que você salva, as pessoas na lista podem vincular suas organizações ao seu app. Até que seu app esteja ativo, a página de aprovação do Claude, onde uma pessoa aprova o vínculo, recusa qualquer outra pessoa. Para saber o que seu app recebe então, consulte Seu URI de redirecionamento recebe error=access_denied no guia de Linked billing.

Who can link permanece em Test users only enquanto o app não está ativo, e você não pode alterar isso. A lista comporta até 10 usuários de teste. Cada endereço precisa corresponder exatamente ao endereço da conta, mas maiúsculas e minúsculas não importam. Um endereço com uma tag de sinal de mais, como name+test@example.com, conta como um endereço diferente de name@example.com.

Um usuário de teste vincula sua organização a partir do seu app e aprova o vínculo na página que seus clientes usam. Ele precisa ter a função Admin ou Faturamento nessa organização. As etapas são as Etapas 4 a 8 do guia de Linked billing. Testar como cliente nesse guia conduz você por elas e diz como verificar se o vínculo foi feito.

Para testar o app você mesmo, adicione seu próprio endereço de e-mail à lista. A organização proprietária do app não pode se vincular a ele, então use uma segunda organização Claude sua.

Depois que um usuário de teste tiver vinculado sua organização, envie solicitações que você fatura para ela para experimentar seu app. O teste usa dinheiro real. A Anthropic cobra da organização de cada usuário de teste pelas solicitações que você fatura para ela, como faz com qualquer cliente.

Até que seu app esteja ativo, cada novo vínculo precisa de um “spend cap” (teto de gastos) mensal de $50 USD ou menos. Para as regras do teto, consulte Enquanto seu app está em teste no guia.

Remover um usuário de teste

A remoção de um usuário de teste entra em vigor imediatamente. Ela encerra cada vínculo com seu app que a pessoa aprovou. Depois que um vínculo termina, a Claude API recusa as solicitações que você fatura para essa organização. Consulte Erros esperados.

  1. Se a aba Settings tiver alterações não salvas, clique em Save changes ou Discard. Até que você faça isso, o Console não permite que você remova um usuário de teste salvo.
  2. Remova o endereço do usuário de teste da lista Test users.
  3. Quando o Console pedir, clique em Remove para confirmar. Você não precisa clicar em Save changes.

Publicar o app

A publicação pode pedir que você comprove que controla o domínio do seu app, adicionando um registro DNS. A Anthropic então analisa o app. Uma alteração de DNS leva tempo, então comece antes de precisar que os clientes vinculem.

Antes de publicar, verifique estes itens:

  • A autenticação do cliente está configurada. Você não pode publicar o app até que ela esteja.
  • Seu app tem uma página inicial, que você define na aba Appearance.
  • Você pode alterar os registros DNS do domínio da página inicial.
  • Cada URI de redirecionamento está no domínio da página inicial ou em um de seus subdomínios.

Para saber o que conta como o domínio da página inicial e quais são as exceções, consulte Regras de domínio.

Siga estas etapas para publicar o app:

  1. Na página do app no Console, clique em Publish app. Uma caixa de diálogo se abre.
  2. Se a caixa de diálogo mostrar Prove your domain, adicione o registro DNS TXT que ela fornece no local onde você gerencia o DNS do seu domínio. Caso contrário, vá para a etapa 5.
  3. Clique em Check. Se o domínio ainda mostrar Not proven yet, consulte Se você não conseguir comprovar o domínio.
  4. Quando o domínio mostrar Proven, clique em Continue.
  5. Se a caixa de diálogo mostrar uma caixa de seleção para aceitar os Termos do Linked Billing, marque-a. Em seguida, clique em Publish app na caixa de diálogo para confirmar.

Enquanto a Anthropic analisa o app, seu status é In review. Para os resultados, consulte A análise.

Se você não conseguir comprovar o domínio

  • O domínio ainda mostra Not proven yet: Uma alteração de DNS pode levar até 48 horas para entrar em vigor. Você pode fechar a caixa de diálogo e voltar mais tarde. Se você estava publicando, clique em Publish app novamente. Se você estava alterando um app ativo, faça a mesma edição novamente, e o Console fornece o mesmo registro até que ele expire.
  • Check informa que o registro expirou: O registro DNS funciona por 30 dias a partir de quando o Console o mostra pela primeira vez. Depois disso, clique em Get a new record e adicione o novo registro. Um domínio que mostra Proven permanece comprovado.
  • A caixa de diálogo mostra uma mensagem em vez de um registro: Por exemplo, a mensagem pode dizer que sua organização já tem 20 nomes de domínio. Você não pode continuar até que isso seja resolvido. Se precisar de ajuda, entre em contato com o suporte.

Regras de domínio

Um domínio é um hostname sem um www. no início, e seu domínio é o da sua página inicial. Por exemplo, o domínio de uma página inicial em https://www.example.com é example.com. Um domínio comprovado cobre a si mesmo e seus subdomínios.

  • Domínios compartilhados: Um domínio compartilhado de um serviço de hospedagem não se qualifica, então use um domínio próprio.
  • URIs de redirecionamento locais: URIs de redirecionamento em localhost, 127.0.0.1 ou [::1] não precisam estar no domínio da página inicial.
  • Subdomínios irmãos: Se sua página inicial está em app.example.com, seu domínio é esse subdomínio, e ele não cobre um URI de redirecionamento em auth.example.com. Uma forma de usar ambos é colocar sua página inicial em example.com, que cobre os dois.
  • Um domínio que sua organização já comprovou: Sua organização pode ter comprovado um domínio anteriormente, por exemplo para outro app. Se ele cobrir sua página inicial e cada URI de redirecionamento que não é local, a caixa de diálogo pula Prove your domain. Os URIs de redirecionamento então não precisam estar no domínio da página inicial. Por exemplo, com example.com comprovado, a página inicial e um URI de redirecionamento podem estar em subdomínios diferentes dele.

A análise

Quando a análise termina, a página do app no Console mostra o resultado:

  • A Anthropic aprova o app: O app fica ativo. Who can link passa então a mostrar Any Claude user sem nenhuma ação sua, e o Console oculta a lista Test users.
  • A Anthropic não aprova o app: O status do app muda para Not approved.

Durante a análise e após um resultado Not approved, seus usuários de teste mantêm seus vínculos, e você ainda pode adicionar e remover usuários de teste.

Se o app não for aprovado

Você não pode publicar o app novamente por conta própria. Para perguntar sobre a decisão, entre em contato com o suporte. Você ainda pode alterar o app, mas uma alteração não inicia uma nova análise.

Alterar um app ativo

Uma alteração no nome, no logotipo, na página inicial ou nos URIs de redirecionamento de um app ativo envia o app de volta para análise. Até que a Anthropic aprove a alteração, apenas seus usuários de teste podem vincular suas organizações ao app. Consulte Até que a Anthropic aprove a alteração. Outras alterações, como permissões ou autenticação do cliente, não enviam o app de volta para análise.

Siga estas etapas para alterar o nome, a página inicial ou os URIs de redirecionamento:

  1. Altere o app na aba Appearance (nome e página inicial) ou na aba Settings (URIs de redirecionamento).
  2. Clique em Save changes. Uma caixa de diálogo se abre antes que algo seja salvo.
  3. Se a caixa de diálogo mostrar Prove your domain, comprove cada domínio que ela indicar:
    1. Adicione o registro DNS TXT do domínio. Em seguida, clique em Check. Se o domínio ainda mostrar Not proven yet, consulte Se você não conseguir comprovar o domínio.
    2. Quando o domínio mostrar Proven, clique em Next domain se restar outro domínio. Caso contrário, clique em Continue.
  4. Clique em Save and send to review.

O Console então salva a alteração, e a alteração entra em vigor sem esperar pela análise. Enquanto a Anthropic analisa a alteração, o status do app é In review.

Para alterar o logotipo, escolha-o ou remova-o na aba Appearance. A caixa de diálogo se abre imediatamente. Clique em Send to review. Se você cancelar, o logotipo não muda.

Para alterar o app novamente enquanto seu status é In review ou Not approved, consulte Alterar um app que não está ativo.

Quando o Console pede que você comprove um domínio

O Console pergunta apenas se você alterou a página inicial ou um URI de redirecionamento. Ele também verifica a página inicial e os URIs de redirecionamento que você não alterou, então a caixa de diálogo também pode indicar os domínios deles. Ela indica apenas domínios que nenhum domínio comprovado da sua organização cobre. Ele não verifica URIs de redirecionamento locais, mas uma alteração em um deles ainda envia o app de volta para análise.

Após uma alteração, os URIs de redirecionamento podem estar em domínios diferentes do da página inicial, se sua organização comprovar cada um.

Até que a Anthropic aprove a alteração

Estas regras se aplicam a partir de quando você envia a alteração para análise:

  • Clientes que já vincularam: As organizações deles permanecem vinculadas, e as solicitações que você fatura para eles continuam funcionando. Um cliente que desvincula não pode vincular novamente, a menos que a pessoa que vincula esteja na lista Test users.
  • Novos vínculos: A configuração Who can link volta para Test users only. O Console mostra a lista Test users novamente, com as pessoas que estavam nela antes.
  • Usuários de teste: Você pode adicionar e remover pessoas da lista. Remover uma pessoa também encerra um vínculo que ela fez com a organização de um cliente enquanto o app estava ativo. Consulte Remover um usuário de teste.
  • Tetos de gastos de organizações vinculadas: Uma organização vinculada mantém sua configuração atual de teto de gastos, mesmo que seu teto esteja acima de $50 USD ou que ela não tenha teto. Uma configuração que ela altere precisa seguir as regras em Enquanto seu app está em teste.

Quando a análise da alteração termina

A análise termina de uma de duas formas:

  • A Anthropic aprova a alteração: O app fica ativo novamente. Qualquer cliente elegível pode vincular, o Console oculta a lista Test users, e as regras de teto para um app que não está ativo deixam de se aplicar.
  • A Anthropic não aprova a alteração: O status do app muda para Not approved. A alteração permanece em vigor, e as regras em Até que a Anthropic aprove a alteração continuam se aplicando. Consulte Se o app não for aprovado.

Alterar um app que não está ativo

Siga estas etapas enquanto o status do app é Testing, In review ou Not approved:

  1. Altere o app na aba Appearance (nome, logotipo e página inicial) ou na aba Settings (URIs de redirecionamento).
  2. Clique em Save changes. Uma alteração de logotipo é salva quando você escolhe ou remove o logotipo.

Nenhuma caixa de diálogo pede que você confirme, e a alteração não modifica o status do app.

Quando você salva uma alteração na página inicial ou em um URI de redirecionamento, o Console verifica domínios apenas enquanto o status é In review. Um app em teste passa pela verificação de domínio quando você publica. Durante uma análise, a página inicial do app alterado e cada URI de redirecionamento que não é local precisam estar em domínios comprovados da sua organização. Caso contrário, o Console recusa a alteração e não pede que você comprove um domínio. Para mudar para um domínio que não está comprovado, espere até que a análise termine.

Cobrança por fatura

Com a cobrança por fatura, a Anthropic emite faturas para a organização proprietária do seu app pelo uso da API, e essa organização não compra créditos pré-pagos. Seu app ainda começa em teste, e as regras para usuários de teste e o teto de gastos ainda se aplicam. Depois disso, três coisas são diferentes:

  • Publicar o app: Na página do app, clique em Publish app. Em seguida, clique em Publish app na caixa de diálogo para confirmar. A Anthropic não analisa o app, então ele fica ativo assim que você o publica.
  • Página inicial e domínio: Você não comprova nenhum domínio, então a caixa de diálogo pula Prove your domain. Seu app não precisa de página inicial para ser publicado, e a regra para URIs de redirecionamento em Publicar o app não se aplica. A autenticação do cliente ainda precisa ser configurada primeiro.
  • Alterar um app ativo: O Console salva uma alteração quando você clica em Save changes ou quando escolhe ou remove um logotipo. Ele não pede que você comprove um domínio nem que confirme, e nenhuma análise se segue.

Esta página foi útil?