Este guia explica como personalizar o Discobot, o assistente embutido do Discourse, para melhor corresponder à personalidade e às necessidades da sua comunidade.
Nível de usuário necessário: Administrador
O Discobot é um usuário especial na sua comunidade Discourse que ajuda os novos membros a aprender sobre a plataforma. Como administrador, você pode personalizar vários aspectos do Discobot para melhor se adequar ao estilo e aos requisitos da sua comunidade.
Configurando as configurações do site do Discobot
O comportamento do Discobot é controlado por várias configurações do site encontradas na categoria de configurações Plugins (procure por “narrative bot” em Admin > Settings). As principais configurações incluem:
discourse_narrative_bot_enabled: Ativa ou desativa o plugin Discobot inteiramente. Padrão:true.disable_discourse_narrative_bot_welcome_post: Quando ativado, impede que o Discobot envie uma mensagem de boas-vindas aos novos usuários. Padrão:true(a mensagem de boas-vindas está desativada em novas instalações).discourse_narrative_bot_welcome_post_type: Controla o tipo de mensagem de boas-vindas. As opções são “New user track” (inicia o tutorial interativo) ou “Welcome message” (envia uma mensagem de boas-vindas simples). Padrão:new_user_track.discourse_narrative_bot_welcome_post_delay: Número de segundos a esperar antes de enviar a mensagem de boas-vindas. Padrão:0.discourse_narrative_bot_ignored_usernames: Uma lista de nomes de usuário com os quais o Discobot não deve interagir. Padrão:discourse.discourse_narrative_bot_disable_public_replies: Quando ativado, impede que o Discobot responda em tópicos públicos. Padrão:false.
Em novas instalações, disable_discourse_narrative_bot_welcome_post é definido como true, o que significa que o Discobot não enviará mensagens automáticas aos novos usuários. Para ativar a mensagem de boas-vindas do Discobot, defina isso como false.
Modificando o perfil de usuário do Discobot
Para personalizar o perfil do Discobot:
- Vá para Admin > Users e selecione o usuário Discobot.
- Selecione “Preferences” ou clique em “Visit this user’s preferences page to edit their profile”:
Uma vez na seção Preferences, você pode modificar as seguintes configurações:
Configurações da conta
- Name: Clique no botão “Edit” para alterar o nome do Discobot.
- Image: Clique no botão “Edit” para carregar uma nova imagem de avatar.
- Após fazer as alterações, clique no botão “Save Changes”.
Se você alterar o nome do Discobot, lembre-se de atualizar também sua bio “About me” na seção Profile. A bio padrão refere-se ao Discobot por descrição em vez de nome de usuário, mas você pode querer revisá-la para garantir que ainda faça sentido com o novo nome.
Configurações do perfil
Personalize as informações do perfil do Discobot conforme necessário.
Configurações de e-mail
Ajuste as configurações relacionadas ao e-mail conforme necessário.
Atualizando a mensagem de boas-vindas do Discobot
Todo o texto do Discobot — incluindo a mensagem de boas-vindas, etapas do tutorial e outras respostas — pode ser personalizado via Appearance > Site Texts no painel de administração (/admin/customize/site_texts).
Para encontrar e editar uma mensagem específica:
-
Vá para o perfil do Discobot (
https://example.discourse.com/u/discobot/summary) e selecione “Messages”. -
Clique em “Sent”.
-
Encontre uma mensagem de saudação que você deseja modificar.
-
Copie uma parte única da mensagem, como “I’m only a robot”.
-
Navegue até a Interface de Administração (
https://example.discourse.com/admin) -
Vá para Appearance > Site Texts (
https://example.discourse.com/admin/customize/site_texts) -
Cole o texto copiado na janela de pesquisa. Quando a mensagem de saudação aparecer, clique em “Edit”.
-
Atualize a mensagem de saudação e clique em “Save Changes”.
Você também pode pesquisar por discourse_narrative_bot em Site Texts para navegar diretamente por todas as strings de texto personalizáveis do Discobot.
Limitações e informações adicionais
- Você pode reutilizar variáveis existentes nas mensagens (como
%{username}ou%{discobot_username}), mas não pode adicionar novas. - O Discobot deve permanecer como administrador; esse papel não pode ser removido.
- Você pode personalizar o conteúdo do corpo das etapas do tutorial, mas não pode adicionar, remover ou reordenar etapas.
Para necessidades de personalização adicionais ou solicitações de recursos, considere postar na categoria Contribute > Feature.
