Limites e segurança
Seu Client ID é público — e não há problema nisso
A chave na sua tag de script (kb_live_…) foi feita para ser visível, exatamente como um ID do Google Analytics. Qualquer pessoa que visualize o código-fonte da sua página pode lê-la. Tudo o que ela pode fazer é fazer perguntas ao seu bot.
Mantendo seu bot nos seus próprios sites
Adicione seus domínios em Instalar → Restringir aos seus domínios. Assim que a lista não estiver vazia, navegadores em outros sites serão recusados.
- Subdomínios de um domínio listado estão incluídos: adicionar
example.comtambém permiteshop.example.com. - O link e o QR code do seu bot continuam funcionando sempre — eles rodam em nossa página.
- O desenvolvimento local (
localhost) é sempre permitido para que você possa testar.
Isso impede que seu bot seja incorporado no site de terceiros. Não é, e nem pode ser, uma defesa contra requisições automatizadas por scripts — os navegadores aplicam isso, mas scripts podem fingir qualquer coisa. Para isso serve o limite mensal abaixo.
Limite mensal de respostas
Cada plano tem um limite de respostas por mês. Quando ele é atingido, o assistente para de responder até a virada do mês, em vez de gerar uma cobrança com a qual você não concordou.
Uma resposta conta quando a nossa IA gera uma resposta — incluindo quando ela lê a pergunta e conclui que não sabe responder. Ela não conta quando:
- sua resposta salva respondida diretamente, ou
- o assistente recusou antes de chegar à IA.
Como as respostas salvas são gratuitas, um bot que atingiu seu limite continua respondendo tudo o que seu dono escreveu à mão — ele decai para o seu próprio FAQ em vez de ficar em silêncio.
Você pode ver o uso em relação ao seu limite na visão geral do painel. Escreva para nós se precisar aumentá-lo.
O limite diário
Há também um limite de respostas por dia: um quinto da sua franquia mensal, e nunca menos de 50. Um bot que atinge esse limite para de usar a IA até o dia seguinte (UTC) e os visitantes veem "Este bot respondeu a um número atipicamente alto de perguntas hoje e está descansando até amanhã." Respostas salvas continuam funcionando, exatamente como no limite mensal.
Isso existe porque um script que descobre o seu Client ID público poderia gastar toda a sua franquia do mês em uma única noite. Uma empresa real consumindo um quinto da cota mensal todos os dias acabaria com ela em cinco dias de qualquer maneira, então o limite não é o que restringe o uso honesto — ele restringe o estrago que um estranho pode fazer antes que você perceba. Se você realmente tem esse volume de tráfego, peça-nos um limite maior; o teto sobe junto.
Limites de taxa
Os visitantes podem fazer até 60 perguntas por minuto a partir de um único endereço de internet. Uma conversa real nunca chega perto disso, mas um script atacando o seu bot sim.
O limite é propositalmente generoso porque as redes móveis colocam muitas pessoas atrás de um único endereço — seus clientes nunca devem receber a mensagem "muitas solicitações" por causa do tráfego de outra pessoa. Seu limite mensal de respostas, contabilizado por empresa e não por endereço, é o que realmente protege você de uma fatura surpresa.
Arquivos dos visitantes
| Fotos | JPG, PNG, WebP ou GIF — até 5 MB cada |
| Documentos | PDF, Word (.docx), texto simples, CSV ou Markdown — até 10 MB cada |
| Por mensagem | 3 arquivos |
| Por conversa | 10 arquivos |
| Por bot, por dia | 300 arquivos (UTC) |
| Envios do mesmo endereço | 10 por minuto |
O tipo é verificado pelos próprios bytes do arquivo, não pelo nome, então um SVG ou um programa renomeado para .png é recusado. Os arquivos são armazenados junto com a conversa e excluídos com ela. Eles nunca contam para o seu limite de respostas — o teto diário acima é o que os limita — e você pode desativar os arquivos completamente em Instalar.
Resumos
Resumos de conversa e diários têm sua própria franquia de 40 por dia por bot, contados apenas quando um novo resumo é escrito. Ler um resumo já existente novamente, ou baixar o PDF de um que já existe, é gratuito. Uma conversa precisa de pelo menos duas mensagens antes de poder ser resumida. Resumos não contam para as suas respostas.
Fluxo de boas-vindas
Respostas a um fluxo de boas-vindas são aceitas em até 30 por minuto do mesmo endereço, e um fluxo tem no máximo 12 etapas.
Ações
Uma ação chama sua própria API a partir dos nossos servidores. Um bot pode ter 8 ações; cada uma pode pedir 6 valores ao cliente e enviar 8 cabeçalhos, e sua API tem 8 segundos para responder. Uma conversa pode fazer 6 consultas em dez minutos, um endereço de internet 20 por hora, e sua API recebe no máximo 120 chamadas por minuto do seu bot. Uma consulta conta como uma resposta.
Só endereços https:// na internet pública podem ser chamados, redirecionamentos não são seguidos e toda requisição é assinada para que seu servidor possa verificar que ela veio do seu bot. Sua chave de API é armazenada criptografada e nunca é enviada a um navegador ou aplicativo.
Cardápio, pedidos e agendamentos
Uma lista de cardápio ou serviços comporta até 500 itens, cada um com até seis opções; uma importação lê até seis fotos por vez, e as importações que lemos para você (fotos, documentos, suas fontes do Treinar) podem ser feitas até 10 vezes por dia. Um pedido tem até 30 linhas e até 50 unidades de cada. Um chat pode ter três pedidos e três agendamentos em aberto ao mesmo tempo, um endereço de internet pode fazer 30 por hora, e um bot recebe até 500 pedidos e agendamentos por dia, incluindo os de teste. O e-mail que você recebe a cada novo pedido ou agendamento para em 200 por dia; as telas Pedidos e Agendamentos mostram todos. Os alertas por WhatsApp têm limite de 100 por dia por negócio, e cada pessoa da equipe pode enviar três mensagens de teste por hora. Nada disso tem custo durante o acesso antecipado.
Limites de arquivos de conhecimento
Documentos que você envia como conhecimento em Treinar:
| Tamanho máximo do arquivo | 8 MB |
| Tipos aceitos | PDF, Word (.docx), texto simples, Markdown, CSV |
| Texto lido por documento | Documentos grandes são lidos até um limite, e a fonte avisa quando isso acontece |