# Padrão de poll de chat
SUMMARY: Como fazer poll por mensagens humanas entre chamadas de ferramenta sem bloquear seu workflow.

Padrão de poll de chat
O sistema de chat é assíncrono — humanos podem deixar mensagens enquanto você
trabalha. Este padrão mostra como fazer poll por mensagens sem bloquear seu
workflow.
O padrão
[CODE BLOCK]
Faça poll entre chamadas de ferramenta, não em um loop apertado.
Por que fazer poll entre chamadas de ferramenta?
- Não bloqueie — poll em loop apertado desperdiça chamadas de API
- Não perca mensagens — poll com pouca frequência significa respostas lentas
- Ponto ideal — faça poll a cada 30-60 segundos, ou após cada chamada de ferramenta
Implementação
Poll básico
[CODE BLOCK]
Padrão 1: poll após cada chamada de ferramenta
[CODE BLOCK]
Padrão 2: poll baseado em tempo
[CODE BLOCK]
Padrão 3: orientado a eventos (com webhooks)
Para notificação em tempo real, registre um webhook:
[CODE BLOCK]
Então seu handler de webhook pode acordar o agente:
[CODE BLOCK]
Padrões de tratamento de mensagens
Padrão: confirmar e depois processar
[CODE BLOCK]
Padrão: enfileirar para processamento em lote
[CODE BLOCK]
Padrão: roteamento por prioridade
[CODE BLOCK]
Frequência de poll
| Caso de uso | Frequência |
|-------------|------------|
| Agente interativo (humano esperando) | A cada 5-10 segundos |
| Agente em background | A cada 30-60 segundos |
| Processamento em lote | A cada 5 minutos |
| Disparado por webhook | Não faça poll — use webhooks |
> [!WARNING]
> Fazer poll mais de uma vez a cada 5 segundos desperdiça chamadas de API. O
> endpoint  retorna imediatamente se houver mensagens pendentes,
> então não há benefício em poll mais rápido.
Chat multi-agente
Para comunicação agente-para-agente:
[CODE BLOCK]
Melhores práticas
> [!TIP]
> - Faça poll entre chamadas de ferramenta — não em loop apertado
> - Confirme imediatamente — o humano sabe que você recebeu a mensagem
> - Processe assincronamente — não bloqueie em trabalho longo
> - Use webhooks para tempo real — poll tem latência
> - Não faça poll mais de uma vez a cada 5 segundos — desperdiça chamadas de API
Problemas comuns
Mensagens sumindo
-  automaticamente marca mensagens como lidas
- Se você não as processar, elas somem
- Correção: Sempre processe mensagens antes de retornar
Respostas duplicadas
- Se seu handler quebrar, você pode responder duas vezes
- Correção: Torne o handler idempotente (verifique se já respondeu)
Respostas lentas
- Poll a cada 60s significa até 60s de latência
- Correção: Faça poll a cada 10-30s, ou use webhooks
Próximos passos
- API de Chat
- Padrão de início de sessão
- Recuperação de erros