The Ringover + Carerix ATS integration allows you to connect your Carerix environment to Ringover using OAuth2 authentication. In this guide, you'll learn how to retrieve your API credentials from Carerix, activate the integration in Ringover, and complete the initial setup.
Prerequisites
- An active Ringover Business account or higher.
- Administrative permissions in your Carerix environment.
- Permission to create and manage OAuth2 clients in Carerix.
1. Retrieve your API credentials in Carerix
To connect Carerix to Ringover, you first need to retrieve three authentication credentials from your Carerix administration interface.
- Log in to your Carerix environment using an administrator account.
- Navigate to Maintenance > Identity & Access.
Retrieve your OpenID Configuration URL
- Click on the Clients tab
- Click on the OpenID Configuration button. A new tab will open.
3. Copy the URL displayed in your browser's address bar.
The URL should look similar to this:
https://id-s2.carerix.io/auth/realms/partner4/.well-known/openid-configuration
This is the URL you need to provide in the OpenID Configuration URL field in Ringover.
Retrieve your Client ID and Client Secret
- Go back to your OAuth2 client details in Carerix.
- Click New and Select "Confidential"
3. Enter the following details when requesting a new client:
- Name: Ringover
- Code: ur:carerix/ringover
- Default scopes: select "urn:cx/cx5Wrapper:data:manage"
- Optional scopes: leave blank
- Active: yes
4. Close this window and collect your Client Secret and Client ID.
2. Activate Carerix in Ringover
Once you have retrieved all three credentials, enter them in Ringover to activate the integration.
- Log in to your Ringover Dashboard.
- Go to Store > Integrations.
- Search for Carerix in the integrations list and click on it.
- Fill in the three required fields using the credentials retrieved from Carerix:
- OpenID Configuration URL: Paste the URL copied from your browser after clicking OpenID Configuration.
- Client ID: Enter your Carerix OAuth2 Client ID.
- Client Secret: Enter your Carerix OAuth2 Client Secret.
- Click Activate to complete the connection.
3. Configure your Carerix integration settings
Once the integration is activated, you can configure how Ringover interacts with your Carerix environment. These settings allow you to manage call logging, recordings, user associations and contact synchronization.
In the Ringover Dashboard, open your Carerix integration to access the available configuration options.
- Call types: Select Manage call types to choose which incoming, outgoing, missed and voicemail calls are logged in Carerix.
- Include recordings in call logs: Choose which available audio files are included in Carerix call activities (e.g., "All files").
- Restrict access to recordings: Limit recording access to users with an active Ringover license.
- Phone numbers: Select the Ringover numbers whose calls are sent to Carerix.
- SMS messaging numbers: Select the Ringover numbers whose SMS messages are logged in Carerix.
- Group SMS conversations by: Select the time interval used to group SMS messages into a single activity (e.g., "Day (24 hr)").
- Link users with an account: Select Manage users to match each Ringover user with their Carerix account, so activities are attributed to the right person.
- Assign missed IVR calls to: Select the Carerix user who receives missed calls that were not answered in an IVR scenario.
- Log internal calls: Choose whether calls between Ringover users are also logged.
- Include Empower summaries and transcripts in call logs: Add available AI-generated summaries and transcript links to Carerix call activities.
- Log Empower meeting summaries: Log the AI-generated summaries of your Empower meetings in Carerix.
- Log Empower meeting summaries as: Choose the Carerix activity type used to log meeting summaries (e.g., "Notes").
- Include scenario name in call logs (for incoming IVR calls): Include the Ringover IVR scenario name in incoming call activities.
- Logs display language: Select the language used for automatically generated activity text.
- Log calls as: Choose the Carerix activity type used to log calls (e.g., "Note").
- Log SMS messages as: Choose the Carerix activity type used to log SMS messages (e.g., "Note").
- Log WhatsApp messages: Enable supported WhatsApp activity logging.
- Log WhatsApp messages as: Choose the Carerix activity type used to log WhatsApp messages (e.g., "Note").
- Group WhatsApp conversations by: Choose how WhatsApp messages are grouped in Carerix (e.g., "Day (24 hr)").
- Create contact for calls: Choose which call types can create a new Carerix contact when no matching contact exists, or disable contact creation.
- Create contact for SMS messages: Choose which SMS message directions can create a new Carerix contact when no matching contact exists, or disable contact creation.
- Create contact for WhatsApp messages: Create a Carerix contact for supported WhatsApp messages when no matching contact exists.
- Sync contacts (v4): Enable global synchronization of new, updated and deleted Carerix contacts with Ringover. Select Display the last 10 logs to review the latest synchronization logs.
- Sync contacts on a call-by-call basis: Synchronize a contact when you call them or when they call you.
- Display contact's info during call and only store their info if call-by-call basis is activated: Display matching Carerix contact details during a call, and store them in Ringover only when call-by-call synchronization is enabled.
- Mapped fields: Select Add or edit fields to choose the Carerix fields displayed in the Info section of the Ringover Dialer (e.g., Contact Status, Job Title).
4. Make calls directly from Carerix
Once the integration is configured, you can install Ringover's browser extension to call candidates and contacts directly from your Carerix environment.
- Log in to your Carerix environment.
- Open the candidate or contact record you want to call.
- Locate the contact's phone number.
- Click the phone number to initiate the call through Ringover, using the Ringover click-to-call functionality configured for your environment.
- The Ringover dialer opens and initiates the call. You can then manage the conversation directly from the Ringover interface.
5. Open Carerix records from Ringover in one click
The integration works both ways: just as you can call from Carerix, you can jump from Ringover straight back to Carerix. Once your contacts are synchronized, your Carerix candidates and contacts are marked with the Carerix icon in Ringover, for example in your call logs.
Click the Carerix icon to open the matching record directly in Carerix. Returning a missed call or following up on a conversation? The full candidate profile is one click away, with no need to search for a name or copy a phone number.
6. Find your call activities in Carerix
Once a call has ended, Ringover can send the corresponding call information to Carerix. The activity is associated with the relevant contact or candidate record, allowing you to keep track of your communications directly from your ATS.
The activity can be logged either as a Note or a Task, depending on the chosen option.
You can drag the window frame in Carerix to expand it and see the entire note:
Similarly, the Ringover dialer allows you to send SMS and WhatsApp messages, depending on your subscription plan.
Messaging activities are synced to Carerix and can be displayed either grouped by daily conversation or as individual messages, depending on the selected option:
That's it! Your calls, messages and AI summaries now flow straight into Carerix, so your team spends less time on admin and more time placing the right candidates 🎉