Voys side (Freedom)

1. Create a VoIP Trunk in Freedom → Manage → VoIP Trunk
2. El ID de cuenta y la contraseña (se generan automáticamente) son los campos relevantes.
3. Vaya a los ajustes avanzados (SIP) y configure el nombre de host fijo con su punto final SIP de LiveKit, por ejemplo 4d3njb7wq71.sip.livekit.cloud (lo encontrará en LiveKit Cloud en Telephony → SIP trunks → SIP URI en la parte superior derecha).

Esto indica a Voys que reenvíe las llamadas entrantes directamente a LiveKit sin esperar un registro. Así de sencillo.

LiveKit side

1. Vaya a Telephony
2. Vaya a SIP trunks
3. Y haga clic en el botón "+ 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)

Regla de distribución (necesaria para entrantes)

Esta es importante. La regla de distribución conecta la llamada entrante con el agente. Tenga en cuenta que el nombre del agente debe coincidir exactamente.

1. Telephony
2. Dispatcher rules
3. Y haga clic en el botón "+ Create new dispatch rule"
4. Haga clic en JSON EDITOR
5. Introduzca el siguiente json

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

Y no olvide conectar su agente a un enlace, en Trunks.

Enlace de salida (realizar llamadas a través de Voys)

1. Vaya a Telephony
2. Vaya a SIP trunks
3. Y haga clic en el botón "+ Create a new trunk"
4. Pero esta vez seleccione Outbound
5. E introduzca el siguiente json

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

• El json mejorado

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

• El json mejorado

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 desea una mejor calidad de audio, tiene dos opciones. Puede activar krisp. Se trata de una cancelación de ruido que se puede aplicar directamente en su enlace SIP para llamadas entrantes o salientes. El nuevo aspecto es el siguiente.

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