Voys side (Freedom)

1. Create a VoIP Trunk in Freedom → Manage → VoIP Trunk
2. L'identifiant de compte et le mot de passe (générés automatiquement) seront les champs pertinents.
3. Rendez-vous dans les paramètres Avancés (SIP) et définissez le nom d'hôte fixe sur votre point de terminaison SIP LiveKit, par exemple 4d3njb7wq71.sip.livekit.cloud (vous le trouverez dans LiveKit Cloud sous Telephony → SIP trunks → SIP URI en haut à droite).

Cela indique à Voys de transférer les appels entrants directement vers LiveKit sans attendre d'enregistrement. Simple comme bonjour.

LiveKit side

1. Rendez-vous dans Telephony
2. Rendez-vous dans SIP trunks
3. Et cliquez sur le bouton « + 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)

Règle de dispatch (obligatoire pour les appels entrants)

Celle-ci est importante. La règle de dispatch connecte l'appel entrant à l'Agent. Attention, le nom de l'agent doit correspondre exactement.

1. Telephony
2. Dispatcher rules
3. Et cliquez sur le bouton « + Create new dispatch rule »
4. Cliquez sur JSON EDITOR
5. Complétez le json suivant

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

Et n'oubliez pas de connecter votre agent à un trunk, sous Trunks.

Trunk sortant (passer des appels via Voys)

1. Rendez-vous dans Telephony
2. Rendez-vous dans SIP trunks
3. Et cliquez sur le bouton « + Create a new trunk »
4. Mais cette fois, sélectionnez Outbound
5. Et entrez le json suivant

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

• Le json amélioré

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

• Le json amélioré

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

Si vous souhaitez une meilleure qualité audio, deux options s'offrent à vous. Vous pouvez activer krisp. Il s'agit d'une suppression de bruit qui peut être appliquée directement à votre trunk SIP pour les appels entrants ou sortants. Le nouveau se présente comme suit.

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