Het is mogelijk om in realtime informatie te ontvangen over een inkomende of uitgaande oproep die plaatsvindt.
Dit kan via de techniek van websockets: ontvang events via 1 enkele TCP-verbinding.
Wat heb je nodig om aan de slag te gaan ?
- websocket library van je ontwikkeltaal
- websocket authenticatie gegevens
- websocket connectie met de VoipCenter websocket server
- luisteren naar het event “notify“
1. Websocket libray
In deze tutorial gebruiken we de Javascript client library socket.IO
2. Authenticatie
Een geldige websocket username en bijhorende key voor authenticatie/registratie kan bekomen worden via de module “Websockets” in het menu “Config” van de VoipCenter beheersinterface.
Of via de VoipCenter cloud APIv2 via het endpoint v2/x/config/websocket.
3. Websocket connectie
Na het maken van de connectie met de websocket server dient een register event verstuurd te worden met correctie authenticatie gegevens. Anders wordt de connectie verbroken.
var socket = io.connect('https://wsX.voipcenter.be:4123');// X = websocket server
socket.on('connect', function (data) {
socket.emit('register', { username: wsUsername, wskey: wsKey });
});
4. het event ‘notify’
Als de websocket TCP-verbinding bestaat, kan er op ieder moment een notify event plaatsvinden. Dit gebeurt dus wanneer er een inkomende of uitgaande oproep is.
socket.on('notify', function (calldetails) {
console.log(JSON.parse(JSON.stringify(calldetails)));
})
