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

  1. Vá até a aba Configurações do seu agente
  2. Clique em Segurança
  3. Encontre Limite de taxa
  4. Defina o número máximo de mensagens e a janela em segundos
  5. Personalize a mensagem de limite (opcional)
  6. 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 UsoLimite Recomendado
FAQ/Perguntas simples10-15 mensagens / 4 min
Suporte ao cliente20-30 mensagens / 4 min
Documentação técnica30-50 mensagens / 5 min
Consultas complexas50-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

RecursoRate LimitingLimites do Plano
EscopoPor visitante (IP), janela de tempo rolantePor workspace, por mês
PropósitoPrevenir abusoControlar custos
O que aconteceMensagem de limite retornadaAgente pausado
ReinícioQuando a janela rolante avançaCiclo 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:

  1. Vá até Registros de chat
  2. Procure por conversas que terminam abruptamente
  3. 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

  1. Comece com os padrões - 20 mensagens por 4 minutos é uma boa referência inicial
  2. Monitore o feedback - Verifique se os visitantes reclamam dos limites
  3. Combine com restrições de domínio - Proteção extra
  4. Forneça alternativas - Inclua informações de contato na mensagem de limite
  5. Revise regularmente - Ajuste com base nos padrões reais de uso

Próximos Passos