Forj is an online community management tool that integrates with Novi to give members a way to communicate and network with each other. To learn about the setup and implementation of the integration, read on below.
Before beginning, an important distinction to make is the terminology used in Novi and Forj.
In Forj, an overall Community if first set up, which encompasses all Forj Groups that are synced with and composed of members from Novi Groups.
Step 1: Initial Setup & Connection
To begin, create an Enterprise-level Forj account and add basic details to the account - such as community name, logo, etc.
To connect Forj with Novi...
First, in Forj:
Navigate to Community Settings by clicking the community name in the top left.
In the navigation bar, select Authentication.
In the navigation bar, select Integrations.
Click Create API Key.
An API Key and API Secret will now appear.
Important: Save these somewhere safe! Once saved, the API Key and API Secret will not be displayed again.
Give the API key a description - something like "(Association)-Novi Connection."
Click Save and exit.
Then, in Novi:
Navigate to Association Settings by clicking the gear icon in the top right corner of the backend/admin side.
In the Integrations tab, copy/paste the Forj API Key and API Secret into the appropriate sections.
Before saving, click Test Connection to Forj button to ensure the correct information was entered.
Once the connection is verified, save changes.
At this point, the two systems are now connected! Next, create groups in Forj that will then connect to Novi groups.
Step 2: Single Sign-On Setup
Complete the settings to enable Single Sign-On between the two systems, allowing members to be able to log in to Forj with their Novi login so that the system can recognize they're connected from a Novi group.
First, in Novi:
Use the article below to set up the Single Sign-On:
Points to consider:
When naming the SSO client, perhaps call it Forj
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
Save the SSO client. Once it has saved, click on it in the list to re-open the modal.
Then, in Forj:
Navigate to Community Settings by clicking the community name in the top left.
In the navigation bar, select Authentication.
Click the arrow next to OpenID Configuration to open the dropdown.
Toggle the On/Off button next to the arrow to ON.
Fill in the following information being asked and then save:
Directory Document: The full URL of your Novi website (https://www.websiteurl.com - no slash on the end).
Note: If this is being set up on a staging site, this will need to be updated to the live website's URL after launch.
Forj App ID: The "Client ID" in the Novi SSO settings modal
Forj App Secret: The "Secret Key" in the Novi SSO settings modal
OIDC Client Authentication Method: Post Body must be selected
Button Label Text: What the login button should be labeled for users who will be logging in to Forj.
Step 3: Create Groups in Forj
Before syncing Novi groups into Forj, create the Forj group to match it to.
To do this, start by selecting the ( + ) next to Groups in the main Forj navigation bar.
On Screen 1 (See below):
Name the group
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 creating a sub-group that will not be connected to Novi, select a parent.
The group email address will populate based on the group name.
Click Next.
On Screen 2 (See below):
Set group permissions. Groups synced with Novi MUST be set to Private. This ensures that the Novi group will control the members of the Forj group.
For groups synced with Novi, uncheck "Joining the group requires managers approval." Since this is a private group, this is not needed.
Update "Who can post on this group?" to Members and group managers. This will allow members to participate in the group.
Click Create Group.
All groups connected to Novi should follow this pattern so the sync does not override additional Forj self-added group members.
However, keep in mind that admins can create groups that aren't synced to Novi that people can join on their own. In those instances, use the "Closed" visibility setting and select "Joining the group requires manager approval."
Important Forj Group Notes:
Please note that each Forj 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 Forj 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 Forj Groups
Once connected and ready to tell Forj which members should be in which groups, navigate to your Groups section inside of Novi.
In Novi, create a group(s) for each different community that includes the individuals to be in that community. Each Forj community can be connected to one Novi group.
Note: If Forj is being set up on your staging website prior to launch, the sync will not run unless a Novi admin updates a setting for you.
Syncing A Novi Group
Once a Novi group is set up, head to its Details tab and find the Forj section here:
In the dropdown, select the appropriate Forj Group and save your Novi Group. This will automatically begin syncing the group members' information to Forj.
How Group Syncs Work
To be synced to Forj, a record must meet two criteria:
It must be an individual's record, not a company.
The individual must have a Novi login/user account already created.
Novi sends the following information about individuals in Novi groups to Forj:
First Name
Last Name
Email
Company Name
Job Title
As long as an individual is in a synced Novi group and they have a Novi login/user account, they will be in a connected Forj group.
If someone is added or removed to/from the Novi group, the same will happen in the Forj group. Keep in mind, any manually added Forj group members will be overwritten the next time the Novi group syncs to Forj.
See the status of the Forj 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, a spinner indicates 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 Forj group from the Novi group will not remove all members of the group in Forj, it will simply unlink the two systems from speaking to each other.
This means that the members would remain in the Forj group unless until manually removed in Forj. To remove members, be sure to do so through the Novi group's conditions.
For more information and questions specifically on Forj, visit the Forj Help Center or, for questions on the integration, Contact Us.