Cobrança

Cobrança e créditos do ArchibotChat

Revise os planos, o pool compartilhado de créditos de chat e API, os controles de orçamento mensal, o checkout do Stripe e o portal do cliente na tela de Cobrança do chat.

Administradores do clienteMembros do clienteOperadores da plataforma

Última atualização 18 de junho de 2026

A cobrança controla se sua conta pode usar o ArchibotChat e quantos créditos ela tem. As mensagens de chat e as solicitações da API pública consomem do mesmo pool compartilhado de créditos, por isso esta única tela cobre os dois.

Abra a tela de Cobrança

1. Entre na Console e abra Chat na navegação à esquerda.
2. Abra a tela de Cobrança do espaço de trabalho do chat. O cabeçalho exibe Billing com a observação de que o chat e a API compartilham o mesmo pool de créditos.
3. Use Back to chat no topo da tela para voltar à visualização da conversa a qualquer momento.

O cartão superior mostra três valores ao vivo:

O que um crédito cobre

Um crédito é a unidade compartilhada da qual tanto o chat quanto a API pública consomem.

• Uma mensagem de chat que pede ao Archibot para responder consome do pool.
• Uma solicitação a um endpoint público feita com uma chave de API consome do mesmo pool.

Como o pool é compartilhado, o chat no navegador e as solicitações de API reduzem o mesmo saldo Restantes. O seguinte não consome créditos separados:

• Os fragmentos de resposta em streaming de uma única resposta.
• Os rastros de ferramentas e as citações anexadas a uma resposta.
• Visualizar metadados de cobrança, orçamento ou chaves de API.
• Baixar um artefato que você já gerou.

Para o comportamento dos artefatos, consulte Artefatos do ArchibotChat. Para a mecânica das solicitações de API, consulte Chaves de API do ArchibotChat.

Controles de orçamento mensal

Contas faturadas podem definir um orçamento mensal de créditos rígido, semelhante a um limite de cobrança de API. O orçamento é um teto imposto pela Console acima do seu plano, não um substituto dele.

O cartão Monthly budget controls mostra:

Para definir ou alterar o orçamento:

1. Insira um valor de créditos no campo de entrada, ou use um botão predefinido. As predefinições são No cap, 40 credits, 80 credits, 200 credits e 800 credits.
2. Defina o valor como 0 (a predefinição No cap) se não quiser nenhum teto imposto pela Console.
3. Escolha Save budget.

A barra de progresso acima do campo de entrada mostra o quão próximo o orçamento usado está do limite de orçamento.

Se o campo de orçamento e Save budget estiverem desativados, o cartão mostra uma observação de que os controles de orçamento aparecem após a conta ser aprovada. Os controles ficam disponíveis assim que sua conta estiver em um estado de cobrança elegível.

Planos

Cada cartão de plano lista o nome do plano e sua alocação compartilhada de créditos, por exemplo Team com 1,000 shared credits. Os planos, preços e alocações exatos disponíveis para sua conta vêm dos produtos do Stripe configurados para o seu ambiente.

• O cartão do seu plano ativo mostra Current plan e seu botão não é selecionável.
• Outros cartões de plano mostram um botão que você pode escolher para iniciar o checkout.

Sua conta também pode estar em um estado de teste, aprovado por um operador, suspenso ou com falha de pagamento, independentemente do plano exibido.

Iniciar o checkout do Stripe

Quando o checkout do Stripe está configurado para o seu ambiente e um plano tem um preço configurado:

1. Na tela de Cobrança, escolha o botão no cartão do plano desejado.
2. A Console abre o Stripe Checkout no navegador.
3. Conclua o pagamento no Stripe.

Após o checkout ser bem-sucedido, o ArchibotChat aguarda o webhook assinado do Stripe antes de atualizar o status de cobrança e conceder o lote de créditos correspondente. Se o navegador retornar do Stripe antes de o webhook terminar, atualize a tela de Cobrança.

O botão de um plano permanece desativado se o checkout não estiver pronto para o seu ambiente ou o plano não tiver um preço configurado. Se um plano que você espera não estiver selecionável, pergunte ao administrador do cliente ou ao suporte da ISM se o checkout está totalmente configurado para o seu ambiente.

Portal do cliente

Depois que existir um cliente do Stripe para sua conta, escolha Customer portal no canto superior direito da tela de Cobrança para abrir o portal do cliente hospedado pelo Stripe.

Use o portal para gerenciar detalhes de pagamento, faturas e configurações de assinatura que o Stripe expõe para sua conta. O ArchibotChat continua tratando os webhooks assinados do Stripe como a fonte de verdade após qualquer alteração no portal, portanto as atualizações de plano e créditos aparecem na tela de Cobrança depois que o webhook é processado.

O botão Customer portal fica desativado até que exista um cliente do Stripe para sua conta.

Lotes de créditos e expiração

Os créditos são rastreados em lotes. Cada concessão ou compra cria um lote com uma data de concessão, uma data de expiração, um produto, um valor original e um valor restante. Os débitos consomem primeiro o lote elegível que expira mais cedo, e lotes expirados não ficam disponíveis para uso de chat ou API.

Os registros de lotes de créditos e os ajustes de expiração são gerenciados do lado do operador. Se você precisar que um lote seja revisado, uma expiração verificada ou uma concessão aplicada, leve isso ao suporte da ISM em vez de esperar editar lotes na tela de Cobrança do chat. Consulte Casos de suporte do ArchibotChat.

Falha de pagamento

Se o pagamento falhar:

• Novas mensagens de chat ou chamadas de API podem ser bloqueadas.
• O histórico de conversas existente pode permanecer visível, dependendo da política.
• As chaves de API podem continuar listadas, mas falhar em novas solicitações.
• O administrador do cliente ou o responsável pela cobrança deve atualizar os detalhes de pagamento pelo portal do cliente.

O ArchibotChat verifica o status de cobrança antes de consumir créditos, portanto contas em estado de falha de pagamento, suspenso ou pendente não devem perder créditos por solicitações bloqueadas. Se o pagamento foi corrigido, mas o acesso ainda está bloqueado, entre em contato com o suporte da ISM.

Notificações de uso

Se as notificações de uso estiverem ativadas na configuração e a entrega de e-mail estiver configurada para o seu ambiente, o ArchibotChat envia um e-mail ao usuário da conta quando o saldo compartilhado de créditos cai para 20% ou menos. Apenas uma notificação de saldo baixo é enviada por conta para esse limite.

Se as notificações de ciclo de vida de cobrança estiverem ativadas, o ArchibotChat pode enviar um e-mail ao usuário de checkout ou de cobrança depois que os webhooks assinados do Stripe atualizarem o status do plano ou concederem créditos. Evidências de entrega, retorno (bounce) e supressão de e-mail são registradas para que o suporte possa distinguir um problema de configuração da conta de um problema de entrega de e-mail.

Para ativar as notificações, consulte Configuração do ArchibotChat. Para revisar os eventos de entrega e cobrança registrados, consulte Atividade e auditoria do ArchibotChat.

Guias relacionados

• Primeiros passos com o ArchibotChat para o primeiro acesso.
• Configuração do ArchibotChat para ativar o chat, o acesso à API e as notificações.
• Chaves de API do ArchibotChat para chaves que consomem do mesmo pool de créditos.
• Solução de problemas do ArchibotChat quando o acesso ou os créditos se comportam de forma inesperada.
• Casos de suporte do ArchibotChat para solicitações de créditos e cobrança do lado do operador.