Voys kant (Freedom)

1. Maak een VoIP-trunk aan in Freedom → Beheren → 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-endpoint, bijv. 4d3njb7wq71.sip.livekit.cloud (je vindt dit in LiveKit Cloud onder Telephony → SIP trunks → SIP URI rechtsboven).

Hiermee geef je Voys de instructie om inkomende gesprekken direct door te sturen naar LiveKit in plaats van te wachten op een registratie. Simpel zat.

LiveKit kant

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

Inbound trunk (gesprekken ontvangen)

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

Gebruik je Voys telefoonnummer met landcode (+31, laat de eerste 0 vallen)

Dispatch rule (verplicht voor inbound)

Deze is belangrijk. 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 "+ Create new dispatch rule" knop
4. Klik op JSON EDITOR
5. Vul de volgende json in

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

En vergeet niet 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 "+ Create a new trunk" knop
4. Maar selecteer dit keer Outbound
5. En voer 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>"
}

Beveiliging

Vertrouwde IP's

Als je zeker wil zijn dat je alleen verkeer van Voys ontvangt, voeg dan de volgende IP-ranges toe als vertrouwd:

• 195.35.114.0/23
• 185.103.76.0/22

Let op: als wij ooit de IP's wijzigen, ontvang je geen verkeer meer. We verwachten niet dat deze IP's de komende jaren veranderen ;)

Versleutel je audio!

We raden sterk aan om SRTP te gebruiken. Hiermee wordt het gespreksverkeer versleuteld en kan niemand je gesprekken afluisteren.

De Voys kant

• Gebruik encryptie moet aanstaan, net als
• TLS inschakelen als Transportprotocol.

De LiveKit kant voor 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"
}

De LiveKit kant voor outbound

• De verbeterde json

Alternatieven voor transport en media_encryption zijn

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

Audiokwaliteit

Ruisonderdrukking

Wil je betere audiokwaliteit? Dan heb je twee opties. Je kunt krisp inschakelen. Dit is ruisonderdrukking die je direct op je SIP-trunk kunt toepassen voor inkomende of uitgaande gesprekken. Dat ziet er zo uit.

Audiocodec

Voys ondersteunt van nature Opus, wat je de hoogste audiokwaliteit geeft. LiveKit ondersteunt Opus echter niet op SIP-niveau. Ze ondersteunen wel G.722. Zowel Voys als LiveKit ondersteunen en gebruiken deze codec van nature. Wil je het gebruik van deze codec afdwingen? Ga dan naar de Expert Opties bij de Geavanceerde (SIP) instellingen op de VoIP-trunk pagina. Daar vind je de Codec-instellingen.

Veelvoorkomende problemen

• De Static hostname aan de kant van Voys zegt: sip:4d3njb7wq71.sip.livekit.cloud terwijl het 4d3njb7wq71.sip.livekit.cloud zou moeten zijn, zonder het SIP-gedeelte
• Vergeet niet je Agent op te starten. Deze moet Deployed zijn (en Groen ;)