Mobilize is an online community management tool that integrates with Novi to give your members a way to communicate and network with each other. To learn about the setup and implementation of the integration, read on below.

Before you begin, an important distinction to make is the terminology used in Novi and Mobilize.

In Mobilize, you'll first setup your overall Community. This will encompass all of your Mobilize Groups, that are synced with and composed of members from your Novi Groups.

***

Step 1: Initial Setup & Connection

To begin, you'll first want to create your Enterprise level Mobilize account. At this point, you'll be able to add basic details to the account - such as your community name, logo, etc.

Once that's been created, you're ready to move on to connecting your Mobilize with Novi.

To connect Mobilize with Novi...

First, in Mobilize:

  1. Navigate to your Community Settings by clicking your community name in the top left.
  2. In the navigation bar, select Authentication.
  3. In the navigation bar, select Integrations.
  4. Click Create API Key.
  5. Your API Key and API Secret will now appear. Important - Save these somewhere safe! Once you click save, you won't see these again, just that they exist.
  6. Give your API key a description - something like "(Association)-Novi Connection."
  7. Click Save and exit.

Then, in Novi:

  1. Navigate to Association Settings by clicking your name in the top right corner of the backend/admin side.
  2. In the Integrations tab, copy/paste your Mobilize API Key and API Secret into the appropriate sections.
  3. Before saving, click Test Connection to Mobilize button to ensure you've entered the correct information.
  4. Once the connection is verified, save your changes.

At this point, the two systems are now connected! Next, you'll want to create groups in Mobilize that you will then connect to your Novi groups.

***

Step 2: Single Sign-On Setup

Finally, you'll want to complete the settings to enable Single Sign-On between the two systems. You're going to want your members to be able to login to Mobilize with their Novi login so that the system can recognize they're connected from a Novi group.

First, in Novi:

  1. Navigate to SSO Clients by clicking your name in the top right corner of the backend/admin side.
  2. Click the Add SSO Client button
  3. Name the SSO client (perhaps just, Mobilize)
  4. In the Valid Redirect Urls section, enter the following (replacing my_community with your community's name): https://my_community.mobilize.io/users/auth/openidconnect/callback 
  5. Save the SSO client. Once it has saved, click on it in the list to re-open the modal.

Then, in Mobilize:

  1. Navigate to your Community Settings by clicking your community name in the top left.
  2. In the navigation bar, select Authentication.
  3. Click the arrow next to OpenID Configuration to open the dropdown.
  4. Toggle the On/Off button next to the arrow to ON.
  5. Now, you'll want to fill in the following information being asked and save:
  • Directory Document: The full URL of your Novi website (https://www.websiteurl.com - no slash on the end). Note: If this is being setup on your staging site, this will need to be updated to your live website's URL after launch.
  • Mobilize App ID: The "Client Id" in your Novi SSO settings modal
  • Mobilize App Secret: The "Secret Key" in your Novi SSO settings modal
  • Button Label Text: What the login button should be labeled for users who will be logging in to Mobilize.

***

Step 3: Create Groups in Mobilize

Before syncing Novi groups into Mobilize, you'll want to create the Mobilize group to match it to.

To do this, start by selecting the ( + ) next to Groups in the main Mobilize navigation bar.

On Screen 1 (See below):

  1. Name your group
  2. Select your Parent Group. Any groups that will be synced with Novi MUST be a "top-level" group, therefore having a parent group of None. However, if you're creating a sub-group that will not be connected to Novi, you may select a parent.
  3. The group email address will populate based on the group name.
  4. Click Next.

On Screen 2 (See below):

  1. Set your group permissions. Groups synced with Novi MUST be set to Private. This ensures that the Novi group will control the members of the Mobilize group.
  2. For groups synced with Novi, uncheck "Joining the group requires managers approval." Since this is a private group, this is not needed.
  3. Update "Who can post on this group?" to Members and group managers. This will allow your members to participate in the group.
  4. Click Create Group.

All groups connected to Novi should follow this pattern so the sync does not override additional Mobilize self-added group members. However, keep in mind that you can create groups that aren't synced to Novi that people can join on their own. That's when you'd use the "Closed" visibility setting and select "Joining the group requires manager approval."

Important Mobilize Group Notes:

Please note that each Mobilize group has configurable settings that we recommend you review. 

For example, you may want to give each of your groups a logo and specify who your admin managers are. We also highly recommend turning off "Events" for your Mobilize groups, as this is in no way connected to your Novi events, which may confuse members.

You can also adjust group email settings, such as how often members are notified of posts/comments/changes within the group, what the subject line of the notification email is, or the "From" address - which is something you can work with your IT Contact on.

Additionally, please note that a "Registration Form" is not needed if your group will be synced with Novi. You'll only need to configure this if creating a Closed sub-group that is not connected to Novi.

***

Step 4: Sync Novi Groups to Your Mobilize Groups

Once you're connected and ready to tell Mobilize which members you'd like in which groups, navigate to your Groups section inside of Novi.

In Novi, you'll want to create a group(s) for each different community that include the individuals you'd like to be in that community. Each Mobilize community can be connected to one Novi group.

Note: If Mobilize is being setup on your staging website prior to launch, the sync will not run unless a Novi admin updates a setting for you.

Syncing Your Novi Group

Once your Novi group is set up, head to its Details tab and simply find the Mobilize section here:

In the dropdown, select the appropriate Mobilize Group and save your Novi Group. This will automatically begin syncing the group members' information to Mobilize.

How Group Syncs Work

To be synced to Mobilize, a record must meet two criteria:

  1. It must be an individual's record, not a company.
  2. The individual must have a Novi login/user account already created.

We send the following information about individuals in Novi groups to Mobilize: 

  • First Name
  • Last Name
  • Email
  • Company Name
  • Job Title

As long as an individual is in your synced Novi group and they have a Novi login/user account, they will be in your connected Mobilize group. 

If someone is added or removed to/from the Novi group, the same will happen in the Mobilize group. Keep in mind, any manually added Mobilize group members will be overwritten the next time the Novi group syncs to Mobilize.

You'll be able to see the status of the Mobilize sync in Novi in a column on both the main groups list and within the Members tab of a specific group. As the group is syncing you'll see the spinner that indicates the changes being made within the column. 

Successfully synced members will show an "Up To Date" message (below). If a record was not synced because it did not meet the criteria above, its status will appear as N/A. 

Please note: Unlinking the Mobilize group from the Novi group will not remove all members of the group in Mobilize, it will simply unlink the two systems from speaking to each other. This means that the members would remain in the Mobilize group, unless you manually removed them in Mobilize. If you need to remove members, you'll want to be sure to do so through the Novi group's conditions.

***

For more information and questions specifically on Mobilize, visit the Mobilize Help Center or, for questions on the integration, Contact Us.

Did this answer your question?