Respostas automáticas e FAQ | Documentação do Noxyr

Duas ferramentas para o mesmo problema

Uma resposta automática responde sozinha no momento em que uma mensagem bate com um gatilho - "como faço para pagar", "reembolso", "horário de funcionamento". Uma entrada de FAQ espera ser pesquisada: os membros usam /close faq e recebem as respostas correspondentes em particular.

Ambas pertencem ao módulo Tickets. Se esse módulo estiver desativado no servidor, nem as respostas automáticas nem a FAQ vão responder.

Gatilhos e modos de correspondência

Um gatilho é comparado com a mensagem inteira, em letras minúsculas, então a correspondência nunca diferencia maiúsculas de minúsculas. A primeira resposta automática que bater vence, e só uma resposta é enviada por mensagem.

Contém: Dispara quando o gatilho aparece em qualquer parte da mensagem. É o padrão e o mais abrangente - "pay" também bate com "payment" e "paypal".
Começa com: Dispara quando a mensagem começa com o gatilho. Bom para frases no estilo de comando, como "!price".
Exata: Dispara somente quando a mensagem inteira é o gatilho. A escolha mais segura para palavras curtas.

Onde uma resposta dispara

Cada resposta automática tem um escopo que decide quais canais ela observa.

Tickets: Somente dentro dos canais de ticket. É o padrão, e o recomendado para respostas de suporte.
Todos os canais: Todos os canais que o bot consegue ler.
Canais escolhidos: Somente os canais que você escolher.

Fora dos tickets, uma resposta automática dispara no máximo uma vez a cada 15 segundos por canal, para que um chat movimentado não consiga fazê-la gerar spam. Dentro dos tickets não há tempo de espera.

Marcadores

As respostas podem incluir marcadores que são preenchidos quando a resposta é enviada. Qualquer coisa que o bot não reconheça é mantida como foi digitada.

{user}: Menciona a pessoa que disparou a resposta.
{username}: O nome de usuário dela, sem ping.
{channel}: Menciona o canal. Somente respostas gerais.
{userId}: O ID de usuário do Discord dela. Somente respostas gerais.
{ticketId}: O ID do ticket. Somente respostas de ticket.
{server}: O nome do servidor.

Gerenciando respostas automáticas

As respostas automáticas são criadas e editadas no painel em Tickets → Respostas automáticas. Cada uma tem um nome, um gatilho, um modo de correspondência, uma resposta, um escopo e uma chave de ativação, então uma resposta sazonal pode ser pausada sem ser excluída.

O bot guarda a lista em cache por alguns segundos, então uma mudança salva pode levar até 15 segundos para valer. Mensagens de outros bots nunca disparam uma resposta automática, e a verificação anti-spam roda primeiro.

FAQ

As entradas da FAQ são pares de pergunta e resposta com palavras-chave opcionais. /close faq sem palavras de busca lista as entradas mais recentes; com palavras de busca, a busca compara a pergunta, a resposta e as palavras-chave, e mostra até oito resultados. Os resultados só ficam visíveis para quem perguntou.

/close faq: Pesquise na FAQ. Disponível para todos os membros.
/ticket faq-add: Adicione uma entrada com uma pergunta, uma resposta e palavras-chave separadas por vírgula.
/ticket faq-edit: Altere uma entrada existente. Use "none" como palavras-chave para limpá-las.
/ticket faq-remove: Remove uma entrada.
/ticket faq-list: Lista todas as entradas do servidor.

As respostas são exibidas com até 1,024 caracteres cada. As mesmas entradas podem ser gerenciadas no painel em Tickets → FAQs.