Limitação de Taxa
Limite mensagens por sessão para prevenir abusos e controlar custos.
O rate limiting controla quantas mensagens cada visitante pode enviar dentro de uma janela de tempo rolante. Use isso para prevenir abusos, reduzir custos e garantir acesso justo para todos os visitantes.
Configurando o Rate Limiting
- Vá até a aba Configurações do seu agente
- Clique em Segurança
- Encontre Limite de taxa
- Defina o número máximo de mensagens e a janela em segundos
- Personalize a mensagem de limite (opcional)
- Salve as alterações
Opções de Configuração
Mensagens Por Janela
O número máximo de mensagens que um único visitante pode enviar durante a janela rolante:
- Mín: 1
- Máx: 100
- Padrão: 20
Janela (Segundos)
Quanto tempo a janela rolante dura:
- Mín: 10 segundos
- Máx: 3600 segundos (1 hora)
- Padrão: 240 segundos (4 minutos)
Mensagem de Limite
Texto personalizado exibido aos visitantes quando o limite é atingido. Máximo de 500 caracteres. Padrão: "Too many messages in a row".
Como os Visitantes São Identificados
Cada visitante é rastreado pelo endereço IP do cliente. Se nenhum IP estiver disponível, o ID da conversa é usado como alternativa. O limite é aplicado no lado do servidor por chatbot, então os visitantes não conseguem contornar isso limpando os dados do navegador.
O Que Acontece no Limite
Quando um visitante excede o limite, o chatbot responde com a sua mensagem de limite configurada em vez de gerar uma nova resposta. O contador é naturalmente reiniciado conforme a janela rolante avança — os visitantes podem continuar conversando depois que tempo suficiente tiver passado.
Exemplo de mensagem:
"Too many messages in a row. Please try again later or contact us directly at [email protected]."
Escolhendo o Limite Correto
| Caso de Uso | Limite Recomendado |
|---|---|
| FAQ/Perguntas simples | 10-15 mensagens / 4 min |
| Suporte ao cliente | 20-30 mensagens / 4 min |
| Documentação técnica | 30-50 mensagens / 5 min |
| Consultas complexas | 50-100 mensagens / 10 min |
O rate limiting está sempre ativo — o menor valor permitido é 1 mensagem por 10 segundos. Se você quiser uma configuração muito permissiva, aumente maxMessages para próximo de 100 e diminua a janela.
Considerações
Muito Baixo:
- Frustra os visitantes no meio da conversa
- Interações de suporte incompletas
- Experiência do usuário ruim
Muito Alto:
- Risco de abuso
- Custos mais altos
- Potencial para spam
Comece com o padrão (20 mensagens por 4 minutos) e ajuste com base nos dados do seu Chat Logs.
Rate Limiting vs. Limites do Plano
| Recurso | Rate Limiting | Limites do Plano |
|---|---|---|
| Escopo | Por visitante (IP), janela de tempo rolante | Por workspace, por mês |
| Propósito | Prevenir abuso | Controlar custos |
| O que acontece | Mensagem de limite retornada | Agente pausado |
| Reinício | Quando a janela rolante avança | Ciclo de faturamento |
Ambos podem estar ativos simultaneamente. Os limites do plano protegem seu uso total; o rate limiting protege o uso por visitante.
Monitorando os Limites de Taxa
Verifique se os visitantes estão atingindo os limites:
- Vá até Registros de chat
- Procure por conversas que terminam abruptamente
- Revise a contagem de mensagens por conversa
Se muitos visitantes atingirem os limites, considere:
- Aumentar o limite
- Melhorar a qualidade das respostas (menos ida e volta)
- Adicionar mensagens sugeridas para guiar as conversas
Contornando os Limites de Taxa
Para testes internos, você pode:
- Usar o Playground (ainda sujeito aos mesmos limites)
- Criar um agente de teste separado com um limite muito alto (por exemplo, 100 mensagens por 10 segundos)
- Aumentar o limite temporariamente durante testes de carga
Boas Práticas
- Comece com os padrões - 20 mensagens por 4 minutos é uma boa referência inicial
- Monitore o feedback - Verifique se os visitantes reclamam dos limites
- Combine com restrições de domínio - Proteção extra
- Forneça alternativas - Inclua informações de contato na mensagem de limite
- Revise regularmente - Ajuste com base nos padrões reais de uso
Próximos Passos
- Veja os registros de chat para monitorar conversas
- Configure restrições de domínio para proteção adicional
- Defina a visibilidade para controlar o acesso