Discourse Slackdoor Plugin

[mcwumbly (Dave McClure)]

DEPRECATION NOTICE

This plugin is now deprecated.

There is no plan to maintain or enhance it.

---

As of August 17, 2019, it still works but with limitations.

In particular:

1. It doesn’t unfurl messages that don’t start with the link (this was always the case).
2. It does not really do what one would expect in threads; the message is “unfurled” in the main channel.

In addition, outgoing webhooks are no longer recommended by Slack. They recommend creating a Slack App for this kind of integration now.

You may find this plugin useful as is, despite these limitations, but doing so comes with the above limitations and the risks that come with using software that is no longer maintained.

It is unclear whether there is any existing alternative to this plugin, so there is likely an opportunity for someone else to make something that solves this problem in a better way.

---

The discourse-slackdoor plugin allows Slack to unfurl links to your private Discourse instance.

Usage

When you post a message that starts with a link to a post or a topic in your private Discourse instance, a bot will post a message that contains the unfurled content as a reply.

Setup

1. Configure an outgoing webhook on your Slack instance.
2. Install and configure the discourse-slackdoor plugin.

Configure an Outgoing Webhook in Slack

Set the following values for your outgoing webhook:

• Channels: All
• Trigger Word(s): <https://forum.example.com/t/
• URL: https://forum.example.com/slackdoor/knock
• Token: (autogenerated, but copy value to add to your plugin settings)

You can also choose a name and icon for the bot’s posts.

Install and Configure Discourse-Slackdoor Plugin

1. Install the plugin using this how to guide.
2. Go to the Site Settings for your Discourse instance and type slackdoor into the filter to show the settings for the plugin.
   • enabled
   • token
   • username

The token should be set to the value that is generated by Slack when you create the webhook.

The username should be a user that can see topics you want to be able to share to Slack (but not topics that you don’t want to share).

Issues or Questions?

Please post any issues or questions in this topic.

[mcwumbly (Dave McClure)]

A compatibility issue with this plugin was introduced in Discourse commit eaf87f07701b70903dcc88a7235371a00cc61083.

If you are on that version or newer of Discourse, you should update this plugin.

Discourse is creating their own officially supported Slack plugin and this is a feature on their todo list, so hopefully in the not-too-distant future this plugin will become obsolete

[mikehc (Miguel Hurtado)]

このプラグインの状況はどうなっていますか？まだ機能していますか？公式の Slack プラグイン（廃止済み）とその代替プラグインを確認しましたが、Discourse のプライベートインスタンスでの URL のアンファーリングを可能にする点が焦点ではないようです。

[codinghorror (Jeff Atwood)]

@mcwumbly さん、これはまだ役立ちますか、それとも完全に時代遅れですか？

[mcwumbly (Dave McClure)]

このプラグインは現在、廃止されました。

私はこれを維持または強化する予定はありません。

---

制限付きではあるものの、まだ動作します。

特に以下の点に注意してください：

1. リンクで始まらないメッセージの展開（unfurl）は行われません（これは以前から同様です）。
2. スレッド内では期待通りに動作しません。メッセージはメインチャンネルで「展開」されます。

さらに、Slack は現在、アウトゴーイング Webhook の使用を推奨していません。このような統合には、Slack アプリの作成を推奨しています。

最近まで、これらのリスクを承知でこのプラグインを使用していましたが、最近、混乱を招く方が多いとの判断から、アンインストールすることを決めました。

現時点では、プライベートな Discourse インスタンス向けにメッセージを展開する機能を提供する他の既存の統合は存在しないため、上記の制限やメンテナンスが停止しているソフトウェアを使用することに伴うリスクを承知の上で、引き続きこのプラグインを利用する方もいるかもしれません。

この問題をより良い方法で解決する製品を作成する機会が、他の誰かにはあるでしょう。

---

README および上記の OP/Wiki は、これに合わせて更新されました。