Criando uma automação de auto-resposta

:bookmark: Este guia explica como configurar um respondedor automático usando o Plugin de Automação no Discourse. O respondedor automático pode responder automaticamente a posts ou mensagens pessoais que contenham palavras-chave específicas.

:person_raising_hand: Nível de usuário necessário: Administrador

Um respondedor automático no Discourse pode responder automaticamente a posts que contenham certas palavras-chave ou frases. Esse recurso pode ajudar moderadores e administradores a se concentrarem em tarefas mais complexas, automatizando respostas a consultas ou situações comuns.

Resumo

Este guia aborda:

  • Criar um novo script de respondedor automático
  • Escolher e configurar um gatilho
  • Configurar pares de palavra/resposta
  • Habilitar a automação

Criando um novo script

  1. Navegue até a página de automação do seu site em example.discourse.com/admin/plugins/automation
  2. Clique em + Criar para criar um novo script
  3. Selecione a opção Respondedor Automático
  4. Clique em + Criar novamente para prosseguir

Escolhendo um gatilho

Selecione uma das duas opções de gatilho:

  1. Post Criado / Editado
  2. Mensagem Pessoal Criada

Opções de gatilho Post Criado / Editado

  • Tipo de Ação: Limitar a posts sendo criados ou editados
  • Tipo de Tópico: Limitar a todos os tópicos, apenas tópicos públicos ou apenas mensagens pessoais
  • Categorias: Limitar a categorias específicas
  • Excluir subcategorias: Acionar apenas se o tópico estiver exatamente nas categorias especificadas (não em suas subcategorias)
  • Tags: Limitar a posts em tópicos com tags específicas
  • Grupos Restritos: Limitar a posts de usuários em grupos específicos
  • Grupos Excluídos: Ignorar se o usuário do post pertencer a qualquer um desses grupos
  • Grupos de Caixas de Entrada Restritas: Limitar a mensagens pessoais em caixas de entrada de grupos específicos
  • Ignorar Automatizados: Ignorar se o remetente tiver um e-mail noreply ou for de uma fonte automatizada (aplica-se apenas a posts criados via e-mail)
  • Níveis de Confiança Válidos: Limitar a posts de usuários com níveis de confiança específicos
  • Apenas Post Original: Acionar apenas no post original (OP) de um tópico
  • Apenas Primeiro Post: Limitar ao primeiro post de um usuário
  • Apenas Primeiro Tópico: Limitar ao primeiro tópico de um usuário
  • Ignorar via E-mail: Ignorar o gatilho se o post foi criado via e-mail
  • Recursos do Post: Limitar a posts contendo recursos específicos (imagens, links, código ou uploads)

Opções de gatilho Mensagem Pessoal Criada

  • Usuários: Limitar a MPs enviadas para usuários específicos
  • Grupo: Limitar a MPs enviadas para um grupo específico
  • Ignorar Equipe: Ignorar se o remetente for um usuário da equipe
  • Ignorar Automatizados: Ignorar se o remetente tiver um e-mail noreply ou for de uma fonte automatizada (aplica-se apenas a MPs criadas via e-mail)
  • Ignorar Membros do Grupo: Ignorar se o remetente for membro do grupo especificado
  • Níveis de Confiança Válidos: Limitar a MPs de usuários com níveis de confiança específicos

Configurando as opções do script

Após configurar o gatilho, configure as seguintes opções:

  1. Pares de Palavra / Resposta: Defina palavras-chave e respostas correspondentes
  2. Usuário de Resposta: Selecione a conta de usuário para respostas automatizadas (padrão é o usuário Sistema)
  3. Caixa de seleção Uma vez: Limitar a automação para acionar apenas uma vez por tópico

Configurando pares de palavra/resposta

  1. Clique no botão Configurar ao lado de lista de pares de palavra / resposta
  2. Insira pares de chave/valor:
    • Chave: A palavra ou frase gatilho (não diferencia maiúsculas de minúsculas)
    • Valor: O texto da resposta automatizada

:information_source: A chave é avaliada como uma string de expressão regular com correspondência de limites de palavra. Escape caracteres especiais como . com uma barra invertida (por exemplo, \\.). Você pode testar suas expressões regulares em regex101.com usando o flavor Ruby.

:mega: Use %%KEY%% no campo valor como um placeholder para a palavra gatilho detectada. Você também pode usar %%SENDER_USERNAME%% como um placeholder para o nome de usuário do usuário que responde.

:bulb: Se vários pares de palavra/resposta corresponderem ao mesmo post, todas as respostas correspondentes são combinadas em uma única resposta (separadas por linhas em branco).

Habilitando a automação

  1. Marque a caixa de seleção Habilitado na parte inferior da tela
  2. Clique em Atualizar para salvar suas alterações

:warning: As automações podem ser salvas sem serem habilitadas deixando a caixa de seleção Habilitado desmarcada.

9 curtidas

É possível limitar a resposta automática à postagem inicial de um tópico? Pode-se pensar que Once faria isso, mas (em óbvia retrospectiva) isso só está correto se o tópico for criado depois da automação.

1 curtida

Alternativamente (ou adicionalmente?), o post automático poderia ser datado para vir imediatamente após o OP do tópico (e então mesclado nessa ordem)?

1 curtida

Meu caso de uso: responder a tópicos em uma determinada categoria com uma nova enquete para esse tópico.

1 curtida

Então… você tem uma categoria de discussões antigas e, quando alguém responde lá, você recebe uma resposta automática que não é útil, mas contém informações úteis em resposta à criação de um tópico… correto? :smiley:

Se for esse o caso, infelizmente, não acho que essa automação suporte esse comportamento atualmente. Executei as outras automações e acho que a única que poderia funcionar seria a triagem com IA, mas isso parece caro para obter os resultados que você procura. :sweat_smile:

3 curtidas

Sim, correto. Quão difícil seria criar uma nova opção para esta onde ela responderia apenas a novos tópicos?

1 curtida

4 posts foram divididos em um novo tópico: O auto-responder pode ser acionado em @menções?

Um post foi dividido em um novo tópico: Post Created / Edited Trigger for Send PMs Automation

Existem outras variáveis de template disponíveis na resposta? Gostaria de poder acessar o nome de usuário da pessoa que enviou uma mensagem privada para um grupo.

Atualmente, usar %%KEY%% no campo value como um espaço reservado para a palavra-chave detectada é a única variável de modelo disponível para nós na automação do respondedor automático.

Não parece haver uma variável integrada para acessar o nome de usuário da pessoa que enviou uma mensagem privada para um grupo na automação do respondedor automático. Esta é uma limitação na implementação atual, pois outros recursos do Discourse (como modelos de e-mail, personas de IA e o script de automação “Enviar Mensagens Privadas”) possuem várias variáveis relacionadas ao usuário disponíveis.

Com isso em mente, isso é semelhante a alguns outros pedidos que tivemos para este tipo de recurso.

  1. Um pedido para adicionar variáveis para nomes reais de usuários ao script “Enviar Mensagens Privadas”
  2. Um pedido de recurso para variáveis de resposta rápida para destinatários de mensagens diretas

Se este é um recurso no qual você está interessado, eu o encorajaria a criar um tópico Feature, com mais informações sobre que tipo de variáveis de modelo você gostaria de ver adicionadas a esta automação. Quanto mais pessoas demonstrarem interesse em um recurso, maior a probabilidade de ele ser incluído no Discourse. Esta parece ser uma ideia interessante e adoraríamos saber mais sobre o que você está procurando. :slightly_smiling_face:

2 curtidas

É possível usar um curinga para acionar uma resposta para qualquer tópico que não atenda a nenhum dos pares de chaves que você criar?

Além disso, se várias palavras-chave forem mencionadas no mesmo tópico, como a resposta é escolhida?
Alfabeticamente ou de cima para baixo?

Olá @tknospdr,

A detecção de gatilho do respondedor automático foi projetada para responder a padrões regex específicos que você define em seus pares de chave/valor. Não há um recurso explícito para um “catch-all” que seria acionado quando nenhum outro par de chaves corresponder.

No entanto, como as chaves são avaliadas como strings regex, você pode criar um padrão regex muito amplo como sua última entrada que corresponderia a quase qualquer conteúdo. Algo como .* funcionaria como um regex de “catch-all”, embora isso corresponda a tudo (incluindo conteúdo que corresponde aos seus outros padrões).

Quando várias palavras-chave são encontradas em uma postagem ou tópico, o respondedor automático responderá com TODAS as respostas correspondentes. As respostas serão postadas na mesma ordem em que os pares de chave/valor foram adicionados ou listados na configuração.

Isso significa que, se sua postagem contiver palavras-chave que correspondam a vários padrões, você receberá várias respostas automatizadas na sequência em que aparecem em sua lista de pares de palavras/respostas.

1 curtida

Ah, isso não é bom. Isso é para o nosso sistema de tickets e eu odiaria enviar spam a um cliente com 2 ou 3 respostas de e-mail diferentes quando eles solicitam ajuda.

Seria incrível se houvesse uma configuração para:
:white_check_mark: Combinar várias correspondências de pares chave/valor em uma única resposta.

Até lá, voltarei ao caso de uso original e colocarei o .* e usarei uma resposta genérica unificada. Exceto que, em seguida, precisaria disparar apenas se {user} não postou em {category} por {x} dias.