VolundOS

Gatilhos de aplicativo (evento externo)

Além de horário, um gatilho pode disparar a partir de algo que aconteceu num serviço conectado: e-mail novo, arquivo criado, mensagem recebida. A organização escolhe o serviço…

Atualizado em 12 de agosto de 2026

Gatilhos de aplicativo (evento externo)

Camada funcional

Além de horário, um gatilho pode disparar a partir de algo que aconteceu num serviço conectado: e-mail novo, arquivo criado, mensagem recebida. A organização escolhe o serviço, o tipo de evento e a mensagem que o agente recebe quando ele acontece.

O catálogo de eventos é vivo

Os serviços que oferecem gatilho e os tipos de evento de cada um vêm do motor de integrações, não de uma lista fixa da plataforma — o mesmo desenho usado no catálogo de serviços conectáveis. Consequência prática: evento novo de um serviço já conectado passa a estar disponível sem esperar uma atualização da plataforma.

Entrega repetida não roda o agente duas vezes

Provedores de webhook reenviam a mesma entrega quando não recebem confirmação a tempo — isso é comportamento normal do lado deles, não falha. A plataforma reconhece a entrega repetida e não roda o agente de novo para ela.

Isso é diferente de eventos genuinamente distintos sobre o mesmo item, que podem chegar em sequência rápida — por exemplo, uma criação seguida de uma remoção do mesmo arquivo. Esses são dois acontecimentos reais, e os dois chegam ao agente; a plataforma não os trata como repetição um do outro.

Quando o próprio evento não carrega nenhuma forma de identificar de qual item ele fala, a plataforma não tenta adivinhar: prefere processar um evento a mais do que arriscar descartar um aviso legítimo que se repete de propósito.

Um episódio real

Já houve um caso de entrega duplicada num canal de mensagens: a mesma notificação de um gatilho chegou multiplicada no chat, mesmo com a interface mostrando só uma mensagem final. O caso foi identificado e corrigido.

O que dá para fazer

AçãoOnde
Ver serviços e tipos de evento disponíveis para gatilhoPainel e API do agente
Configurar o webhook no provedorPainel do agente
Criar, editar, ligar, desligar e remover um gatilho de aplicativoPainel e API do agente
Ver a conversa de destino do gatilhoPainel do agente
Operar tudo isso de dentro de um agenteFerramenta de gestão de gatilhos

On this page