External Event Trigger

O node External Event Trigger inicia um workflow a partir de um evento externo.

Ele define o ponto de entrada do workflow. A tela Triggers cria o vínculo operacional com a fonte do evento.

Como funciona

Implante (deploy) um workflow contendo um node External Event Trigger. O deploy cria um workflow trigger para esse ponto de entrada.

Crie um trigger externo na tela Triggers. Selecione a conexão, o evento, filtros opcionais e o workflow trigger como seu destino.

Quando o evento externo chega, o Endless encontra um trigger ativo compatível. Em seguida, ele envia o payload do evento para o workflow implantado.

Configurar um workflow trigger

Adicione o ponto de entrada

Adicione um node External Event Trigger ao workflow.

Use um ponto de entrada para cada caminho de evento externo.

Implante o workflow

Implante o workflow para criar seu workflow trigger.

O workflow trigger identifica o ponto de entrada implantado.

Crie o trigger externo

Abra Triggers e crie um trigger.

Selecione a conexão externa, o evento e o destino. Escolha o workflow trigger a partir do workflow implantado.

Evento suportado

Atualmente, o Endless suporta este evento externo:

Fonte: Instagram
Evento: Novo comentário

Você pode aplicar um filtro de post usando seu mediaId. Deixe o filtro vazio para corresponder a comentários de todos os posts da conexão selecionada.

Destinos do trigger

Um trigger externo pode executar um Agente, Squad ou Workflow.

Para um destino de workflow, selecione o workflow trigger criado pelo ponto de entrada implantado. O Endless injeta o evento recebido como um evento externo nesse node.

Para destinos de Agente e Squad, você pode fornecer um prompt opcional.

Fluxo de execução

O Instagram envia um webhook de novo comentário.
O Endless normaliza o evento e identifica sua conexão e ID de evento.
O Endless localiza triggers ativos que correspondam à conexão, ao evento e ao filtro.
O Endless executa o destino configurado.

Cada execução cria uma execution com origem de trigger externo. Isso garante rastreabilidade do evento e do destino.

Regras e limitações

A conexão selecionada deve estar ativa e suportar Instagram.
Triggers duplicados não podem compartilhar a mesma conexão, evento e filtros.
O Endless processa cada trigger e evento externo apenas uma vez.
Reimplante o workflow após alterar seus pontos de entrada.

Ao reimplantar, o Endless recria os workflow triggers. Os destinos de workflow existentes são atualizados quando seu ponto de entrada ainda existe. Se um ponto de entrada for removido, os triggers vinculados ficam inativos.

Teste o ponto de entrada

O node mostra os triggers vinculados ao seu ponto de entrada. Quando existem vários triggers, selecione um antes de testar.

A ação de teste gera um payload de exemplo de comentário do Instagram. Use-o para validar a lógica do workflow antes de receber eventos reais.