Atualizado em Sep 2, 2026

Definir atraso de resposta

Use esta ação quando um contato escreve em fragmentos — um único pensamento dividido em várias mensagens rápidas — e o agente deve esperar o último fragmento antes de responder, para que todos recebam uma resposta em vez de uma resposta cada.

Melhor para

• Contatos que enviam "mensagens picadas" (três ou quatro linhas curtas em sequência)
• Deixar o agente ajustar o próprio ritmo no meio da conversa, por meio de uma ferramenta
• Voltar a respostas rápidas quando o contato preferir

Como funciona

Todo canal tem uma janela de espera antes de responder (replyDebounceMs nas opções do canal). Quando uma mensagem do contato chega, o agente espera esse tempo; se outra mensagem chegar dentro da janela a espera recomeça, e o agente responde a tudo de uma vez quando a janela fecha.

Esta ação grava uma sobrescrita por conversa dessa janela. Ela permanece na conversa até ser alterada ou limpa — não é por execução nem por mensagem.

Campos principais

Campo	O que faz
Atraso em segundos	Expressão CEL que avalia para a espera, em segundos, após a última mensagem do contato. 0 responde imediatamente; valores acima de 60 são limitados a 60. Deixe vazio (ou avalie para null) para limpar a sobrescrita e voltar à configuração do canal

O campo é uma expressão CEL de propósito: uma ferramenta do agente só chega a uma ação pelos seus passos actions[], e o passo vincula os argumentos da ferramenta. Um número simples só poderia guardar um valor fixo.

O que passos posteriores podem usar

Saída	Significado
replyDelayMs	A sobrescrita agora gravada na conversa, em milissegundos (0 = responder imediatamente), ou null quando foi limpa

Leia com get(step(N), 'replyDelayMs'). Esta ação publica na raiz do passo — não há objeto data.

Entregando ao agente como ferramenta

Crie uma ferramenta chamada ajustar_ritmo_de_resposta com um parâmetro:

Parâmetro	Tipo	Descrição
delay_seconds	number	Segundos de espera após a última mensagem do contato antes de responder (0 a 60). Omita para voltar ao padrão do canal.

Adicione um passo à ferramenta com a ação Definir atraso de resposta e vincule o campo ao argumento:

delay_seconds:  args.delay_seconds

Depois, diga ao agente quando usá-la. Um prompt que funciona:

Se o contato enviar a mensagem em vários fragmentos curtos seguidos, chame ajustar_ritmo_de_resposta com delay_seconds entre 8 e 10 para responder a todos os fragmentos de uma vez. Se ele pedir respostas mais rápidas ou passar a escrever mensagens completas, chame de novo com um valor pequeno (ou sem valor para redefinir). Não mencione a ferramenta ao contato.

Dicas

• De 8 a 10 segundos é uma boa janela para quem escreve em fragmentos; acima de 20 segundos começa a parecer silêncio.
• 0 é um valor válido e significa "responder assim que a mensagem chegar" — útil para contatos que reclamam de lentidão.
• A sobrescrita sobrevive entre execuções. Se o hábito do contato mudar, redefina; nada redefine por você.
• Em uma execução manual de workflow não há conversa, então o passo falha com agent_set_reply_delay_no_conversation. Ela foi feita para ferramentas de agente e workflows ligados a uma conversa.