Perfis de usuário: um cliente não derruba a sua API

O que a Anthropic lançou

As notas de versão da Claude Platform registram duas entregas seguidas:

A página oficial de perfis explica o motivo. A Anthropic roda classificadores de segurança sobre o tráfego da API. Quem opera uma plataforma, um gateway ou revende acesso manda os pedidos dos clientes finais sob a própria organização. Sem um perfil no pedido, um único cliente final pode provocar uma medida que vale para a organização toda. Com o perfil, a medida pode valer só para aquele cliente, e o resto do tráfego segue normal.

A mesma página diz, com todas as letras, que os perfis não são cobráveis e não mudam o preço.

A conta do risco

Premissas de exemplo, não dados de uma empresa real:

• 120 empresas clientes;
• 3.000 conversas por cliente por mês;
• 6 turnos por conversa no Claude Haiku 5.5;
• 4.000 tokens de entrada e 300 de saída por chamada.

Pela tabela de preços do site, atualizada em outubro de 2026, cada chamada custa US$ 0,00055. Uma conversa sai por US$ 0,0033, e cada cliente gasta US$ 9,90 de API por mês. A conta total da plataforma fica em US$ 1.188,00 por mês, cerca de R$ 5.951,40.

Agora, o que fica parado se a organização for restringida:

Sem perfis, um problema com um cliente deixa 12.000 conversas por dia sem resposta, ou 72.000 chamadas. Com perfis, só as 100 conversas diárias do cliente envolvido ficam de fora.

O custo para ter essa proteção é de programação, não de fatura. Você faz uma chamada POST /v1/user_profiles por cliente, uma vez só, no cadastro. No exemplo, são 120 chamadas. Depois, cada pedido leva o cabeçalho anthropic-user-profile-id.

Que perfil usar para cada cliente

A documentação define dois tipos, pelo campo access_type:

No caso do chatbot vendido para empresas, o perfil por empresa (passthrough) é o mais natural. Para identificar a pessoa dentro da empresa, a documentação indica o campo metadata.user_id do próprio pedido.

Há uma recomendação que mexe na arquitetura: guardar o tráfego dos clientes numa organização e o uso interno em outra. Os perfis pertencem à organização, não ao workspace. Separar em workspaces dentro da mesma organização não basta.

Como saber que um cliente foi restringido

Desde 21 de outubro, cada perfil traz dois campos preenchidos pela Anthropic. O enforcement_status resume a situação:

O enforcement_actions lista cada medida aberta, com tipo, motivo, data de abertura e data de fim, se houver. Os motivos possíveis são unsupported_region, fraud_or_abuse, high_harm, usage_policy_violation, account_compromise e unspecified. Enquanto a medida está aberta, a Anthropic recusa alguns ou todos os pedidos com aquele ID.

Para achar os perfis com problema, liste os perfis com enforcement_status[]=restricted e enforcement_status[]=banned. Atenção a um detalhe: pedidos com o cabeçalho beta user-profiles-2026-09-04 ou anterior não recebem esses campos. É preciso tirar esse valor do cabeçalho.

E os webhooks? A página oficial diz que a entrega de eventos ainda não está no ar. Dá para registrar o endpoint e montar o código, mas ele não recebe nada por enquanto. O acesso também depende de pedido à equipe de contas da Anthropic. Até lá, o caminho é consultar a lista de perfis de tempos em tempos.

Onde funciona

No Bedrock e no Google Cloud gerido pelo Google, a plataforma só confere o formato do ID. Um pedido sem ID passa sem atribuição, e uma medida provocada por ele vale para a organização inteira. Na Claude Platform on AWS, os campos de medida sempre mostram unrestricted.

Checklist para quem revende IA

1. Crie um perfil por cliente no cadastro. A chamada não é idempotente: cada POST cria um perfil novo, mesmo com o mesmo reference_id. Guarde o ID no registro do cliente.
2. Mande o ID em todo pedido. Vale também para contagem de tokens e lotes. Num lote, o ID vale para todos os pedidos dele.
3. Separe o uso interno. Use outra organização para o tráfego da sua própria empresa.
4. Avise antes de cadastrar a base em massa. A criação de perfis tem limite de taxa. A documentação pede contato com a equipe de contas antes de registrar uma base grande.
5. Monitore o status. Consulte a lista filtrada por restricted e banned até os webhooks entrarem no ar.
6. Não mande o e-mail do cliente. Não há campo para o endereço. Use email_hash, com a mesma função de hash em todos os perfis.

Perguntas frequentes

Os perfis de usuário custam alguma coisa?

Não. A documentação diz que os perfis não são cobrados e não mudam o preço. No exemplo, a conta da API continua em US$ 1.188,00 por mês.

Quanto do meu tráfego fica protegido?

Depende de quantos clientes você tem. Com 120 clientes do mesmo tamanho, uma restrição em um perfil atinge 0,8% do tráfego, e não 100%.

Preciso de chave de administrador?

Não. Os exemplos da documentação usam uma chave de API comum. Só os webhooks pedem credencial de administrador.

Os webhooks já avisam quando um cliente é bloqueado?

Ainda não. A página oficial diz que a entrega de eventos não está no ar. Até lá, liste os perfis filtrando por enforcement_status.

Vale para quem tem um app com usuários pessoas físicas?

Sim. Nesse caso, crie um perfil por usuário com access_type application, o padrão.

Quer ver quanto o seu chatbot gasta por cliente? Use a calculadora de custo de chatbot com IA.