VolundOS

Thread de destino do disparo

Quando o gatilho dispara, o trabalho pode acontecer numa conversa nova ou sempre na mesma, o que preserva o histórico e faz o agente lembrar do que já fez.

Atualizado em 10 de agosto de 2026

Thread de destino do disparo

Camada funcional

Quando o gatilho dispara, o trabalho precisa acontecer em algum lugar. Pode ser uma conversa nova a cada vez, ou a mesma conversa de sempre — o que preserva o histórico e faz o agente lembrar do que já fez.

Precedência de reaproveitamento

Três possibilidades, nesta ordem:

  1. Conversa alvo explícita — reaproveita aquela conversa. É o caminho do agendamento criado de dentro do chat: o disparo volta para a conversa que o agendou.
  2. Reaproveitar a última — a conversa mais recente criada por aquele gatilho (não arquivada).
  3. Nenhum dos dois — conversa nova.

A diferença entre as opções 1 e 2 importa: a segunda amarra pelo próprio gatilho, então se o gatilho for apagado e recriado a cada execução, ela não serve — nesse caso é preciso a primeira.

O ganho escondido do reaproveitamento

Reaproveitar a conversa também reaproveita o ambiente de execução ligado a ela e, no motor de execução atual, retoma a sessão de trabalho de onde parou. Ou seja: além do histórico, ganha-se uma partida mais rápida, por reaproveitar o que já estava pronto em vez de recomeçar do zero.

Isolamento entre organizações

Reaproveitar uma conversa nunca cruza a fronteira de uma organização: a checagem de qual conversa pode ser reaproveitada é sempre restrita à organização do próprio disparo. Sem esse cuidado, um identificador de conversa de outra organização poderia, em tese, ser reaproveitado indevidamente.

Quando o agente já está ocupado

Ao reaproveitar uma conversa, o gatilho tenta reservar a conversa para si (de livre para em execução). Se não conseguir — porque ainda há trabalho rodando — o comportamento depende de uma configuração do próprio gatilho:

ConfiguraçãoResultado
Enfileirar quando ocupado (ligado)a mensagem é enfileirada e sai quando a execução atual terminar
Padrão (desligado)o disparo é pulado, com motivo "ocupado"

Por padrão, um disparo agendado que cai com o agente ocupado é perdido, não adiado. Enfileirar é uma escolha explícita, configurada por gatilho.

Isso é coerente com o desenho geral da fila de mensagens da conversa: enfileirar nunca é automático, é sempre uma escolha de quem chama.

Recuperação quando o disparo falha

Se o disparo falhar no meio do caminho, a conversa reaproveitada é liberada mesmo assim — caso contrário, ela ficaria presa em execução e todo disparo futuro para aquele gatilho seria pulado. Uma falha não tratada nesse ponto não quebraria só um disparo: quebraria todos os seguintes.

Onde fazer isso

  • Ver qual é a conversa de destino de um gatilho: pela tela do gatilho, ou por API.
  • Configurar o reaproveitamento (conversa alvo, reaproveitar a última, ou sempre nova) e a opção de enfileirar quando ocupado: nas próprias configurações do gatilho.

Etapa de resposta do assistente de gatilho, com o canal de retorno e a opção de continuar a mesma conversa a cada disparo em vez de começar do zero

On this page