IC Thrive’s Source intranet software has a long history in the market. Developed over the past 2 decades, Source has provided a variety of integrations to increase the productivity of our customers. Active Directory synchronization, Exchange Web Services (calendar views), and TomTom mapping API are a few of the more widely utilized integrations Source provides.
When IC Thrive’s latest internal comms software tool, Reach, hit the market, we realized we had another opportunity for a useful integration, but this time, it was with our own product instead of a third-party.
Before diving into the nitty gritty of the integration between Source and Reach, let’s explore the Reach internal communications platform.
Reach is purpose-built internal communications technology that allows internal communicators to push targeted and mass communications to employees from one centralized location. It also facilitates two-way communication, with options to gather employee feedback with short surveys, Likert scales, and polls.
All that data, including open rates, click rates, and employee feedback are tracked in the software to help internal communicators better understand what messaging is working and what isn’t. Best of all? There are no apps to download or training required to use it—with Reach, you can send employee communications directly through the channels your employees are already using, like Slack, Microsoft Teams, email, and SMS.
There are many benefits to having our Reach and Source platforms integrate, but the main one is so that employee lists that live within the Source intranet can also be used in Reach. Similar to the Active Directory synchronization, where users and groups are imported from an Active Directory domain controller to Source, this integration allows us to synchronize users and groups/departments from Source to Reach.
The goals of integration though a Public API are:
Integrations between software platforms can be complicated, but we’ve broken down our process into three simple steps. Here’s how we successfully integrated our intranet platform with our internal communications software:
Application Programming Interfaces (APIs) are a ubiquitous commodity on the internet. They allow apps and services to communicate with each other regardless of the underlying technology those apps or services are based on. APIs are very often written in a way that makes them discoverable and consumable for those who want to utilize the API and they include methods for authenticating and authorizing requests.
The Reach public API currently provides four endpoints to sync users and lists. Note that the communication is unidirectional, so data flows only one way, from Source to Reach, through the Public API.
To configure Source to connect to the Reach Public API, four details from the Reach application were required. The first is the Reach tenant, or instance URL. The other three are related to the Reach Authority service, Auth0.
We retrieved these pieces of information from a special configuration screen available to Reach administrators.
When a Source administrator enters the Instance URL in their Reach integration setup screen and presses the “Connect” button, a new browser tab will open to the Reach instance where they will be prompted to log in to Reach to retrieve the Authority, Client ID, and Client Secret to complete the connection configuration. The administrator can copy the required values and enter them into the corresponding fields in the Source screen. They can then test the connection and choose to save the configuration when the connection is confirmed.
To avoid heavy traffic between the two applications, mass data synchronization of all users and lists is scheduled to happen once per day. However, some operations, like disabling a user or deleting a distribution list, happen in real time.
Interested in seeing for yourself how the integration between our Source intranet software and our Reach internal comms platform works? You’re invited to book a demo now! If you’re already a Source customer, contact our success team to learn more.
If you’d specifically like to see our Reach platform in action, we currently have a FREE 14-day free trial available. The software can be used with or without Source, and you’re welcome to give it a go, with no strings attached.