Voys side (Freedom)

1. Create a VoIP Trunk in Freedom → Manage → VoIP Trunk
2. Het Account ID en wachtwoord (deze worden automatisch gegenereerd) zijn de relevante velden.
3. Ga naar Geavanceerde (SIP) instellingen en stel de Vaste hostnaam in op je LiveKit SIP-eindpunt, bijvoorbeeld 4d3njb7wq71.sip.livekit.cloud (je vindt dit in LiveKit Cloud onder Telephony → SIP trunks → SIP URI rechtsboven).

Dit zorgt ervoor dat Voys inkomende gesprekken rechtstreeks doorstuurt naar LiveKit in plaats van te wachten op een registratie. Zo simpel is het.

LiveKit side

1. Ga naar Telephony
2. Ga naar SIP trunks
3. En klik op de knop "+ Create a new trunk"

Inbound trunk (receiving calls)

In LiveKit Cloud → Telephony → Configuration → Create new → Trunk → Inbound, JSON editor

{
  "name": "Voys inbound trunk",
  "numbers": ["+31XXXXXXXXX"],
  "auth_username": "<Account ID from Freedom>",
  "auth_password": "<Password from Freedom>"
}

Use your Voys phone number with the country code (+31, drop the leading 0)

Dispatch rule (vereist voor inkomend)

Dit is een belangrijke. De dispatch rule verbindt het inkomende gesprek met de Agent. Let op: de agentnaam moet exact overeenkomen.

1. Telephony
2. Dispatcher rules
3. En klik op de knop "+ Create new dispatch rule"
4. En klik op de knop "+ Create new dispatch rule"
5. Klik op JSON EDITOR
6. Vul de volgende json in

{
  "rule": {
    "dispatchRuleIndividual": {
      "roomPrefix": "call-"
    }
  },
  "name": "Inbound-to-Agent",
  "roomConfig": {
    "agents": [
      {
        "agentName": "My Agent Name"
      }
    ]
  }
}

En vergeet niet om je agent te verbinden met een trunk, onder Trunks.

Outbound trunk (gesprekken maken via Voys)

1. Ga naar Telephony
2. Ga naar SIP trunks
3. En klik op de knop "+ Create a new trunk"
4. Maar selecteer deze keer Outbound
5. En voer de volgende json in

En vergeet niet om je agent te verbinden met een trunk, onder Trunks.

Outbound trunk (bellen via Voys)

1. Ga naar Telephony
2. Ga naar SIP trunks
3. En klik op de knop "+ Create a new trunk"
4. Maar selecteer deze keer Outbound
5. En geef de volgende json in

{
  "name": "Voys outbound trunk",
  "address": "ha.voys.nl",
  "numbers": ["+31XXXXXXXXX"],
  "auth_username": "<Account ID from Freedom>",
  "auth_password": "<Password from Freedom>"
}

Security

Trusted IPs

If you want to be sure you only receive traffic from Voys add the following IPs ranges as trusted:

• 195.35.114.0/23
• 185.103.76.0/22

Mind you if we ever change the IPs you won’t receive any traffic. We do not expect these IPs to change in the upcoming years ;)

Encrypt you Audio!

We highly recommend you use SRTP. This means the call traffic is encrypted and nobody can listen in on your calls.

The Voys side

• Use encryption should be on as should
• Enable TLS as a Transport protocol.

The LiveKit side for inbound

• De verbeterde json

{
  "name": "Voys inbound trunk",
  "numbers": [
    "+31XXXXXXXXX"
  ],
  "allowedAddresses": [
    "195.35.114.0/23",
    "185.103.76.0/22"
  ],
  "authUsername": "<Account ID from Freedom>",
  "authPassword": "<Password from Freedom>",
  "mediaEncryption": "SRTP"
}

The LiveKit side for outbound

• De verbeterde json

Alternatives for transport en media_encryption are

• transport: 3 = TLS (string "SIP_TRANSPORT_TLS")
• media_encryption: 1 = SRTP (string "SIP_MEDIA_ENCRYPT_ALLOW")

Audio quality

Noice canceling

Als je betere audiokwaliteit wilt, heb je twee opties. Je kan krisp inschakelen. Dit is noise cancellation die rechtstreeks bij je SIP-trunk kan worden toegepast voor inkomende of uitgaande gesprekken. De nieuwe ziet er zo uit.

Audio code

Voys natively support Opus which gives you the highest audio quality. LiveKit however does not support Opus on a SIP level. They do however support G.722. Both Voys and LiveKit natively support and use this codec. If you want to enforce the usage of this codec, go to the Expert Options on the Advanced (SIP) settings on the VoIP trunk page. There you can find the Codes settings.

Common issues

• The Static hostname on the Voys end says: sip:4d3njb7wq71.sip.livekit.cloud where it should say 4d3njb7wq71.sip.livekit.cloud without the SIP part
• Don’t forget to spin up you Agent. It should be Deployed (and Green ;)