Gatilhos e palavras-chave

Como configurar o gatilho de uma automacao — fonte (comentario, DM, story), tipo de match (exato vs contains) e palavras-chave positivas e negativas.

O gatilho define quando uma automacao aciona. Tres dimensoes controlam isso:

Trigger source — de onde vem o evento (comentario, DM, story).
Trigger type — como fazer match (exato ou contains).
Keywords — palavras positivas (aciona) e negativas (impede acionar).

Trigger source — de onde vem

comment — comentarios em posts (Instagram / Facebook).
dm — mensagens diretas recebidas.
both — qualquer um dos dois.

Use comment para automacoes de resposta a comentarios. Use dm para automacoes que reagem a DM com palavras-chave (util para FAQ instantaneo). Use both se a mesma palavra-chave deve responder em ambos os canais.

Story mentions e story replies (Instagram) sao eventos proprios — para cobri-los, ative applies_to_stories na secao de escopo da automacao. Veja Posts e Stories.

Trigger type — como fazer match

exact — a mensagem normalizada e igual a uma das palavras-chave. Ex.: keyword preco so aciona se a pessoa mandar exatamente "preco" (ou "Preço", "PRECO" — e case/acento insensitive).
contains — a mensagem contem pelo menos uma das palavras-chave. Ex.: keyword preco aciona para "Qual e o preco?", "preco do curso", "preco por favor".

contains e mais permissivo. exact e mais previsivel, util para reagir a palavras de comando especificas.

Keywords positivas

Lista de palavras que acionam a automacao. Sao OR: basta uma bater.

Boas praticas:

Use lowercase — o UltronChat normaliza antes de comparar.
Pense em variacoes — se voce espera "ebook", inclua tambem "e-book", "livro", "quero ler".
Considere erros de digitacao comuns — "whatapp", "watsap".
Evite palavras muito genericas — sim, legal, amei acionam em quase qualquer comentario e geram spam.

Exemplos:

Intencao	Keywords
Pedir link de ebook	`ebook`, `e-book`, `link`, `quero`, `quero o ebook`
Pedir preco	`preco`, `preço`, `valor`, `quanto custa`, `investimento`
Demonstrar interesse geral	`quero saber mais`, `me envia info`, `info`

Negative keywords

Lista de palavras que impedem o acionamento, mesmo se alguma positiva bater.

Uso tipico: voce tem uma automacao para "preco", mas nao quer que acione em "preco pago" (o usuario ja comprou, nao quer nova oferta):

Positivas: preco, valor
Negativas: paguei, ja comprei, pago

O match e simples: se qualquer negativa aparece na mensagem, a automacao e pulada.

Normalizacao

Antes de comparar, o UltronChat:

Converte para lowercase.
Remove acentos (preço vira preco).
Remove pontuacao extra.
Faz trim de espacos.

Isso significa que keyword preco cobre "Qual o preço?", "PRECO!!!", "preco", etc.

Exemplos de combinacao

Automacao "ebook gratuito"

trigger_source: comment
trigger_type: contains
keywords: [ebook, quero, link, livro]
negative_keywords: [pago, vendido]

Automacao "orcamento"

trigger_source: both
trigger_type: contains
keywords: [orcamento, orçamento, proposta, quanto, preco]
negative_keywords: [cancelar, desistir, ja paguei]

Automacao "comando exato para suporte"

trigger_source: dm
trigger_type: exact
keywords: [suporte, ajuda, bug]
negative_keywords: []

Conflitos entre automacoes

Se duas automacoes da mesma conexao batem no mesmo comentario (ex.: ambas usam ebook), apenas uma aciona — a primeira na ordem de avaliacao. Ordem nao e explicita na UI; para evitar ambiguidade, palavras-chave exclusivas por automacao.

Proximo passo

Posts e Stories — como limitar o escopo das automacoes a posts/stories especificos.