Erik Vos - RealConnections
Aanlogprocedure Administrator Naast RealConnections heeft de klant zelf ook de mogelijkheid tot het wijzigen van de gegevens voor de telefooncentrale. Er zijn geen extra kosten voor het gebruik van deze portal. Wel moet men er rekening mee houden dat bij de aanmaak van nieuwe gebruikers er additionele maandkosten in rekening gebracht worden. Voor het aanloggen gaat men naar de volgende website: http://www.voipro.nl/index.php/login.html Hierbij het overzicht voor de administrator Portal Gebruiker PIN-code / password admin
Wijzingen Password Door te klikken op PIN-code wijzigen is het mogelijk om het password te wijzigen. Documentatie Naast deze handleiding is er ook altijd een up to date versie beschikbaar van alle documentatie. U komt bij deze wiki door op Documentatie te klikken in de portal.
Elementen De hosted telefooncentrale bestaat uit 4 onderdelen 1. Telefoontoestellen 2. Gebruikers 3. Telefoonnummers 4. Groepen Telefoontoestellen Het is mogelijk om vanaf meerdere toestellen gebruik te maken van de diensten, voor het bellen en het gebeld worden. 1 gebruiker kan echter altijd slecht op 1 toestel tegelijkertijd zijn ingelogd. Alleen als men ingelogd is op een nummer dan kunnen externe gebruikers gebeld worden, voor het intern bellen hoeft men niet ingelogd zijn. Op dit moment staan de volgende toestellen geconfigureerd: Hierbij tevens een overzicht van de detail pagina van 1 van de toestellen:
Gebruikers Een gebruiker kan zowel een fysiek persoon zijn, maar ook een functie (receptie). Tevens is het mogelijk een fax of conference call te definiëren als gebruiker. Op dit moment zijn de volgende gebruikers geconfigureerd: Detail pagina gebruiker Voor elke gebruiker kunnen andere instellingen worden gemaakt hieronder een overzicht van de huidige instellingen.
Externe Nummers Externe nummers moeten aan een gebruiker gekoppeld worden. Meerdere externe nummers kunnen aan 1 gebruiker gekoppeld worden. Op dit moment zijn de volgende koppelingen gemaakt. Deze kunnen elk moment gewijzigd worden Daarnaast is er nog de mogelijkheid om groepen aan te maken van gebruikers. Op dit moment hebben we de volgende groepen ingesteld:
Individuele gebruikers De administrator kan inloggen in de portal van een gebruiker, maar ook de gebruiker kan zelf inloggen en zijn eigen instellingen wijzigen. Inloggen door administrator Door op de button Login in als.. op de - details gebruikers- pagina komt de administrator op de individuele portal terecht. Individuele gebruikers Deze loggen in via de volgende URL. http://www.voipro.nl/index.php/login.html De huidige instellingen zijn de volgende: Gebruiker Portal Gebruiker PIN-code Erik Xxxxx 1000 **** Ton Xxxxx 1001 **** Menno Xxxxx 1002 **** De gebruiker kan bijvoorbeeld zelf de PIN-code wijzigen, let op dat dit wel een numeriek password moet zijn. Omdat dit password ook gebruikt moet worden om in te loggen op de toestellen.
Verkorte kiescodes Met de volgende speciale verkorte kiescodes kan worden ingelogd, voicemail beluisterd/ingesteld, wachtrijen beheerd, etc. In- en uitloggen *10 : Inloggen op een toestel Indien een toestel beschikt over meerdere lijnen neem dan de hoorn op en selecteer de gewenste lijn. 1. toets *10* + het interne nummer van de gebruiker die ingelogd dient te worden. 2. zodra er wordt gevraagd voor de pincode toets de pincode behorend bij deze gebruiker gevolgd door een # vb Gebruiker 100 met pincode 1234 wilt inloggen op een toestel 1. toets *10*100 en druk op "zend" of "bellen" 2. de centrale vraagt voor de pincode 3. toets 1234# *11 : Uitloggen van een gebruiker Indien een toestel beschikt over meerdere lijnen neem dan de hoorn op en selecteer de gewenste lijn. 1. toets *11* + het interne nummer van de gebruiker die uitgelogd dient te worden. 2. zodra er wordt gevraagd voor de pincode toets de pincode behorend bij deze gebruiker gevolgd door een # *13 : Horen wie is ingelogd op deze een lijn Indien een toestel beschikt over meerdere lijnen neem dan de hoorn op en selecteer de gewenste lijn. 1. toets *13 gevolgd door "zend" of "bellen" 2. van de centrale krijgt u een van de volgende meldingen o Dit toestel is in gebruik door gebruiker.... Er is al iemand ingelogd op deze lijn. o Dit nummer is niet in gebruik. Er is nog niemand ingelogd op op deze lijn. Belbudget opvragen *14 : Controleren wat het belbudget is Met deze verkorte kiescode kunt u controleren voor de ingelogde gebruiker hoe hoog het belbudget is en of er een belbudget is ingesteld. 1. toets *14 gevolgd door "zend" of "bellen" 2. van de centrale krijgt u een van de volgende meldingen o Er is geen beperking op uw belbudget o Uw belbudget is xxx Euro en xxx cent
permanent doorschakelen vanaf een toestel *21 : Permanent doorschakelen naar een intern of extern nummer *21 biedt de mogelijkheid om via het toestel permanent door te schakelen naar een intern/extern nummer/ voicemail of de actieve doorschakeling op te heffen. zonder actieve doorschakeling 1. toets *21 gevolgd door "zend" of "bellen" 2. van de centrale krijgt u een van de volgende meldingenwelkom bij het *21 hoofdmenu Er is op dit moment geen doorschakeling actief om permanent door te schakelen naar een nummer kies * Uw vorige doorschakeling was naar xxxxxxxxx. Om dit nummer weer te gebruiken kies * wilt u een ander nummer gebruiken voer dit dan nu in gevolgd door een # om permanent door te schakelen naar voicemail kies 1 of toets *21* gevolgd door een intern of extern nummer en gevolgd door "zend" of "bellen" een moment geduld alstublieft dank u u bent permanent doorgeschakeld naar xxxxxxxx met actieve doorschakeling 1. toets *21 gevolgd door "zend" of "bellen" 2. van de centrale krijgt u een van de volgende meldingen Welkom bij het *21 hoofdmenu o U bent permanent doorgeschakeld naar xxxxxxxxx o Om uw doorschakeling op te heffen kies # o Om permanent door te schakelen naar voicemail kies 1 Voicemail *86 of *87 : Voicemail afluisteren of voicemail instellingen wijzigen Via het toestel waarop is ingelogd 1. toets *86* gevolgd door "zend" of "bellen" 2. Volg de instructies van de centrale Vanaf een ander toestel in de centrale 1. toets *87* + het interne nummer van de gebruiker die ingelogd dient te worden. 2. zodra er wordt gevraagd voor de pincode toets de pincode behorend bij deze gebruiker gevolgd door een # Deze verkorte code dient ook gebruikt te worden om voicemail instellingen en berichten van huntgroepen aan te passen.
Wachtrijen *40 : Inloggen in alle wachtrijen De centrale kan meerdere wachtrijen bevatten waarin de gesprekken worden opgenomen door agents. Indien een gebruiker is aangemerkt als agent voor een of meerder wachtrijen kan hij/zij zich door middel van de code *40 als agent inloggen in alle wachtrijen. 1. toets *40 2. de centrale geeft de melding "gebruiker ingelogd" Nu is de gebruiker in alle wachtrijen waarvoor hij/zij is aangemerkt als agent ingelogd *41 : Uitloggen uit alle wachtrijen De centrale kan meerdere wachtrijen bevatten waarin de gesprekken worden opgenomen door agents. Indien een gebruiker is ingelogd als agent in een of meerder wachtrijen kan hij/zij zich door middel van de code *41 als agent uitloggen uit alle wachtrijen tegelijk. 1. toets *41 2. de centrale geeft de melding "gebruiker uitgelogd" *40*nnn : Inloggen in een specifieke wachtrij De centrale kan meerdere wachtrijen bevatten waarin de gesprekken worden opgenomen door agents. Indien een gebruiker is aangemerkt als agent voor een of meerder wachtrijen kan hij/zij zich door middel van de code *40* als agent inloggen in een specifieke wachtrij. 1. toets *40* gevolgd door het interne nummer van de wachtrij 2. de centrale geeft de melding " gebruiker ingelogd" vb Gebruiker wilt inloggen als agent in de wachtrij 9999 1. toets *40*9999 en druk op "zend" of "bellen" 1. de centrale geeft de melding "gebruiker ingelogd" *41*nnn : Uitloggen uit een specifieke wachtrij De centrale kan meerdere wachtrijen bevatten waarin de gesprekken worden opgenomen door agents. Indien een gebruiker is aangemerkt als agent voor een of meerder wachtrijen kan hij/zij zich door middel van de code *41* als agent uitloggen uit een specifieke wachtrij. 1. toets *41* gevolgd door het interne nummer van de wachtrij 2. de centrale geeft de melding " gebruiker uitgelogd" vb Gebruiker wilt uitloggen als agent uit de wachtrij 9999 1. toets *41*9999 en druk op "zend" of "bellen" 2. de centrale geeft de melding "gebruiker uitgelogd"
Overig *8 : Gesprek opnemen van een collega Met deze verkorte code kan een gesprek dat binnenkomt op het toestel van een collega worden overgenomen. 1. toets *8 om het binnenkomende gesprek op uw eigen toestel op te nemen. Let op: Voorwaarde is dat men wel in dezelfde pickup groep zit. Codes tijdens gesprek *2 : Doorverbinden van een gesprek Met deze functie kunt u een gesprek doorverbinden. Met name handig voor toestellen waarbij de functionaliteit om door te verbinden niet via een speciale "Transfer" toets wordt aangeboden (bv. C470IP, softphones). 1. toets *2 2. de centrale geeft de melding "doorschakelen" gevolgd door een toon 3. toets het nummer waarheen doorverbonden moet worden in. 4. het gesprek gaat over bij degene waarnaartoe wordt doorverbonden 5. kondig het gesprek aan bij degene naar wie wordt doorverbonden 6. verbreek uw verbinding Na stap 6 is het gesprek doorverbonden. Mocht de gebelde persoon niet opnemen wordt automatisch het doorverbinden verbroken na 4 keer overgaan. Indien bij stap 4 degene waarnaartoe wordt doorverbonden het gesprek niet wenst aan te nemen kunt u het volgende doen. toets *0 om het gesprek terug te nemen Let op Het intoetsen van het nummer waarnaartoe dient te worden doorverbonden dient vloeiend te gebeuren. Indien er te lang wordt gewacht tijdens het nummer zal onze centrale proberen een deel van het nummer te bereiken en krijgt u in de meeste gevallen de melding te horen: "Sorry dit is geen geldig nummer. Probeert u het aub nog een keer"
Hosted Voice API Het Voipro hosted voice platform heeft een API (Application Programming Interface) waarmee gebruikers en business partners functionaliteit kunnen toevoegen of integreren in een eigen omgeving of applicatie. Om een koppeling te realiseren tussen de eigen software en het hosted voice platform dient het IP adres waarvandaan de XMLRPC calls komen toegevoegd te worden aan onze systemen. Om zo'n koppeling te realiseren willen wij u aanraden om contact op te nemen met onze Service Desk en daarbij ook aan te geven wat u wilt integreren of uitbreiden, zodat wij u daarbij zo goed mogelijk kunnen assisteren. De API De specificatie van deze API is hier te vinden. Voorbeeld code gebruik API Python Voorbeeld afvangen van events Regelnummers aan/uit doen 1 #!/usr/bin/python 2 3 from xmlrpclib import ServerProxy 4 from SimpleXMLRPCServer import SimpleXMLRPCServer 5 portal = 'portalname' 6 username = 'username' 7 password = 'password' 8 9 url='https://%s+%s:%s@212.0.234.219:7088' % (portal, username, password) 10 c = ServerProxy(url, allow_none=1) 11 c.register_callback('voipro', 'http://localhost:9000') 12 13 class MyFuncs: 14 def printit(self, *x): 15 print x 16 return 'OK' 17 18 def getattr (self, attr): 19 print attr 20 return self.printit 21 22 server = SimpleXMLRPCServer(("localhost", 9000)) 23 server.register_instance(myfuncs()) 24 server.serve_forever() PHP Opzetten van een call Regelnummers aan/uit doen 1 <? 2 3 $dstnr = 'XXX'; 4 $company = 'XXX'; 5 $userid = 'XXX'; 6 $password = 'XXX'; 7 $url = "https://vmp.voiplus.nl"; 8 $port = 7088; 9 10 require('xml/rpc.php'); 11 12 function execute($xmlrpcmsg) { 13 global $company; 14 global $userid; 15 global $password; 16 global $url; 17 global $port; 18 $path = '/RPC2'; 19 $client = new XML_RPC_Client($path,$url,$port); 20 $client->setcredentials("$company+$userid", $password); 21 $response = $client->send($xmlrpcmsg); 22 if (is_a($response, 'XML_RPC_Response')) { 23 if (!$response->faultcode()) 24 return $response; 25 print "faultcode: ".htmlentities($response->faultcode())."<br>\n"; 26 print "reason: '".htmlentities($response->faultstring())."'<br>\n"; 27 } 28 print "<hr>request:<pre>\n"; print_r($xmlrpcmsg); print "</pre>\n"; 29 print "<hr>response:<pre>\n"; print_r($response); print "</pre>\n"; 30 } 31 32 $xmlrpcmsg = new XML_RPC_Message('makecall'); 33 $xmlrpcmsg->addparam(new XML_RPC_Value($userid, 'string')); 34 $xmlrpcmsg->addparam(new XML_RPC_Value($company, 'string')); 35 $xmlrpcmsg->addparam(new XML_RPC_Value($dstnr, 'string')); 36 37 $response = execute($xmlrpcmsg); 38 print_r($response); 39 40?>
Gelijktijdige gesprekken (concurrent calls) Met gelijktijdige gesprekken wordt bedoelt hoeveel gebruikers er binnen uw organisatie tegelijk zouden moeten kunnen bellen. Hiervoor dient u uit te gaan van het maximale aantal gelijktijdige gesprekken die u verwacht binnen uw bedrijf te gaan voeren. Indien u verwacht met 4 personen gelijktijdig gesprekken te gaan voeren en uw internetverbinding is hierop niet berekend dan is de kans groot dat u een slechte geluidskwaliteit gaat ervaren. U hoeft echter ook geen overcapaciteit aan bandbreedte te realiseren als u bv met 30 personen in uw organisatie werkt waarvan er slechts 4 tegelijk zullen bellen. Schat het aantal gelijktijdige gebruikers altijd zorgvuldig in. De ratio die wij vaak gebruikten in normale kantoor situaties is dat ongeveer 1 op de 5 gelijktijdig aan het bellen is. Bandbreedte gebruik Dit is afhankelijk van de gebruikte codec. Bij gebruik van een G711 codec gebruikt één telefoongesprek 100Kbit/s zowel up- als downstream. Daarnaast dient de lijn altijd over een kleine reserve te beschikken; we raden daarom aan ten minste 120Kbit/s bandbreedte te reserveren. Bij gebruik van een G729 codec wordt er met nauwelijks hoorbaar kwaliteitsverlies slechts 60Kbit/s gebruikt. Deze codec is niet geschikt voor faxen. Neem eventueel contact op met uw distributeur. Bij een VPN lijn die geconfigureerd is met een Voice PVC via Voipro wordt standaard G729 codec gebruikt. Infrastructurele voorwaarden Voor een betrouwbare en goede werking van VoIP en hosted voice diensten worden een aantal eisen gesteld aan het lokale netwerk en de verbinding naar buiten. Bekabeling De bekabeling dient minimaal CAT 5 gecertificeerd te zijn. DHCP Server Er dient een DHCP server aanwezig te zijn voor het toekennen van IP adressen aan de toestellen, tenzij gebruik gemaakt wordt van een Voipro VPN. SIP rewriting Op de router(s) die de toestellen verbinden met het internet dient SIP rewriting uitgeschakeld te zijn. SIP rewriting houdt in dat de router wijzigingen in het VoIP verkeer aanbrengt, wat tot moeilijk traceerbare problemen kan leiden. Bijvoorbeeld wegvallende toestellen, gesprekken met geluid alleen in één richting of helemaal geen geluid, en toestellen die wel kunnen bellen maar waar niet naartoe gebeld kan worden. QoS Instellingen Zodra over het netwerk zowel data als VoIP verkeer zal lopen dan dient op alle routers en switches waar VoIP verkeer over loopt QoS ingesteld te zijn. QoS instellingen zorgen ervoor dat het voice verkeer met de hoogste voorrang in het netwerk worden afgehandeld. Voor de instellingen van QoS verwijzen wij naar de handleidingen van de gebruikte apparatuur. Voor ondersteuning bij het instellen van QoS kunt u contact opnemen met uw dealer, indien nodig kan een externe netwerk/voice expert ingezet worden. Openen van TCP en UDP poorten op de firewall Voor het gebruik van onze hosted voice dienst moeten er verschillende poorten open staan op de firewall. Het gaat hier om verkeer van de telefoons naar onze centrale, en de antwoorden terug. In de meeste routers en firewalls is dit default toegestaan, en hoeft hier niets gewijzigd te worden. Als verkeer naar buiten alleen mogelijk is indien dat in de firewall expliciet toegestaan wordt, dan kan dat beperkt worden tot verkeer van en naar Voipro netwerken: 79.171.192.0/25, 79.171.196.0/25 en 212.0.234.216/29. Accepteer uitgaand TCP verkeer Eventueel beperkt tot poorten 80, 7080 en 8000 t/m 8005. De telefoons gebruiken, afhankelijk van het type, deze poorten om configuratie files (instellingen) van onze server te downloaden. Bij een eventuele blokkade kan het toestel zich niet registreren waardoor belverkeer onmogelijk is. Accepteer uitgaand UDP verkeer Voor de signalering (het SIP protocol, onder andere gebruikt voor het tot stand brengen en verbreken van verbindingen) wordt meestal UDP poort 5060 gebruikt. Bij het opzetten van een gesprek wordt tussen toestel en centrale onderhandeld over poortnummers voor het real-time spraakverkeer (het RTP protocol). Omdat het niet of nauwelijks voorspelbaar is welke poortnummers hierbij gebruikt gaan worden adviseren we alle UDP verkeer van en naar onze centrale toe te staan. Ook hierbij gaat het altijd om uitgaand verkeer en antwoorden. De telefoons hebben regelmatig communicatie met de centrale zodat NAT tabellen in routers levend blijven (keepalive) en daardoor de centrale de telefoons bereiken kan. Wij raden aan om NAT refresh op 120 seconde te zetten. Toestaan van verkeer van en naar de Voipro servers Zowel voor de registratie als voor de telefoongesprekken maakt een telefoon contact met één van onze centrale servers via onderstaande IP-adressen. Zorg dat uw firewall toestaat dat verkeer van en naar onderstaande IP adressen is toegestaan. (IP allow).
212.0.234.219/29 79.171.192.0/25 79.171.196.0/25 Een stateful firewall met een ruime time out Een stateful firewall houdt tussentijdse informatie bij van verbindingen die over de firewall lopen waardoor de firewall beter in staat is onderscheid te maken tussen verkeer dat wel en niet is toegestaan. De state dient minimaal 1 minuut bewaard te blijven. Toestellen achter een stateless firewall zijn voor de Voi+ dienst niet te gebruiken. Internetverbinding Voor een goede werking van internettelefonie is een kwalitatief hoogwaardige internetverbinding een vereiste. De bandbreedte moet voldoende zijn voor het aantal gewenste gelijktijdige gesprekken, zowel van als naar de provider. SIP telefoons Voipro gebruikt open standaarden (SIP, RTP) voor de communicatie met de telefoontoestellen, zodat in principe alle SIP toestellen gebruikt kunnen worden. Wij hebben echter een aantal merken en typen toestellen geselecteerd om volledig automatisch te provisionen en deze kunnen we dan ook end-to-end ondersteunen.