Blog: Product

Introducing media and data residency on Open Voice Shield

By the TelecomsXChange engineering team ·

Data location lets every Open Voice Shield account choose where its call media lives. Recordings are stored in Canada by default; from today an account can keep them in the United States instead, and can have its calls carried by a media relay in the United States as well. The two choices are independent and sit on one card under Account. Call records, transcripts and analyses stay in Canada whatever you pick.

Definition

What is data location for call media?

A call on Open Voice Shield produces two kinds of data. The media: a two-channel recording of the audio and, for a while, the packet capture it was decoded from. And the record: the call's signalling facts, its transcript, the analysis verdict, the charge on the ledger and the audit trail. Data location is the account-level choice of which region the media is written to, and which region's relay carries it while the call is live. It is not a choice about the record, which stays in the platform database in Canada.

This is the ordinary meaning of data residency applied to voice: the geographic region where a copy of the data is held at rest, and the region the live media passes through. Both matter, for different reasons, so the platform lets you set them separately.

Why it matters

Why would an operator choose a region?

Privacy law and contracts
Canadian operators answer to PIPEDA and, for some, to provincial law; operators serving European callers answer to the GDPR; many carrier contracts and procurement checklists name a country the recordings may not leave. Choosing the region in the portal, and seeing it on every call record, turns that clause into something you can show rather than promise.
Media latency
Audio that is anchored on a relay in the region where the traffic lives takes a shorter path. For calls between a switch in the United States and destinations in the United States, a relay in the same region removes a round trip to Canada on every packet, which shows up as lower jitter and a steadier estimated MOS.
Other regions
Europe, or any other region our cloud runs in, can be enabled on request for both the media relay and storage: write to support@telecomsxchange.com. Once enabled, the region appears on the card like the others.
Keeping the two apart
Some operators want the audio relayed close to the traffic but the recordings held at home, or the reverse. Because the two choices are independent, either combination is one card and one save.

How it works

How do the two choices work?

Your switch sends every call to the same ingress in Canada. From there, the media relay choice decides whether the audio is anchored on the relay in Canada or the relay in the United States. That relay records the call. The recordings storage choice decides whether the recording and the capture are then written to the store in Canada or the store in the United States. Any relay can write to any store, which is what makes the two choices independent.

Where a call's media goes with each data location choice Your switch sends every call to the same ingress in Canada. The media relay choice decides whether the audio is anchored on the relay in Canada or the relay in the United States. The recordings storage choice decides whether the recording and the media capture are written to the store in Canada or the store in the United States. Call records, transcripts and analyses always go to the platform database in Canada. Your switch the trunk you already run SIP Ingress Canada, one address, unchanged MEDIA RELAY, YOUR CHOICE RTP Relay in Canada default: carries the audio, records it Relay in the United States live: the same, in the US RECORDINGS STORAGE, YOUR CHOICE recording + media capture, either relay to either store Store in Canada default: Central Canada (Montréal) Store in the United States US East (Northern Virginia) Call records, transcripts and analyses: the platform database, always in Canada
One ingress in Canada. The relay and the store are each your choice. The database is not part of the choice.

A recording that belongs in the other region is uploaded there as soon as it is decoded and the copy on the node that decoded it is removed at once, so the only copy at rest is in the region you chose. Each call record carries the regions it was made with, so a change to the account never moves an existing call's media, and an auditor can read the region off any call rather than off a policy page.

Step by step

How to choose where your call media is stored and relayed

The Account page in the customer portal with the Data location card: two groups of choices, where your recordings are stored and which media relay carries your calls, each listing Canada and the United States, a Save button, and a note that call records, transcripts and analyses stay in the platform database in Canada.
Account, then Data location: the two choices side by side with the rest of the account.
  1. Open Data location. Sign in, open Account from the left navigation and find the Data location card. Both choices read Canada until you change them.
  2. Pick a region for recordings storage. Under Where your recordings are stored, choose Canada or the United States. A region the platform cannot serve yet is listed but cannot be picked.
  3. Pick a region for the media relay. Under Which media relay carries your calls, choose Canada or the United States. Your SIP ingress address does not change. Only the relay that anchors the audio does.
  4. Save and check the record. The storage choice applies to calls from now on, and recordings already stored stay where they are. The relay choice applies to new calls. The change lands in your audit log with the acting user.
The Data location card alone: the two radio groups with Canada selected in each, the region's location under each option, the Save button and the explanatory note.
The card on its own. Canada on both until you change them; a region without storage or a relay yet reads "Not available yet".

Timing

What changes, and when?

Recordings storage
Applies to every call from the moment you save. The recording and the capture of each later call are written to the region you chose. Recordings already stored stay where they are; their call records still say which region holds them.
Media relay
Applies to new calls. A call already in progress finishes on the relay it started on. The next call is anchored on the relay of the region you chose, and its record names that region.
Everything else
Unchanged. The ingress address your switch sends to, your destinations, routing rules, alerts, the web dialer and the API keys all stay as they are.

Boundaries

What stays in Canada whatever you choose?

The platform database, and everything in it: call records and their signalling facts, transcripts, analyses and verdicts, the ledger, invoices and the audit log. The SIP ingress and the signalling path. The portal and the API. Data location covers only the media of your calls, the part with weight, and leaves the account where it is. The privacy policy and the security overview describe the whole picture.

Automation

Can a script or an AI agent set the region?

Yes. The choice is two fields on one endpoint, and the account endpoint carries them too.

GET /customer/data-location
{
  "data_region": "ca",
  "media_region": "ca",
  "default_region": "ca",
  "regions": [
    {"code": "ca", "label": "Canada", "detail": "Central Canada (Montréal)",
     "storage_available": true, "media_available": true},
    {"code": "us", "label": "United States", "detail": "US East (N. Virginia)",
     "storage_available": true, "media_available": true}
  ]
}

PUT /customer/data-location
{"data_region": "us", "media_region": "us"}

A region the platform cannot serve yet is refused with a 422 that names it, so a script never silently lands in the wrong place. The full reference is in the Data location guide.

Glossary

Terms used on this page

Data residency
The geographic region where data is held at rest. Here, the region the recording and the capture of a call are written to.
Media relay
The component that carries the audio of a call between your switch and the destination and records it. Each region has one, and the choice decides which anchors your calls.
Ingress
The SIP address your switch sends calls to. There is one, in Canada, and it does not change with the choice.
Media capture
The raw packet capture of a call's audio, kept for a short time next to the recording for diagnostics and export, and covered by the same storage choice.
Call record
The call's facts in the platform database: numbers, timing, verdict, transcript, charge. Always in Canada.

Summary

The takeaway

Recordings and the media relay default to Canada. Either can move to the United States when you choose, or to Europe or another region on request. The two are set separately, every call record names the regions it used, and the account itself stays where it is. To change them, open Account, then Data location, and save.

Related: the Data location guide, the privacy policy, the security overview, or start free with $5 credit.

Questions

Frequently asked questions

Can I have my media in Europe or another region?

Yes, on request. Europe, or any other region our cloud runs in, can be enabled for both the media relay and storage: write to support@telecomsxchange.com. Once enabled, the region appears on the Data location card like the others and is selectable per account.

Where does Open Voice Shield store call recordings?

In Canada by default, on storage the platform controls. From Account > Data location an account can choose the United States instead for its recordings and media captures. The choice applies to calls from the moment it is saved; recordings already stored stay where they are.

What is the difference between the storage region and the media relay region?

The storage region is where the two-channel recording and the media capture of each call are written. The media relay region is which region's relay carries the audio of your calls while they are live. They are separate choices: you can relay in the United States and store in Canada, or the other way round.

Does my SIP ingress address change if I choose the United States?

No. Your switch keeps sending calls to the same ingress address. The choice decides which region's media relay the platform anchors the audio on, and the relay's address is offered to your switch in each call's SDP as it is today.

Do transcripts and analyses move too?

No. Call records, transcripts, analyses, the ledger and the audit log live in the platform database in Canada whatever you choose. Data location is about the media of your calls: the recordings and the packet captures.

Can I move recordings that already exist?

Not from the portal. Each call keeps the regions it was made with on its record, so a later change never moves a call's media. If you need an existing set of recordings moved, contact support.

Can a script or an AI agent set the region?

Yes. GET /customer/data-location returns the two choices and the regions available; PUT /customer/data-location with data_region or media_region saves them. A region without storage or a relay yet is refused with a 422 that names it. The account endpoint carries both fields as well.

Is the United States relay live?

Yes, as of this post: both the recordings store and the media relay can be set to the United States. The portal only lists a region as selectable once the platform has a bucket or a relay there, so what the card offers is what is live.