Configure Groupme provider with the discourse-chat-integration plugin

Wiki Administrators
,

AI-generated summary

This guide explains how to set up the Groupme provider using the discourse-chat-integration plugin.

  1. Install the plugin: If you haven’t already, install the discourse-chat-integration plugin.

  2. Set up a GroupMe Developer Account:

    • Log in to the Dev Portal, create a bot, and give it a name.
    • Leave the Callback URL blank and provide an uploaded image URL for your bot.
    • Note that you can set up multiple bots for multiple groups.

  3. Setup Discourse:

    • Go to your Discourse instance, filter your site settings by “Chat Plug”.
    • Use the Bot ID and Groupme group names in the corresponding fields, ensuring they’re in the same order if setting up multiple groups.
    • Set up rules for your channels, matching the GroupMe group name entered earlier.
    • If you want to send messages to every GroupMe group, enter “all” as the GroupMe Instance Name.

  4. Test the integration: Click the “Test” button on one of the channels to ensure everything is working correctly. You should receive a message in your GroupMe chat.

Please note that the integration does not include photos in messages, as GroupMe requires uploading photos to their servers and including the link in the message post.

1

This howto describes how to setup the Groupme provider included in discourse-chat-integration .

Install

If you haven’t already, install the discourse-chat-integration plugin

Notifications

Set up GroupMe Developer Account

The provider is configured to work the GroupMe bot API. In order to create a bot, you will need to log in to their Dev Portal

  1. Log in to the Developer portal, click Bots in the top menu, then click Create Bot

  2. Give your Bot a name

  3. Leave Callback URL Blank

  4. Provide an uploaded image URL for your Bot
    Note: The plugin allows you to set up integrations to as many separate groups as you’d like, so if you want to set up posts to go to multiple groups, create multiple bots here

You’ll see your Bot is now created and you should see both the Name you gave it and a Bot ID. You will use both of these in your Discourse Admin Setting for Groupme

discourse-groupme-tutorial-chat
discourse-groupme-tutorial-chat1192×370 74.5 KB

Setup Discourse

  1. Head over to your Discourse instance and filter your site settings Chat Plugin for groupme <your-site>/admin/site_settings/category/chat_integration?filter=groupme

  2. Check the chat integration groupme enabled option

  3. Use the Bot Id and Groupme group names in the corresponding fields.
    Note: if you are setting this up for multiple groupme groups, make sure that the bot IDs & groupme instance names are in the same order

discourse-groupme-integration-admin-setting
discourse-groupme-integration-admin-setting1796×692 85.7 KB

  1. Setup some “Rules” for your channels, according to the discourse-chat-integration instructions.

Note: Channel identifiers should match the GroupMe group name you entered in step 7.

Another Note: If you want to send the messages to every GroupMe group, enter “all” as the GroupMe Instance Name

  1. Click Test on one of the channels to check everything’s working. You should receive a message in your GroupMe chat

Also note that the integration does not including photos in the messages since GroupMe requires you to upload the photo to their servers and including the link in the message post. Figured the feature could survive as a first pass without it.

Enjoy!

1 Like
Administrators Index
Discourse Chat Integrations