Uso e orçamento

Como a IA roda com a chave do seu provedor, quem cobra é o provedor, na sua conta com ele. O BotoZap não cobra pela IA. Ele registra cada chamada feita com a sua chave, estima quanto ela custou e deixa você definir um limite por mês, para não ter surpresa na fatura.

A tela fica em Configurações › Uso e orçamento e tem duas abas: Consumo e Orçamento e preços.

Antes de começar

• Escolha o cliente no seletor do topo do painel. Consumo e orçamento são separados por cliente.
• Para mudar orçamento e preços você precisa ser Administrador.
• Tenha em mãos a tabela de preços do seu provedor (o valor por milhão de tokens de cada modelo que você usa). Sem os preços, o BotoZap conta as chamadas mas não sabe quanto elas custaram.

Como a IA é medida

Os provedores cobram por tokens: pedacinhos de texto (uma palavra costuma virar um ou mais tokens). Entra na conta tudo o que é enviado ao modelo (instruções, histórico da conversa, materiais consultados) e tudo o que ele escreve de volta. Por isso uma conversa longa custa mais do que uma pergunta rápida.

Cada vez que o BotoZap usa a sua chave é uma chamada: a resposta do agente, a transcrição de um áudio, a busca na base de conhecimento, a verificação de segurança da mensagem. Uma única mensagem do contato pode gerar mais de uma chamada.

Os valores aparecem em dólar, que é a moeda dos provedores. O custo é uma estimativa feita com os preços que você cadastrar. A fatura do provedor é que vale.

Aba Consumo

No topo, escolha o Período (Mês ou Intervalo de dias (até 90)), o Agente e a Finalidade que quer ver. Meses e dias seguem o horário de Brasília.

• Chamadas: quantas vezes a sua chave foi usada.
• Custo estimado: a soma das chamadas que têm preço. Chamadas sem preço cadastrado aparecem como Não medido e ficam fora da soma.
• Tokens de entrada / saída: o que foi enviado ao modelo e o que ele escreveu.
• Latência p50 / p95: o tempo de resposta do provedor. O primeiro número é o tempo típico; o segundo, o das chamadas mais lentas.
• Passagem para atendimento humano: quantas conversas atendidas por agentes foram passadas para a equipe.
• Chamadas por dia, Consumo por modelo e a divisão por finalidade e Por agente mostram de onde vem o gasto.
• Transcrição de áudio aparece quando o agente transcreveu áudios, com os segundos medidos.

Quando algumas chamadas não têm custo completo, um aviso diz quantas são. Cadastre os preços que faltam na outra aba.

Passo a passo: cadastrar os preços

1. Abra a aba Orçamento e preços.
2. Em Preços usados nas estimativas, clique em Cadastrar.
3. Escolha o Provedor e digite o ID do modelo exatamente como aparece na chave (por exemplo, o nome que você escolheu no agente).
4. Em Tarifa de texto, preencha Entrada, Saída, Cache: leitura e Cache: escrita, em dólares por milhão de tokens. Se o modelo não tem preço de cache, repita o preço de entrada nesses dois campos.
5. Se esse modelo transcreve áudio, escolha a Unidade de cobrança em Tarifa de áudio: Minutos de áudio (preço por minuto) ou Tokens de áudio e texto (preços por milhão). Para os demais, deixe Sem tarifa de áudio.
6. Clique em Salvar preços.

Preços novos valem para as próximas chamadas. O histórico mantém o preço que valia na hora.

Chamadas antigas que ficaram sem preço podem ganhar estimativa depois: na linha do modelo, clique em Estimar histórico sem preço e em Confirmar estimativa. As chamadas medidas recebem o custo calculado com o preço atual. As que terminaram sem medição (por exemplo, com erro) recebem o custo máximo que tinham pedido ao provedor. Esses valores passam a contar no orçamento do mês em que a chamada aconteceu.

Passo a passo: definir o orçamento mensal

1. Na aba Orçamento e preços, em Orçamento mensal do Cliente, escolha o que fazer em Ao atingir o limite:
   • Acompanhar sem limite: só registra o consumo. Sem limite não há alerta, então o campo Avisar a partir de (%) fica desativado.
   • Avisar, sem interromper: cria um alerta quando o gasto chega ao percentual escolhido, e a IA continua funcionando.
   • Interromper novas chamadas: cria o alerta e, ao chegar no limite, a IA para de fazer chamadas até o mês virar ou você mudar o limite.
2. Preencha o Limite mensal (US$).
3. Em Avisar a partir de (%), diga quando quer ser avisado. O padrão é 80%.
4. Clique em Salvar orçamento e, na janela de confirmação, em Confirmar.

O mês do orçamento segue o horário de Brasília: ele vira à meia-noite do dia 1º. A tela mostra quanto já foi gasto no mês e quanto está reservado. Antes de cada chamada, o BotoZap separa o custo máximo que ela pode ter, para não estourar o limite no meio do caminho. Quando a chamada termina e o provedor informa o consumo, o valor medido substitui a reserva. Se ela termina sem medição (erro, interrupção ou provedor que não informou o consumo), a reserva continua contando no limite: assim o orçamento fica protegido sem parar a IA por causa de uma falha.

Alertas

Os avisos do orçamento aparecem em IA › Casos, no filtro Só alertas:

• O gasto de IA atingiu o aviso definido: o gasto do mês chegou ao percentual de Avisar a partir de (%). Só existe nos modos Avisar, sem interromper e Interromper novas chamadas.
• IA interrompida pelo orçamento: no modo Interromper novas chamadas, uma chamada foi recusada por falta de saldo no limite ou por falta de preço.

Cada alerta aparece uma vez por mês. Veja Casos e alertas.

Limite por resposta do agente

Além do limite mensal, cada agente pode ter um teto por resposta. Na configuração do agente, em Avançado, preencha Limite estimado por execução no provedor (USD, opcional). Uma resposta que passaria desse valor é interrompida. É útil para evitar que uma conversa enorme gere uma chamada cara.

O que acontece depois

• Cada chamada nova entra na aba Consumo. Atualize a página para ver os números mais recentes.
• Com Interromper novas chamadas, ao chegar no limite, o agente para de responder. As mensagens dos contatos continuam chegando na Inbox para a equipe atender.
• No mês seguinte (à meia-noite do dia 1º, no horário de Brasília), o controle recomeça do zero.

Problemas comuns

O custo aparece como Não medido. Falta cadastrar o preço do modelo usado. Cadastre em Orçamento e preços e use Estimar histórico sem preço para as chamadas antigas.

O agente parou de responder e o limite nem chegou perto. No modo Interromper novas chamadas, uma chamada feita com um modelo sem preço cadastrado para as próximas, porque o custo dela é desconhecido. Confira em Consumo por modelo quais modelos têm chamadas em Sem custo completo, cadastre o preço deles e clique em Estimar histórico sem preço na linha de cada um. A IA volta a responder assim que todas as chamadas do mês tiverem valor.

Os áudios pararam de ser transcritos. Com o modo de interrupção ligado, a transcrição precisa de tarifa de áudio no modelo de transcrição. Edite os preços desse modelo e escolha a Unidade de cobrança. Com Minutos de áudio, a reserva usa a duração do arquivo e sempre conta no limite. Com Tokens de áudio e texto, uma transcrição que termina sem medição para as próximas chamadas até você usar Estimar histórico sem preço nesse modelo, porque a reserva por tokens é só uma estimativa.

O valor não bate com a fatura do provedor. A tela é uma estimativa feita com os seus preços. Diferenças de câmbio, impostos, descontos do provedor e uso da chave fora do BotoZap não entram no cálculo.

Mudei o limite e continua bloqueado. Confira se salvou e confirmou. Se o gasto não chegou ao limite, o bloqueio vem de chamadas com custo desconhecido: cadastre os preços que faltam e use Estimar histórico sem preço na linha de cada modelo. Chamadas com erro que já tinham preço não bloqueiam: elas contam pela reserva.