Voys side (Freedom)

1. Create a VoIP Trunk in Freedom → Manage → VoIP Trunk
2. Die Account-ID und das Passwort (diese werden automatisch generiert) sind die relevanten Felder.
3. Gehe zu den erweiterten (SIP) Einstellungen und setze den festen Hostnamen auf deinen LiveKit-SIP-Endpunkt, z. B. 4d3njb7wq71.sip.livekit.cloud (du findest diesen in LiveKit Cloud unter Telephony → SIP trunks → SIP URI oben rechts).

Damit weiß Voys, dass eingehende Anrufe direkt an LiveKit weitergeleitet werden sollen, ohne auf eine Registrierung zu warten. So einfach ist das.

LiveKit side

1. Gehe zu Telephony
2. Gehe zu SIP trunks
3. Und klicke auf die Schaltfläche "+ 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 (erforderlich für eingehend)

Das ist ein wichtiger Punkt. Die Dispatch-Regel verbindet den eingehenden Anruf mit dem Agenten. Beachte bitte, dass der Agentenname exakt übereinstimmen muss.

1. Telephony
2. Dispatcher rules
3. Und klicke auf die Schaltfläche „+ Create new dispatch rule"
4. Klicke auf JSON EDITOR
5. Gib bitte das folgende JSON ein

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

Und vergiss nicht, deinen Agenten unter Trunks mit einem Trunk zu verbinden.

Outbound trunk (Anrufe über Voys tätigen)

1. Gehe zu Telephony
2. Gehe zu SIP trunks
3. Und klicke auf die Schaltfläche „+ Create a new trunk"
4. Aber wähle dieses Mal Outbound
5. Und gib das folgende JSON ein

Und vergiss bitte nicht, deinen Agent unter Trunks mit einem Trunk zu verbinden.

Outbound Trunk (Anrufe über Voys tätigen)

1. Gehe zu Telephony
2. Gehe zu SIP trunks
3. Und klicke auf die Schaltfläche "+ Create a new trunk"
4. Aber wähle diesmal Outbound
5. Und gib das folgende JSON ein

{
  "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

• Das verbesserte 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

• Das verbesserte 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

Wenn du eine bessere Audioqualität möchtest, hast du zwei Möglichkeiten. Du kannst Krisp aktivieren. Das ist eine Geräuschunterdrückung, die direkt bei deinem SIP-Trunk für eingehende oder ausgehende Anrufe angewendet werden kann. Das neue sieht so aus.

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 ;)