Personalizando o Discobot para o seu site

:bookmark: Este guia explica como personalizar o Discobot, o assistente embutido do Discourse, para melhor corresponder à personalidade e às necessidades da sua comunidade.

:person_raising_hand: 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.

:warning: 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:

  1. Vá para Admin > Users e selecione o usuário Discobot.
  2. 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”.

:bulb: 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:

  1. Vá para o perfil do Discobot (https://example.discourse.com/u/discobot/summary) e selecione “Messages”.

  2. Clique em “Sent”.

  3. Encontre uma mensagem de saudação que você deseja modificar.

  4. Copie uma parte única da mensagem, como “I’m only a robot”.

  5. Navegue até a Interface de Administração (https://example.discourse.com/admin)

  6. Vá para Appearance > Site Texts (https://example.discourse.com/admin/customize/site_texts)

  7. Cole o texto copiado na janela de pesquisa. Quando a mensagem de saudação aparecer, clique em “Edit”.

  8. Atualize a mensagem de saudação e clique em “Save Changes”.

:bulb: 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.

38 curtidas