Discourse Intercom (Advanced)

AI-generated summary

Discourse Intercom is the official Intercom integration plugin for Discourse, implementing Intercom’s “Identity Verification” system. The plugin adds the Intercom Messenger to a Discourse site, displaying it for logged-in users and verifying their identity in Intercom via their email addresses.

To use the plugin, you’ll need to fill in the required settings (intercom_app_id and intercom_secret_key) and enable the plugin via the intercom_enabled site setting. You can obtain the necessary settings from Intercom’s website.

If your site has Content Security Policy enabled, you’ll need to whitelist the following URLs in the content security policy script src site setting:

  • https://widget.intercom.io/
  • https://js.intercomcdn.com/

For support, bug reports, or feature requests, please use the respective categories on Meta and tag your post with the intercom tag. You can also click on the links provided to get started.

:information_source: This plugin implements Intercom’s “Identity Verification” system. If you do not need this, a simpler theme component is available here.

:discourse2: Summary Discourse Intercom is the official Intercom integration plugin for Discourse.
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-intercom
:open_book: Install Guide How to install plugins in Discourse

Features

It will add the Intercom Messenger to your Discourse site in few easy steps. The messenger will be displayed for the logged-in users and their identity in Intercom is verified by their email addresses. Before enable this plugin (by intercom_enabled site setting), you should fill the other required settings intercom_app_id and intercom_secret_key. You can get it from the below URL

https://app.intercom.io/a/apps/{APP_ID}/settings/identity-verification/web

Content Security Policy

For security reasons, all scripts are now blocked if the Content Security Policy site setting is enabled. On hosted sites and new Discourse installs, this setting is enabled by default. It is necessary to whitelist the URLs in the site setting content security policy script src.

For Intercom add:

  • https://widget.intercom.io/
  • https://js.intercomcdn.com/

CHANGELOG

TODO

Last edited by @JammyDodger 2024-06-03T22:03:45Z

Check documentPerform check on document:
23 Likes