Koppelprofiel Telefooncentrale: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Instellingen zaaksysteem)
Regel 20: Regel 20:
  
 
=== Instellingen telefooncentrale ===
 
=== Instellingen telefooncentrale ===
Om het verkeer tussen het zaaksysteem en de telefooncentrale mogelijk te maken moet een proxy worden opgezet. De omschrijving hiervoor is te vinden in het zaaksysteem zelf onder de volgende URL: <nowiki>http://<omgeving>/man/Zaaksysteem::Controller::API::KCC</nowiki>
+
Om het KCC verkeer tussen een telefooncentral en een Zaaksysteem omgeving 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 nieuwe telefoongesprek dat via de centrale loopt een bericht aan het Zaaksysteem wordt afgegeven over een HTTP verbinding. Omdat elke telefooncentrale een eigen manier heeft om deze berichten te versturen, en Zaaksysteem als generiek systeem wordt gebouwd, kan het nodig zijn een tussenlaag te ontwikkelen die de berichten doorgeeft in het correcte formaat. 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 ===

Versie van 1 apr 2014 om 13:28

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. IP-adres: Het IP-adres van de telefooncentrale, zodat bekend is met 'wie' zaaksysteem moet communiceren voor de telefoonberichtgeving.
  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 telefooncentral en een Zaaksysteem omgeving 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 nieuwe telefoongesprek dat via de centrale loopt een bericht aan het Zaaksysteem wordt afgegeven over een HTTP verbinding. Omdat elke telefooncentrale een eigen manier heeft om deze berichten te versturen, en Zaaksysteem als generiek systeem wordt gebouwd, kan het nodig zijn een tussenlaag te ontwikkelen die de berichten doorgeeft in het correcte formaat. 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.
  • Omgeving: De zaaksysteemomgeving van de gemeente. Bijvoorbeeld: gemeente.zaaksysteem.nl of mijn.gemeente.nl
  • Telefoonnummer: Het telefoonnummer van degene die belt. Dit is het nummer dat wordt weergegeven in het zaaksysteem.
  • Extension: De extensie die de medewerker heeft opgegeven op zijn instellingenpagina: Extensie beheren

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.

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 www.whatismyip.com

Testbestand PBX voor KCC