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…
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ção | Onde |
|---|---|
| Ver serviços e tipos de evento disponíveis para gatilho | Painel e API do agente |
| Configurar o webhook no provedor | Painel do agente |
| Criar, editar, ligar, desligar e remover um gatilho de aplicativo | Painel e API do agente |
| Ver a conversa de destino do gatilho | Painel do agente |
| Operar tudo isso de dentro de um agente | Ferramenta de gestão de gatilhos |
Agendamentos: os três tipos de gatilho
O agente pode executar sozinho, na hora marcada. Três formatos, com semânticas bem diferentes — e escolher errado é o engano mais comum do módulo.
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.