# Gitter integration for Discourse

**URL:** <https://meta.discourse.org/t/gitter-integration-for-discourse/65881>\
**Category:** Development\
**Created:** [7월 9, 2017, 7:51오전 UTC](https://meta.discourse.org/t/gitter-integration-for-discourse/65881 "2017-07-09T07:51:29Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![jafeth.diazc](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jafeth.diazc/32/101197_2.png) [@jafeth.diazc](https://meta.discourse.org/u/jafeth.diazc)\
**Post date:** [7월 9, 2017, 7:51오전 UTC](https://meta.discourse.org/t/gitter-integration-for-discourse/65881/1 "2017-07-09T07:51:29Z")

</div>

Hi all!

I have been working on a Gitter integration for Discourse as an alternative service to the [Slack plugin](https://meta.discourse.org/t/the-official-discourse-slack-plugin/51412) and I’d like to share the current state of it.

It’s necessary to [create a custom integration](https://gitter.zendesk.com/hc/en-us/articles/200176722-Integrations) in each room in which we want Discourse notifications. Once created, go to `/admin/plugins/gitter` to register a new integration with the room name (e.g. gitterhq/meta) and the integration webhook url.

As you can see below, the admin interface is pretty similar to the Slack plugin’s, allowing to create filter rules specifying a category and some tags(optional). The main difference is that the filter rules are grouped by room.

 ![](https://global.discourse-cdn.com/meta/original/3X/e/9/e92a3dd494428586738549ccebc011d39e63e708.png)

Then, when a new post is created it will be notified in the corresponding Gitter rooms’ activity feed. The notifications follow a simple structure (`username` - `topic title` - `category`) due to the size of the activity feed. In addition, the whole notification text will be a link to the post in Discourse.

 ![](https://global.discourse-cdn.com/meta/original/3X/0/0/00ce7bdd6f4b6a68b29dea8442116a423265914a.jpg)

Here is the [repo](https://github.com/JafethDC/discourse-chat-gitter).

### To do

- Create a PR to the [Gitter services library](https://github.com/gitterHQ/services). This will allow us to have an official Discourse integration in Gitter (and stop using a “custom” one) and to perform some customization to the notifications, like setting an icon.
- Slash commands to manage filter rules from a Gitter room.

In addition, I consider important to mention that the idea is that, in the near future, this plugin makes use of the common event system @david is working on.

Finally, I’m more than happy to receive feedback 🙂

---

_[View the full topic](https://meta.discourse.org/t/gitter-integration-for-discourse/65881)._