Koppelprofiel Telefooncentrale: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
 
(18 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 1: Regel 1:
 
__TOC__
 
__TOC__
=== Instellingen ===
+
=== LET OP: wil je deze koppeling gebruiken, neem dan contact op met Zaaksysteem.nl. Er is wellicht een aanpassing in de software nodig.===
{|
+
=== Instellingen zaaksysteem ===
 +
{| width="100%"
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
 
|De koppeling met de telefooncentrale heeft in het zaaksysteem de naam 'PBX voor KCC'.<br>
 
|De koppeling met de telefooncentrale heeft in het zaaksysteem de naam 'PBX voor KCC'.<br>
 
<br>
 
<br>
Er zijn slechts twee settings die beheerd hoeven worden:
+
Er zijn slechts twee settings die door de zaaksysteem beheerd hoeven worden:
 
<ol>
 
<ol>
<li>IP-adres: Het IP-adres van de telefooncentrale, zodat bekend is met 'wie' zaaksysteem moet communiceren voor de telefoonberichtgeving.</li>
+
<li>Trigger-URL: URL die de PBX (telefooncentrale) moet gebruiken om binnenkomende gesprekken aan te melden.</li>
<li>Timeout: De tijd dat zaaksysteem de telefoon zal 'laten overgaan' in het zaaksysteem alvorens terug te melden aan de telefooncentrale dat niemand 'opneemt'.</li>
+
<li>Timeout: De tijd in seconden dat zaaksysteem de telefoon zal 'laten overgaan' in het zaaksysteem alvorens de popup in het zaaksysteem te sluiten.</li>
 +
</ol>
 +
 
 +
Wanneer de telefooncentrale een telefoongesprek ontvangt zal deze een bericht sturen aan zaaksysteem.nl. In dit bericht worden twee gegevens meegegeven:
 +
<ol>
 +
<li>Het telefoonnummer van de persoon die belt</li>
 +
<li>De extensie van de ontvanger - Het extensienummer van de medewerker die gebeld wordt. Dit extensienummer kan door de medewerker zelf beheerd worden op zijn gebruikerspagina: [[Gebruikers#Telefoonkoppeling|Extensie beheren]]</li>
 
</ol>
 
</ol>
 
|[[bestand:Koppelprofiel PBX voor KCC.png|thumb|Koppelprofiel PBX voor KCC]]
 
|[[bestand:Koppelprofiel PBX voor KCC.png|thumb|Koppelprofiel PBX voor KCC]]
 
|}
 
|}
 +
 +
=== Instellingen telefooncentrale ===
 +
Om het KCC verkeer tussen een telefooncentrale en het zaaksysteem mogelijk te maken is er een generieke KCC-registratie API beschikbaar. Deze API is beschikbaar voor een in de koppeling geconfigureerde machine, waarvan verwacht wordt dat er bij elk nieuw telefoongesprek dat via de centrale loopt een bericht aan het Zaaksysteem wordt afgegeven over een HTTP verbinding.<br>
 +
<br>
 +
De manier waarop berichten worden verstuurd verschilt per telefooncentrale, terwijl het zaaksysteem als generiek systeem wordt gebouwd, daarom kan het nodig zijn een tussenlaag te ontwikkelen die de berichten in het correcte formaat doorgeeft. De technische documentatie hiervoor is te vinden op een willekeurige Zaaksysteem omgeving onder de volgende URL: <nowiki>http://<omgeving>/man/Zaaksysteem::Controller::API::KCC</nowiki>.
 +
 
=== Testbestand ===
 
=== Testbestand ===
{|
+
{| width="100%"
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
|Doormiddel van dit testbestand kan de koppeling getest worden: [http://zaaksysteem.nl/wp-dev/wp-content/uploads/2014/03/Telefoongesprek.html Open het testbestand].
+
|Doormiddel van dit testbestand kan de telefoonfunctionaliteit getest worden: [https://zaaksysteem.nl/kcc-helper.html Open het testbestand].
 
<ul>
 
<ul>
<li>Omgeving: De zaaksysteemomgeving van de gemeente. Bijvoorbeeld: gemeente.zaaksysteem.nl of mijn.gemeente.nl</li>
+
<li>URL uit koppelprofiel: De URL die getoond wordt in het 'PBX voor KCC'-koppelprofiel</li>
 
<li>Telefoonnummer: Het telefoonnummer van degene die belt. Dit is het nummer dat wordt weergegeven in het zaaksysteem.</li>
 
<li>Telefoonnummer: Het telefoonnummer van degene die belt. Dit is het nummer dat wordt weergegeven in het zaaksysteem.</li>
<li>Extension: De extensie die de gebruiker heeft opgegeven op zijn instellingenpagina: [http://wiki.zaaksysteem.nl/Gebruikers#Telefoonkoppeling Telefoonkoppeling gebruikersinstelling]</li>
+
<li>Extension: De extensie (doorkiesnummer) die de medewerker heeft opgegeven op zijn instellingenpagina: [[Contactoverzicht#Instellingen|Extensie beheren]]</li>
 
</ul>
 
</ul>
Wanneer bovenstaande gegevens correct zijn ingevoerd en op 'Maak fake gesprek' is geklikt zal in het zaaksysteem de telefoon overgaan voor diegene  met de opgegeven extensie.<br>
+
Wanneer bovenstaande gegevens correct zijn ingevoerd en op 'Maak nep-gesprek' is geklikt zal in het zaaksysteem de telefoon overgaan voor diegene  met de opgegeven extensie.<br>
 
<br>
 
<br>
Let op: Voor deze test zal het eigen IP-adres opgegeven moeten worden in de configuratie, om te doen alsof de computer van waaruit de test wordt uitgevoerd de telefooncentrale is. Raadpleeg hiervoor bijvoorbeeld [http://www.whatismyip.com/ www.whatismyip.com]
 
 
|[[bestand:Testbestand PBX voor KCC.png|thumb|Testbestand PBX voor KCC]]
 
|[[bestand:Testbestand PBX voor KCC.png|thumb|Testbestand PBX voor KCC]]
 
|}
 
|}

Huidige versie van 30 mrt 2018 om 14:23

LET OP: wil je deze koppeling gebruiken, neem dan contact op met Zaaksysteem.nl. Er is wellicht een aanpassing in de software nodig.

Instellingen zaaksysteem

De koppeling met de telefooncentrale heeft in het zaaksysteem de naam 'PBX voor KCC'.


Er zijn slechts twee settings die door de zaaksysteem beheerd hoeven worden:

  1. Trigger-URL: URL die de PBX (telefooncentrale) moet gebruiken om binnenkomende gesprekken aan te melden.
  2. Timeout: De tijd in seconden dat zaaksysteem de telefoon zal 'laten overgaan' in het zaaksysteem alvorens de popup in het zaaksysteem te sluiten.

Wanneer de telefooncentrale een telefoongesprek ontvangt zal deze een bericht sturen aan zaaksysteem.nl. In dit bericht worden twee gegevens meegegeven:

  1. Het telefoonnummer van de persoon die belt
  2. De extensie van de ontvanger - Het extensienummer van de medewerker die gebeld wordt. Dit extensienummer kan door de medewerker zelf beheerd worden op zijn gebruikerspagina: Extensie beheren
Koppelprofiel PBX voor KCC

Instellingen telefooncentrale

Om het KCC verkeer tussen een telefooncentrale en het zaaksysteem mogelijk te maken is er een generieke KCC-registratie API beschikbaar. Deze API is beschikbaar voor een in de koppeling geconfigureerde machine, waarvan verwacht wordt dat er bij elk nieuw telefoongesprek dat via de centrale loopt een bericht aan het Zaaksysteem wordt afgegeven over een HTTP verbinding.

De manier waarop berichten worden verstuurd verschilt per telefooncentrale, terwijl het zaaksysteem als generiek systeem wordt gebouwd, daarom kan het nodig zijn een tussenlaag te ontwikkelen die de berichten in het correcte formaat doorgeeft. De technische documentatie hiervoor is te vinden op een willekeurige Zaaksysteem omgeving onder de volgende URL: http://<omgeving>/man/Zaaksysteem::Controller::API::KCC.

Testbestand

Doormiddel van dit testbestand kan de telefoonfunctionaliteit getest worden: Open het testbestand.
  • URL uit koppelprofiel: De URL die getoond wordt in het 'PBX voor KCC'-koppelprofiel
  • Telefoonnummer: Het telefoonnummer van degene die belt. Dit is het nummer dat wordt weergegeven in het zaaksysteem.
  • Extension: De extensie (doorkiesnummer) die de medewerker heeft opgegeven op zijn instellingenpagina: Extensie beheren

Wanneer bovenstaande gegevens correct zijn ingevoerd en op 'Maak nep-gesprek' is geklikt zal in het zaaksysteem de telefoon overgaan voor diegene met de opgegeven extensie.

Testbestand PBX voor KCC