Criando links de mensagem pessoal pré-preenchidos

[Discourse]

Este guia descreve como criar um link para iniciar uma nova mensagem pessoal com informações pré-preenchidas, incluindo as melhores práticas.

Nível de usuário exigido: Todos os usuários

O Discourse permite que você componha uma nova mensagem pessoal com informações pré-preenchidas por meio de parâmetros de URL. Isso pode economizar tempo e garantir consistência para mensagens comuns.

Estrutura da URL

Para criar uma nova mensagem pré-preenchida, formate sua URL assim:

https://discourse.example.com/new-message?username=techapj&title=message%20title&body=message%20body

Quando detalhados, os parâmetros da URL incluem:

• URL Base: https://discourse.example.com/new-message
• Nome de Usuário: username=techapj
• Título: title=message%20title
• Corpo: body=message%20body
• O operador de URL ? para adicionar as diferentes opções

Você pode testar isso em try.discourse.org:

https://try.discourse.org/new-message?username=rudy&title=message%20title&body=message%20body

Você também pode compor uma mensagem pré-preenchida para um grupo via URL:

https://meta.discourse.org/new-message?groupname=team&title=topic%20title&body=topic%20body

Observe o parâmetro groupname na URL acima; isso significa que você deseja criar uma nova mensagem pré-preenchida para um grupo (em oposição a username para compor uma mensagem para um usuário). Você também pode usar group_name como alternativa para groupname.

Tags

Você pode pré-preencher tags em uma mensagem pessoal adicionando o parâmetro tags:

https://discourse.example.com/new-message?username=techapj&title=Bug%20Report&body=Details&tags=tag1,tag2

Isso requer que a configuração do site pm_tags_allowed_for_groups inclua os grupos aos quais o usuário pertence. Se a marcação de MP não estiver habilitada para o usuário, o parâmetro tags será silenciosamente ignorado.

Melhores práticas

• Você pode enviar mensagens para vários usuários separando os nomes de usuário por vírgula. Por exemplo

  https://meta.discourse.org/new-message?username=foo,bar
  

• Você não precisa preencher todos os parâmetros. Por exemplo, qualquer um dos seguintes funcionaria:

  https://meta.discourse.org/new-message
  https://meta.discourse.org/new-message?username=
  https://meta.discourse.org/new-message?title=foo&body=bar
  https://meta.discourse.org/new-message?groupname=
  

• Você pode adicionar espaços de linha usando os códigos %0A e %0A%0D para dar alguma estrutura ao corpo da mensagem:

  https://yoursite.discourse.org/new-message?username=test_user&title=Bug%20Report&body=Please%20include%20all%20relevant%20details.%0A%0DCPU:%0AMemory:%0A%0DDescribe%20Issue:
  

• Se você tiver DiscourseConnect (SSO), poderá vincular a example.com/session/sso e, em seguida, definir o caminho de retorno para criar a mensagem pessoal. Se o usuário já estiver logado, ele será redirecionado automaticamente para a URL fornecida pelo caminho de retorno. Se ele não estiver logado, será direcionado para a página de login do DiscourseConnect e, em seguida, redirecionado para a URL do caminho de retorno. O caminho de retorno precisará ser codificado em URL.

  href="http://localhost:3000/session/sso?return_path=http%3A%2F%2Flocalhost%3A3000%2Fnew-message%3Fusername%3Dscossar%26title%3DInformation+requested+about+gentle+yoga+classes">
  

Atualmente não suportado

• Usar a URL pré-preenchida para compor uma mensagem para vários grupos.
• Usar a URL pré-preenchida para abrir o compositor na página de resumo de um usuário.
• Usar e-mail em vez do nome de usuário para pré-preencher uma mensagem pessoal.

Recursos adicionais

• Compor um novo tópico pré-preenchido via URL

[putty (Derek Putnam)]

As tags também podem ser atribuídas com isso? Tentei imitar a implementação de tags daqui, mas não tive sorte.

Creating a link to start a new topic with pre-filled information

This documentation explains how to create a link that starts a new topic in Discourse with pre-filled information. Required user level: All users Sometimes you may want to provide users with a link that opens a new topic composer with certain information pre-filled. This can be useful for various use cases including bug report templates, feature requests, or standardized posts. Constructing the URL Base URL To compose a new pre-filled topic with no extra i…

[pfaffman (Jay Pfaffman)]

Tenho quase certeza de que é o mesmo código. Qual URL você tentou? Você pode substituir o nome do host por meta.discourse.org se precisar (apenas não crie o tópico de verdade!)

Você tem certeza de que usou algo como tags=email,planned e que as tags existem e podem ser aplicadas pelo usuário que estava tentando usar o link?

[putty (Derek Putnam)]

Aqui está o URL que eu estava usando:

https://developer.sailpoint.com/discuss/new-message?groupname=community_managers&title=Livestream%20Presentation%20Submission&tags=livestream&body=I%20would%20like%20to%20present%20a%20livestream%21%20Here%20is%20an%20overview%20of%20my%20presentation%3A%0A%0ATopic%3A%20%5B%5Binsert%20topic%20here%5D%5D%0ADescription%3A%20%5B%5Binsert%20description%20here%5D%5D

Você levanta um ponto válido sobre permissões com tags, no entanto. O PM pode ser criado com a tag oculta?

[pfaffman (Jay Pfaffman)]

@putty

É possível criar a Mensagem Privada (PM) com a tag oculta?

O usuário pode criar a PM com as tags desejadas normalmente pela interface do usuário (UX)? (Dica: Não da maneira como você configurou.) A URL é apenas uma forma de iniciar o que o usuário pode fazer na UX. Ela não tem poderes mágicos.

Existe uma configuração do site que habilita tags para PMs. Não, um usuário não pode criar uma tag que ele não tenha permissão para ver.

[putty (Derek Putnam)]

Confirmei que:

• As tags são acessíveis para todos:
  

  
  
  

• Também me passei por outra pessoa e consegui selecionar a tag em uma nova MP

[jrgong]

É de alguma forma possível incluir (no corpo da MP) o URL atual em que o usuário está? Gostaríamos de adicionar alguns links de MP em nossos tópicos para um grupo fechado de usuários, para que eles possam enviar mensagens à nossa equipe referenciando um tópico específico.