Como Configurar Triggers do Agent Studio para Inícios em Tempo Real

Os Triggers do Agent Studio impulsionam a automação em tempo real e orientada a eventos para seus agentes de IA do HighLevel. Quando alguém envia um formulário, recebe uma tag ou envia um chat, o HighLevel registra o evento e inicia seu agente em segundo plano, mantendo as páginas e APIs rápidas enquanto seu agente responde instantaneamente. A arquitetura é construída para alto volume e testes seguros, permitindo que você implemente os triggers gradualmente sem interromper o tráfego ao vivo.

Este guia explica o que são os triggers, por que eles são importantes e como configurá-los rapidamente com dicas de melhores práticas.

SUMÁRIO

O que são os Triggers do Agent Studio?
Principais Benefícios dos Triggers do Agent Studio
Como Configurar os Triggers do Agent Studio
Tipos de Trigger
Trigger de Formulário Enviado
Trigger de Tag de Lead (Adicionada / Removida)
Trigger de Mensagem de Chat
Perguntas Frequentes
Artigos Relacionados

O que são os Triggers do Agent Studio?

Os Triggers do Agent Studio são listeners de eventos anexados ao nó Start de um agente que iniciam automaticamente o agente quando um evento de plataforma suportado ocorre. Ao reagir a ações reais do usuário, como enviar um formulário ou enviar um chat, os agentes podem engajar contatos imediatamente sem chamadas de API externas ou etapas manuais.

Atualmente, os Triggers do Agent Studio oferecem três eventos de entrada: Formulário enviado, Tag de Lead (adicionada ou removida) e Mensagem de chat. Quando um desses eventos é acionado, o agente inicia a partir do seu Start trigger e continua através do seu fluxo projetado.

Principais Benefícios dos Triggers do Agent Studio

Compreender as vantagens específicas ajuda você a decidir onde os triggers se encaixam em sua estratégia de automação e como substituir processos manuais ou com atraso de tempo.

Engajamento em tempo real: Responda aos leads no momento em que eles agem — enviam um formulário, enviam uma mensagem para sua empresa ou recebem uma tag.
Escalabilidade sem esforço: Elimine scripts de polling e webhooks personalizados; configure um trigger no produto e publique.
Ponto de entrada consistente: Padronize como os agentes iniciam para que os testes e a solução de problemas sejam mais fáceis.
Adoção sem interrupções: Os triggers são opcionais e aditivos; agentes existentes baseados em API continuam funcionando.
Base para o crescimento: O design orientado a eventos prepara o terreno para tipos de eventos adicionais ao longo do tempo.

Como Configurar os Triggers do Agent Studio

Siga estas etapas para criar uma configuração de trigger confiável, testável e pronta para produção, do início ao fim.

Pré-requisitos e Acesso:Confirme o acesso e o ambiente para que a configuração do seu trigger ocorra sem problemas e corresponda ao seu processo de implantação.

AcesseAI Agents → Agent Studiodentro da sub-account/localização correta.ConsulteComo Usar o AI Agent Studio no HighLevelpara navegação na tela, testes e ciclo de vida de publicação.

Abrir o Agent Studio

Na barra lateral esquerda, clique emAI Agents, depois selecione a abaAgent Studiono topo. Isso abre o espaço de trabalho onde você cria e gerencia agentes de IA para a localização atual.

Criar ou Abrir

Clique emCriar Agentepara construir um novo agente, ou selecione um nome de agente existente para editá-lo. A lista mostraStatus,Última AtualizaçãoeCriado Empara que você possa escolher o agente certo rapidamente.

Abrir Canvas

Dentro do agente, você verá o canvas do construtor com nós e um controle de adição. UseAdicionar Novo Nópra começar a construir ou localizar a área inicial do seu fluxo existente.

Adicionar Start Trigger

No seletor de nós, escolhaStart triggeremControle de Fluxo. Isso posiciona um tile de trigger que escuta por eventos para iniciar seu agente.

Tipos de Trigger

No painelSelecionar trigger, escolhaFormulário enviado,Tag de LeadouMensagem de chatpara definir o que inicia o agente. Sua escolha determina quais opções de configuração aparecerão em seguida.

Trigger de Formulário Enviado

Use isso quando quiser que um agente engaje imediatamente após um contato preencher um formulário rastreado pelo HighLevel, ideal para nutrição instantânea, qualificação ou roteamento. Ele:

Inicia o agente quando qualquer formulário selecionado é enviado.
Expõe os campos do formulário enviado como variáveis que seu agente pode referenciar em etapas posteriores.

Trigger de Tag de Lead (Adicionada / Removida)

Acione automações direcionadas quando uma tag é aplicada ou removida de um contato. Usos comuns incluem onboarding VIP, reengajamento ou prevenção de churn.

Inicia o agente quando uma tag selecionada éadicionadaouremovidade um contato.
Fornece o contexto do contato (incluindo tags existentes e campos personalizados) para o seu fluxo.

Trigger de Mensagem de Chat

Inicie seu agente no instante em que uma nova mensagem de entrada chega através de widgets/provedores de chat suportados; este trigger é ideal para respostas instantâneas, roteamento inteligente ou deflexão de FAQ.

Não requer configuração adicional, adicione o trigger e publique.
Fornece o texto da mensagem, detalhes do remetente e contexto da conversa para a lógica do seu fluxo.

Selecionar Formulários

Para o triggerFormulário enviado, use o dropdown para escolher um ou mais formulários, ou clique emAdicionar novose o formulário ainda não foi criado. O agente iniciará sempre que qualquer formulário selecionado for enviado.

Escolher Ação da Tag

ParaTag de Lead, definaAção da TagparaTag adicionadaouTag removida. Isso decide se o agente inicia quando uma tag é aplicada a um contato ou quando é removida.

Escolher Tag de Lead

Selecione a tag específica da lista, ou crie uma comAdicionar novo. O agente escuta apenas por mudanças nas tags que você selecionar aqui.

Ao adicionar tags em massa para testes, considere usar um pequeno segmento de teste primeiro para evitar acionar muitas execuções de agente de uma só vez.

Habilitar Trigger de Chat

ParaMensagem de chat, nenhuma configuração adicional é necessária. O agente iniciará automaticamente sempre que uma nova mensagem de entrada chegar através dos canais de chat conectados.

Se você rotear conversas do Ask AI para um agente, o chat pode iniciar o agente viaMensagem de chat. ConsulteIntegração Ask AI + Agent Studiopara detalhes de mapeamento.

Validar e Publicar

Testar: Execute uma simulação segura do trigger selecionado para ver exatamente quais variáveis e payload o agente recebe, nenhum contato ao vivo é afetado. Use isso para iterar rapidamente em prompts/nós e verificar o fluxo antes de publicar.
Salvar: Armazene suas alterações atuais como uma versão de Staging para não perder o trabalho e poder retornar mais tarde; nada é publicado ainda. Salvar é ideal após cada etapa de configuração (por exemplo, escolher formulários ou tags) para manter uma versão de trabalho limpa.
Publicar: Envie o agente atual e seu Start trigger para o ar para esta sub-account, para que eventos reais iniciem imediatamente o agente. Publique após testes bem-sucedidos, garantindo que o Start trigger esteja conectado ao primeiro nó; se o agente estiver mapeado para outros recursos (por exemplo, Ask AI), ele geralmente deve estar em Produção para ser selecionável.

Perguntas Frequentes

P: Os triggers alteram como meus agentes existentes invocados por API funcionam?

Não. Os triggers são aditivos. Seus fluxos de API existentes continuam funcionando; os triggers só são executados para agentes onde você adicionou um Start trigger.

P: Onde eu ligo os triggers?

Dentro do canvas de cada agente emAI Agents → Agent Studio. Adicione umStart trigger, configure-o,Teste, depoisPublique.

P: Posso testar antes de publicar?

Sim. Use a opçãoTestdo canvas para simular o evento e validar variáveis e respostas antes de publicar.

P: Quais fontes de chat são suportadas?

Os triggers funcionam com os widgets/provedores de chat existentes do HighLevel conectados à sua sub-account. Nenhuma configuração extra é necessária para iniciar.

P: Quais dados estão disponíveis para meu agente quando um trigger é acionado?

Envios de formulário incluem campos de formulário mapeados; eventos de Tag de Lead incluem contexto do contato; eventos de Mensagem de chat incluem texto da mensagem e metadados da conversa.

P: E se eu não vir meu formulário ou tag no dropdown?

Confirme se você está na sub-account/localização correta e se o ativo existe lá. Atualize o construtor após criar novos formulários/tags.