Интеграция чата Discourse

[Discourse]

Chat Integration is for using an external chat system together with Discourse — you may be looking for Discourse Chat which adds Chat functionality directly to Discourse.

	Summary
	Install Guide

As this is an official plugin maintained by the Discourse team, Support, Contribute > Bug, Contribute > UX, and Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started.

Support Bug UX Feature

The Discourse Chat Integration plugin lets you send messages in your preferred chat platform when something happens in Discourse.

Messages can be triggered by:

• New topics
• New replies
• Messages to a group
• Mentions of a group

Functionality by provider

Provider	Notifications	Slash Commands	Post Transcripts	Threaded Replies
Slack
Telegram
Discord
Mattermost
Google Chat
Matrix (element.io)
Zulip
Rocket.Chat
Gitter
Stride	Docs
Microsoft Teams
Basecamp	Docs
IRC Cloud	Docs
Flock	Docs
Webex

Before you enabling Slash Commands for your provider, make sure to read the Security/Permissions section below!

Configuration

There are three key concepts in this plugin:

• Providers: The chat platform that you’re connecting to (e.g., Slack, Discord, etc.).
• Channels: A single chat area in your platform (e.g., channel, group chat, room, etc.). Each provider can have multiple channels.
• Rules: The instructions for when and how Discourse should send a message to a channel. Each channel can contain multiple rules.

Configuring providers

1. Go to Admin > Installed Plugins and ensure that the Chat Integrations plugin is enabled.
2. Click Settings.
3. Choose the chat platform that you’d like to connect to Discourse.

4. For some providers (e.g., Discord), you’ll be directed straight to the next step (channel configuration). Others will ask for special information, which you’ll need to get from your chat platform.

Dedicated setup instructions for chat platforms

• Slack: Set up Slack notifications using the discourse-chat-integration plugin
• Discord: https://meta.discourse.org/t/discord-chat-integration-discord-notifications/171136
• Microsoft Teams: Set up Microsoft Teams notifications using the discourse-chat-integration plugin
• Telegram: Set up Telegram integration using the discourse-chat-integration plugin
• Google Chat: Set up Google Chat notifications using the discourse-chat-integration plugin
• Matrix: Set up Matrix (element.io) notifications using the discourse-chat-integration plugin
• Zulip: Set up Zulip notifications using the chat integration plugin
• Mattermost: Set up Mattermost notifications using the discourse-chat-integration plugin
• Gitter: Set up Gitter notifications using the discourse-chat-integration plugin
• Rocket.Chat: Set up Rocket Chat notifications using the discourse-chat-integration plugin
• GroupMe: Configure Groupme provider with the discourse-chat-integration plugin
• Webex Teams: Set up Webex notifications using the discourse-chat-integration plugin

Configuring channels

Once you have configured a provider, you can now configure channels for that provider. From the Chat Integration plugin page, click Add channel and provide the requested information — typically a webhook URL and/or channel name, depending on the provider.

Configuring rules

After your channel is connected, you can click Create rule to create a new rule for when your community should send a message to your provider channel.

The main components of a rule are:

• Type: What type of community content should trigger a chat message?
  • Normal: Send chats for topics in the selected category.
  • Group message: Send chats when a PM is sent to the selected group.
  • Group mention: Send chats when the selected group is mentioned.
• Filter: You can optionally filter the rule so that it only sends chats in certain situations.
  • All posts with threaded replies: Send chats for all posts matching this rule, with replies threaded in the chat platform. This option is not available for all integrations.
  • All posts and replies: Send chats for all posts and replies that match this rule.
  • First post only: Only send chats for the first post in a topic or message that matches this rule.
  • Tag added to topic: When the create post for category and tag changes site setting is enabled, send a chat when someone adds adds a tag to a topic.
  • Mute: Do not send chats that match this rule. This is useful for carving out an exception to another broader rule.
• Group: If you selected Group message or Group mention as the Type, select the group whose received PMs / mentions should trigger the chat.
• Category: If you selected Normal as the Type, optionally select the category that a topic must be posted in to trigger the chat.
• Tags: Optionally select one or more tags that matching topics must have at least one of to trigger the chat message.

What happens when there are multiple rules?

Rules are sorted first by type then by the filter:

1. Group mentions
   1. Mute
   2. All posts and replies
   3. First post only
2. Group messages
   1. Mute
   2. All posts and replies
   3. First post only
3. Normal (i.e. topics)
   1. Mute
   2. All posts and replies
   3. First post only

If a post matches multiple rules, the plugin will trigger the first matching rule in the list.

For example, with the following rules

Filter	Category	Tags
All posts and replies	Mentions of: @team	(all tags)
Mute	Support	(all tags)
First post only	Support	unsupported-install
All posts and replies	(all categories)	(all tags)

Notifications would be triggered for:

• A post in Customization > Plugin
• A post in Support mentioning @team

…but not for:

• A post in Support
• A post in Support with tag unsupported-install

Security / Permissions

By default the system account is used, which means that there is no restriction on notifications sent.

To secure your notifications, you should create a non-staff user with appropriate access privileges, and enter its username in the chat integration discourse username setting.

If you have Slash Commands enabled for your provider, and do not trust every member of the external Channel, it is absolutely essential that you set this up to avoid them having access to private categories on your forum.

Slash Commands

If your provider supports slash commands, you can manage rules from within your chat interface. Each provider varies slightly in syntax, but in general they follow a similar structure. (Note that at this time, only the Slack integration implements threads.)

The commands available are

New rule: /discourse [thread|watch|follow|mute] [category] [tag:name]
(you must specify a rule type and at least one category or tag)

• thread – notify this channel for new topics, thread replies if possible
• watch – notify this channel for new topics and new replies
• follow – notify this channel for new topics
• mute – block notifications to this channel

Remove rule: /discourse remove [rule number]
([rule number] can be found by running /discourse status)

List rules: /discourse status

Help: /discourse help

Posting a transcript

If your provider supports transcript posting, you can post your instant messaging history to discourse. This is currently only supported for the Slack provider. Note: You will need to be using the “Access Token” method of connecting to Slack.

Send /discourse post to see the interface. The plugin will try and “guess” where your current conversation starts, by looking for a gap in the message history of more than 3 minutes.

Alternatively, you can specify a number of posts after the command, or a URL to the first message.

To load a transcript for a Slack thread, you can use /discourse post thread {url}, where {url} is the permalink of the first message in the thread. For example:

/discourse post thread https://<slackname>.slack.com/archives/C6029G78F/p1522952993000017

Alternatively, you can use /discourse post with a thread-specific permalink like this:

/discourse post https://foo.slack.com/archives/G49KKS6AX/p1523062012000911?thread_ts=1523091738.000088&cid=G49KKS6AC

In both cases the “first/last message” UI is skipped - the entire thread is included in the transcript.

Adding new providers

Option 1: Submit a PR implementing your provider:

Add a new provider to discourse-chat-integration

discourse-chat-integration abstracts away the boilerplate for integrating Discourse with external chatroom systems. There are three features which a provider implementation can support: Notifications, Slash Commands and Transcripts. There are two ways you can add a provider: in your own plugin, or by submitting a pull request to discourse-chat-integration. This post will detail the latter, but most of the information will work in either scenario. This post gives a general overview of how thing…

Option 2: Use your own plugin:
It is possible for third party plugins to register new “providers”. As an example, I’ve created a provider which sends webhooks to IFTTT. This could be used to automatically publish all posts in a category to facebook… or turn on your light when someone posts in Contribute > Feature… or feed your fish whenever there’s a new Customization > Plugin.

CHANGELOG

TODO

Last edited by @lindsey 2026-04-21T21:14:15Z

Check document

Perform check on document:

[sunjam (james.network)]

It would be interesting to add support for Discourse’s own ActivityPub Plugin so that publishing could be triggered based on tags and other filters from chat integration.

[Aizada_M]

Hello, last year Telegram announced forums/topics (mini chats within group chats). I tried to connect each individual mini chat to one or another category of my site. But as I understand, topic addresses are not supported by the plugin? For example, in my case, each topic has an address as follows: @telegram_topic /1, @telegram_topic /2, @telegram_topic /3 …
If I insert a standard chat name into the line, for example @telegram_chat, it works without problems.
It would be very convenient if the plugin had the ability to insert similar chat addresses (…/1), then users would not have to be subscribers to many independent channels tied to certain categories of the site.

[sunjam (james.network)]

@Aizada_M

then users would not have to be subscribers to many independent channels tied to certain categories of the site.

Have you considered using tags to accomplish this?

[Aizada_M]

I think using tags is not entirely suitable for my case. Because even with the help of tags, I wouldn’t want all notifications to go into one channel, creating information noise. At the same time, instead of having 20 channels for 20 categories/tags, I would prefer to have one group chat where I could organize several mini-themed chats (by category/tag) where each user can view the one they need minichat and the ability to look into other minichat. I’m so bothered because in my region (Asia) most people use WhatsApp and Telegram chats - forums are not popular. But I’m trying to find a compromise).

Ps. If I repeat myself often, don’t judge me, I’m just trying to convey my thoughts correctly, as I use Google translator.

[sunjam (james.network)]

@Aizada_M

I wouldn’t want all notifications to go into one channel, creating information noise.

You should be able to filter which tags would apply to which chats, at least as far as I am understanding you.

[Aizada_M]

@sunjam

You should be able to filter which tags would apply to which chats, at least as far as I am understanding you.

It seems to me that we are talking about different things I don’t have a question about filtering chats by tags/categories.
For context. Previously, Telegram had channels and chats (except for bots). These channels/chat rooms have a username, approximately @chat_username or @channel_username.
Since last year, Telegram has had the opportunity to turn chats into forums containing mini thematic chats like this. These mini chats have their own usernames, for example @chat_username /1, @chat_username /2. The convenience of such chats with minichat is that the user no longer needs to subscribe to several chats separate from each other, but just subscribe to one chat (for example, with the name of my site) and have access to many mini chats (in my case, each mini chat would target a specific category on the site) that are of interest to the user.
Now I want to connect these mini chats to this plugin, but it seems to me that the plugin does not support the mini chat username as chat_username /1.

[atwong (Albert Wong)]

Is there a way to create a rule where I can tag a new message and/or reply so it won’t post to target chat system (in this case Slack)?

[david (David Taylor)]

Привет, Альберт! Если речь идёт о обычных тегах Discourse, вы можете настроить фильтр ‘mute’, чтобы темы с этим тегом не вызывали уведомления в Slack.

Однако, если речь идёт об отдельных сообщениях, отфильтровать их невозможно.

[ErlendMS (Erlend Markussen Saltnes)]

Я думаю, у меня такое же желание, как у тебя, Аида:

Мне бы очень хотелось иметь чат в Telegram с включённой функцией тем (которые в некоторой степени соответствуют категориям на Discourse), а затем в настройках интеграции Discourse/Chat указать, в какую тему он должен публиковать сообщения.

Я попытался создать чат с темами прямо сейчас (только с ботом и мной), но когда я ввожу /help внутри темы, бот отвечает в общем чате.

Ты изучал это, @david? Я нашёл эту тему на Stack Overflow, где показано, как получить message_thread_id (что является идентификатором темы), и указано, что API бота получил поддержку этого в версии 6.3.

Спасибо за твою работу в любом случае!

[david (David Taylor)]

Привет @ErlendMS . На данный момент у нас нет в плане улучшений для этого плагина, но если кто-то захочет добавить поддержку «потоков» (также называемых темами) для интеграции с Telegram, это, скорее всего, будет приветствоваться как pr-welcome.

У нас уже есть некоторая поддержка потоков в интеграции со Slack, поэтому, вероятно, можно будет переиспользовать часть этой логики.

[PeakProsperity (Aaron McKeon)]

Возможно ли использовать этот плагин для получения уведомлений в Slack, когда пост помечается на проверку? Спасибо.

[BrainFried]

Расширяет ли этот плагин набор функций API?

[crossheadscrewdriver]

Где я могу запросить ревью PR? Я отправил этот PR на прошлой неделе, чтобы добавить нового провайдера, но он всё ещё ожидает ревьюера. Я просмотрел различные руководства для разработчиков на сайте Meta, но не нашёл информации о правильном порядке запроса ревью PR.

Вот мой PR: FEATURE: Added Power Automate as a new provider by benoitdesnoyers · Pull Request #204 · discourse/discourse-chat-integration · GitHub

Спасибо,

[gabriel (Gabriel Grubba)]

Всем привет! Мы только что объединили этот PR для плагина интеграции чата.

Это изменение направлено на удаление опции tags_changed из фильтрации правил в интеграции чата — мы делаем это, потому что удаляем настройку «Создание небольшого поста действия при изменении категории или тегов темы».

Однако функциональность останется той же, если у вас установлен Discourse Automation. В следующий раз, когда вы запустите миграции для этого плагина, будет добавлен скрипт в плагин Discourse Automation, который будет работать аналогично текущему.

Вот пример автоматизации, которая будет создана:

Сообщение будет отправлено в мой канал на основе категорий и отслеживаемых тегов, которые я выбрал.

${ADDED_AND_REMOVED} — это текст по умолчанию; он будет работать так же, как и правило.

Мы также добавили для этого скрипта несколько опций, которые можно использовать в сообщении:

• ${TOPIC} — название темы
• ${REMOVED_TAGS} — удалённые теги
• ${ADDED_TAGS} — добавленные теги

События удаления и добавления сработают только в том случае, если в них есть хотя бы один тег.
Например: сообщение added: ${ADDED_TAGS} сработает только если есть добавленные теги.

[gabriel (Gabriel Grubba)]

У нас возникла проблема с другим PR (пользователи, использующие других провайдеров, не могли использовать автоматизацию при изменении тегов темы), поэтому для её решения мы создали новый PR, в котором учитываем каждого провайдера.

Настройка Создание небольшого поста-действия при изменении категории или тегов темы не будет отображаться в интеграции чата.

Если у вас установлен плагин discourse automation, то при следующем запуске миграций для этого плагина к плагину автоматизации Discourse будет добавлен скрипт, который будет работать аналогично текущей реализации.

---

Ваши автоматизации будут выглядеть примерно так:

В качестве провайдеров используются провайдеры со статусом enabled (включены).

Например, у меня включены Discord, Slack, Telegram и Google Chat.

Ваш channel name — это имя, которое вы указали в настройках интеграции чата.

Например, здесь имя — Spidey.

[gabriel (Gabriel Grubba)]

У нас есть новая порция изменений для Автоматизации/интеграции с чатом

В этой новой порции notable изменения:

• Мы добавили «Запуск при личных сообщениях», что позволяет вам контролировать, должна ли эта автоматизация запускаться даже при личных сообщениях.
• Исправлена проблема, при которой автоматизация с триггером «Изменены теги темы» запускалась во время создания темы.

[gabriel (Gabriel Grubba)]

Как уже упоминалось ранее – здесь

Текущая настройка сайта «Создавать посты при изменении категорий и тегов» может приводить к утечке приватных тегов и категорий; одним из способов сохранения этой функции стало перенесение её в whispers:

Она работает аналогично небольшим постам, но теперь необходимо указать в настройке whisper allowed groups хотя бы одну группу, чтобы функция работала.

Я объединил PR для ядра с этим изменением, а также PR для плагина chat-integration, удалив использование указанной настройки; добавленная обратно функция автоматизации должна быть полностью эквивалентна действию «small action». Если у кого-то возникнут проблемы, пожалуйста, дайте нам знать!

[gabriel (Gabriel Grubba)]

У меня есть ещё несколько обновлений для этого плагина

Мы добавили поле trigger on для автоматизации «Отправить сообщение интеграции чата».

Что это делает?

Оно проверяет, когда теги:

• Добавлены и удалены (по умолчанию)
• Добавлены
• Удалены

В настоящее время эта проверка является инклюзивной.

Хороший пример: если я установлю значение Добавлены, то для запуска этой автоматизации необходимо, чтобы к теме был добавлен любой тег.

Когда установлено Теги добавлены, таблица автоматизации выглядит так:

Добавлен тег к теме	Удалён тег из темы	Запускалась ли автоматизация?

Когда установлено Теги удалены, таблица автоматизации выглядит так:

Удалён тег из темы	Добавлен тег к теме	Запускалась ли автоматизация?

[wodeche]

Тема: Невозможно получить доступ к разделу «Плагины» для настройки интеграции чата

Здравствуйте,

Я являюсь администратором форума LXDAO и пытаюсь настроить плагин интеграции чата Discourse для подключения к Telegram. Согласно официальной документации, я должен иметь возможность настроить это в разделе «Плагины» панели администратора.

Однако в моей панели администратора у меня есть доступ только к четырем разделам: Общие, Модерация, Безопасность и Отчеты. Раздел «Плагины», упомянутый в документации, apparently недоступен.

Не могли бы вы помочь мне понять:

1. Установлен ли плагин интеграции чата на нашем форуме?
2. Нужны ли мне дополнительные права для доступа к разделу «Плагины»?
3. Если мы используем размещенное решение Discourse, существуют ли какие-либо ограничения на установку/настройку плагинов?

Как администратору, какие шаги мне следует предпринять для правильной настройки интеграции Telegram для нашего сообщества?

Спасибо за вашу помощь!