Ringover Integration

​

Overview

The Ringover integration connects your team’s Ringover phone system to Stardex, giving you:

• Click-to-call — dial any phone number directly from a person’s profile
• Send SMS — compose and send text messages without leaving Stardex
• Automatic transcript sync — call transcripts are logged as activities on the matching person’s timeline
• Recording links — links to Ringover-hosted call recordings appear alongside each transcript

Ringover is an org-wide integration — once an admin connects it, every team member can use the in-app dialer after signing into their Ringover account.

---

​

Setup (Admin Only)

You’ll need admin access to both Stardex and your Ringover Dashboard. The setup takes about five minutes.

​

Step 1 — Enable the integration

1. Go to Settings → Voice Integrations in Stardex.
2. Find Ringover and toggle it on.

​

Step 2 — Add the webhook URL in Ringover

Once enabled, Stardex shows a webhook URL. Copy it, then:

1. Open your Ringover Dashboard.
2. Navigate to Developer → Webhooks.
3. Open the Call Event section.
4. Turn on Activate webhook.
5. Paste the copied URL into the Transcription available field (under After-Call Work).

This is the only webhook event Stardex needs — contacts are matched automatically by phone number.

​

Step 3 — Copy your webhook key

Still in the Ringover Dashboard’s Call Event section:

1. Copy the Key shown at the top of the section.
2. Go back to Stardex and paste it into the Webhook key field.

​

Step 4 — Create and add your API key

1. In the Ringover Dashboard, go to Developer → API keys.
2. Create a new key with the Calls Read permission.
3. Copy the key and paste it into the API key field in Stardex.

Your region (EU or US) is detected automatically from the API key.

​

Step 5 — Save & Connect

Click Save & Connect. If the credentials are valid, the status badge will change to Connected and transcript syncing begins immediately.

---

​

Using the Dialer

Once the integration is active, a floating phone button appears in the bottom-right corner of every page. Click it to open the Ringover dialer.

• Sign in to your Ringover account inside the dialer the first time.
• The dialer is draggable — move it anywhere on screen. Your position is remembered.
• The dialer opens automatically when you receive an incoming call.
• Click the X to minimize back to the floating phone button.

​

Click-to-call from a profile

1. Open any person’s profile.
2. Click the actions menu (or the phone icon next to a phone number).
3. Select Call — the dialer opens and dials the number automatically.

​

Send an SMS from a profile

1. Open any person’s profile.
2. Click the actions menu next to a phone number.
3. Select Send Text — the dialer opens with an SMS compose window.

If the Ringover dialer isn’t loaded (e.g. pop-ups are blocked), clicking Call or Send Text opens the Ringover web app in a new tab as a fallback.

---

​

How Transcript Sync Works

After a call ends, Ringover generates a transcript (this depends on your Ringover plan supporting transcription). Once the transcript is ready, Stardex automatically:

1. Receives the webhook from Ringover.
2. Fetches the full transcript and call details from the Ringover API.
3. Matches the external caller/callee to a person in Stardex by phone number.
4. Creates a Call Note activity on the matched person’s timeline containing:
   • A link to view the call in Ringover
   • A link to the call recording (if available)
   • Participant names (agent and contact)
   • The full transcript with speaker labels and timestamps

​

Person matching

• If the phone number matches exactly one person in Stardex, the activity is linked to that person.
• If there are zero matches or multiple matches, the activity is saved as an unassigned activity so nothing is lost — you can manually link it later.

​

Idempotent processing

If Ringover sends the same webhook more than once (e.g. due to a retry), Stardex updates the existing activity rather than creating a duplicate.

---

​

Important Notes

• Call recordings are linked, not stored. Stardex includes a link to the Ringover-hosted recording in the activity but does not download or store the audio file. Your recordings stay in Ringover.
• Transcription requires a compatible Ringover plan. If your Ringover plan does not include transcription, the webhook won’t fire and no activities will be created.
• Phone numbers must be on the person record. Transcript sync matches by phone number, so make sure your candidates and contacts have phone numbers saved in Stardex.

---

​

Disconnecting

To disconnect the integration:

1. Go to Settings → Voice Integrations.
2. Click Disconnect Ringover.
3. Confirm the disconnection.

After disconnecting in Stardex, remember to also remove the webhook URL from your Ringover Dashboard to stop webhook deliveries. Existing call note activities will remain on person timelines — disconnecting only stops future syncing.