Triggers e eventos disponíveis na SiteUp

Triggers são os gatilhos que iniciam a avaliação de uma regra. Toda automação precisa de um momento exato para ser checada, e esse momento é definido pelo evento escolhido na hora de criar a regra. Conhecer o catálogo real de eventos disponíveis é essencial para construir automações precisas e evitar disparos desnecessários.

Como o motor de eventos funciona

Sempre que algo relevante acontece dentro da SiteUp — uma nova conversa entra, uma mensagem chega, um atendente resolve um atendimento — a plataforma publica um evento interno. Esse evento é entregue ao motor de regras, que carrega as automações ativas configuradas para aquele gatilho e avalia, uma a uma, se as condições estão satisfeitas. Apenas as regras com condições verdadeiras têm suas ações executadas.

O processamento é assíncrono e roda em fila de alta prioridade. Para a maioria dos eventos, a regra dispara em poucos segundos após o gatilho original.

Catálogo de eventos suportados

A SiteUp suporta cinco eventos como gatilho de regra. Esse conjunto cobre os momentos mais relevantes do ciclo de vida de uma conversa.

Conversa criada

Atributo	Descrição
Identificador interno	`conversation_created`
Quando dispara	Imediatamente após uma nova conversa ser registrada
Frequência	Uma vez por conversa
Caso de uso	Saudação automática, distribuição inicial, atribuição de equipe

Conversa atualizada

Atributo	Descrição
Identificador interno	`conversation_updated`
Quando dispara	Mudança em status, prioridade, atendente, equipe ou atributos
Frequência	Pode disparar várias vezes ao longo da conversa
Caso de uso	Notificar supervisor quando prioridade muda, sincronizar atributos via webhook

Conversa aberta

Atributo	Descrição
Identificador interno	`conversation_opened`
Quando dispara	Conversa volta para o estado aberta após pausa, resolução ou pendência
Frequência	Quantas vezes a conversa for reaberta
Caso de uso	Reativar fluxos, registrar reabertura para fins de SLA

Conversa resolvida

Atributo	Descrição
Identificador interno	`conversation_resolved`
Quando dispara	Atendente, automação ou macro marca a conversa como resolvida
Frequência	Cada vez que muda para resolvida
Caso de uso	Disparar pesquisa de satisfação, mover card final no Kanban, enviar transcrição

Mensagem recebida

Atributo	Descrição
Identificador interno	`message_created`
Quando dispara	Nova mensagem registrada na conversa
Frequência	A cada mensagem
Caso de uso	Roteamento por palavra-chave, etiquetagem, resposta automática fora de horário

Observação: mensagens enviadas por automação ou marcadas como atividade interna são ignoradas automaticamente pelo motor para evitar laços. Você não precisa adicionar condições defensivas para esse caso.

Combinando triggers com condições

Um mesmo evento pode servir dezenas de regras. O segredo é refinar com condições específicas.

Aviso fora do horário comercial

Trigger: conversation_created
Condições: caixa de entrada é WhatsApp E horário fora do expediente
Ações: enviar mensagem automática informando o horário de retorno + aplicar etiqueta aviso-fora-de-horario

Roteamento por palavra-chave

Trigger: message_created
Condições: conteúdo contém fatura, boleto, cobrança E etiqueta financeiro não está presente
Ações: aplicar etiqueta financeiro + atribuir à equipe responsável

A condição negativa evita reaplicação em mensagens subsequentes da mesma conversa.

Eventos únicos versus recorrentes

Compreender a frequência de cada evento ajuda a desenhar automações estáveis.

Comportamento	Evento típico	Cuidado
Único por conversa	`conversation_created`	Não há risco de duplicação
Recorrente	`message_created`, `conversation_updated`	Use condições negativas para limitar
Repetível por reabertura	`conversation_opened`, `conversation_resolved`	Decida se a ação roda toda vez ou só na primeira

Eventos não cobertos diretamente

Alguns acontecimentos não são gatilhos próprios, mas podem ser tratados de outras formas:

Etiqueta adicionada ou removida, mudança de prioridade ou atendente: trate como conversation_updated.
Movimento no Kanban: use as automações de etapa do funil, configuradas nos próprios quadros.
Eventos externos (webhooks de entrada): transforme em mensagem ou em atualização de conversa.
Tempo decorrido sem resposta: use o módulo de SLA para alertas baseados em tempo.

Próximos passos

Para refinar quando uma regra deve disparar, leia Condições avançadas.
Se uma regra parou de funcionar, consulte Monitoramento e debug.
Para acionar fluxos manualmente em vez de por evento, veja Macros.