Helpdesk Webservice

Weitergehende Informationen zum Helpdesk Webservice und der notwendigen Einstellungen im esoffice und esweb finden Sie im Bereich Informationen zur Nutzung des Helpdesk Webservice und unter esweb | Einstellungen | Allgemein | Service - Bereich 'Helpdesk Webservice'.

Sicherheit

Webservice-Methoden

Login

Methodenname: login

Url: {esweb Url}/api/helpdesk/login

Beschreibung

Die Login-Methode generiert für die im ES-Req Header angegebenen Logindaten einen Token, der für die Verwendung der weiteren Methoden benötigt wird. Der ES-Req Header enthält base64-kodiert und durch : getrennt die Kennung, das Passwort und eine beliebige Bezeichnung für den Client.

Kennung: 1

Passwort: Gehe:im

Clientbezeichnung: Test\123

-> ::1:Gehe\:im:Test\\123

=> ES-Req: OjoxOkdlaGVcOmltOlRlc3RcXDEyMw==

ES-Req: MToxOkNsaWVudA==

Content-Length: 0

HTTP/1.1 200 OK

ES-Token: VqRptMpHKWmJgQHsik7FcPki4+mZWT5pYq7id2QYczQBAAAA

Content-Length: 0

Call anlegen

Methodenname: createservicecall

Url: {ES-Web Url}/api/helpdesk/createservicecall

Beschreibung

Die Methoden erstellt aus den übergebenen Daten einen Servicecall und gibt Servicecallnr und TicketId zurück.

ES-Token: VqRptMpHKWmJgQHsik7FcPki4+mZWT5pYq7id2QYczQBAAAA

Content-Length: 457

Content-Type: application/json

{

 „TicketId“: „123“,

 „CustomerId“: „5“,

 „Text“: „Nichts \“funktioniert\“ mehr!“,

 „ProblemCategory“: 5,

 „ContactId“: 14,

 „ContactName“: „Herr Max Mustermann“,

 „ContactPhoneNumber“: „0123456789“,

 „ContactEmail“: „max.mustermann@mustermann.de“,

 „LocalContactName“: „Frau Erika Mustermann“,

 „LocalContactPhoneNumber“: „098765431“,

 „LocalContactEmail“: „erika.mustermann@mustermann.de“,

 „ProductCategory“: 5,

 „ProductSubcategory“: 10

}

{“TicketId“:“123“,“ServicecallId“:621}

Call aktualisieren

(Ab Version 10.95.15.6)

Methodenname: UpdateServicecall

Url: {ES-Web Url}/api/helpdesk/updateservicecall/{servicecallid}

Beschreibung

Die Methoden aktualisiert einen Servicecall mit den übergebenen Daten.

ES-Token: VqRptMpHKWmJgQHsik7FcPki4+mZWT5pYq7id2QYczQBAAAA

Content-Length: 30

Content-Type: application/json

{

„ProblemCategory“: 2

}

ServicecallData

Methodenname: servicecalldata

Url: {ES-Web Url}/api/helpdesk/servicecalldata/{servicecallid}

Beschreibung

Die Methode ruft Informationen zum Servicecall mit den übergebenen Daten ab.

ES-Token: VqRptMpHKWmJgQHsik7FcPki4+mZWT5pYq7id2QYczQBAAAA

Content-Type: application/json; charset=utf-8

{
 „StatusData“:[
 {
  „State“:“Started“,
  „Date“:“2016-03-14T14:11:12.101“
 },
 {
  „State“:“Forwarded“,
  „Date“:“2016-03-14T14:11:27.522“
 }],
 „Communication“:[
 {
  „MessageId“:600357,
  „Date“:“2016-03-14T14:09:39.451“,
  „Incoming“:false,
  „ContactName“:“Herr Max Mustermann“,
  „Text“:“Hallo Herr Mustermann,\r\n\r\ndie Lösung ihres Problems lautet:“,
  „Url“:“http://[ES-Web-Url]/service/helpdeskdetail.aspx?einzelaktnr=600357&servcallnr=621&tabcon=1“
 }],
 „ServicecallId“:621
}

ServicecallAcceptState

Methodenname: servicecallacceptstate

Url: {ES-Web Url}/api/helpdesk/servicecallacceptstate/{servicecallid}

Beschreibung

Mit der Methode kann übermittelt werden, ob der Kunden die Lösung für den Servicecall akzeptiert.

POST https://[ES-Web-Url]/api/helpdesk/servicecallacceptstate/621 HTTP/1.1

Host: localhost:53920

ES-Token: VqRptMpHKWmJgQHsik7FcPki4+mZWT5pYq7id2QYczQBAAAA

Content-Length: 73

Content-Type: application/json

{

 „Accept“: false,

 „RejectionMessage“: „Das geht alles nicht“

}

Response:

HTTP/1.1 200 OK

Content-Type: application/json; charset=utf-8

Date: Mon, 14 Mar 2016 13:50:37 GMT

Content-Length: 61

{“State“:“Sonderpriorität“,“Date“:“2016-03-14T14:50:36.731“}

Datenpakete

Servicecalldaten

Format: JSON

Felder

Servicecallantwortdaten

Format: JSON

Felder

Servicecallakzeptierendaten

Format: JSON

Felder

Servicecallinformationen

Format: JSON

Felder

Kommunikationsdaten

Format: JSON

Felder

Statusdaten

Format: JSON

Felder

ServicecallUpdatedaten

Format: JSON

Felder

Informationen zur Nutzung des Helpdesk Webservice

Immer mehr Unternehmensübergreifende Prozesse laufen Software-gestützt ab. Eine Fluggesellschaft beispielsweise setzt ein internes Trouble-Ticket-System ein, um den Überblick über die vielen Anlagen im Unternehmen zu behalten. Fallen zum Beispiel in einer Abteilung die Melder oder Telefone aus, melden dies die betroffenen Mitarbeiter der internen IT-Abteilung. Die Kollegen dort tragen die Störmeldung in das interne Trouble-Ticket-System ein.

Für eine schnelle Lösung ist es sinnvoll, das interne System mit externen Systemen zu verbinden. So wird in diesem Beispielfall bei der Ticket-Anlage vollautomatisch digital ein Störungsticket im esoffice-Helpdesk des Errichters angelegt, der die betroffene TK-Anlage betreut. Oder es wird automatisiert eine E-Mail an den Errichter versandt, die im esoffice-Helpdesk automatisch als neuer Servicecall interpretiert wird.

Der Errichter weiß sofort, wenn mit einer seiner Anlagen etwas nicht stimmt und welche Komponenten betroffen sind. Ein Techniker zur Störungsbehebung kann umgehend eingesetzt werden. Dank der automatischen Ticket-Anlage hat er Zugriff auf alle wichtigen Informationen wie Historiendaten oder Kontakteinträge. Vertraglich vereinbarte Reaktionszeiten können so viel einfacher mit weniger Aufwand eingehalten werden.

Ihre Vorteile im Überblick

Schnellere Prozessdurchlaufzeiten

Schnellere Reaktionszeiten

Schnellere Störungsverfolgung und Störungsbehebung

Für die Integration eines Ticket-Systems mit dem esHelpdesk werden über den Helpdesk Webservice folgende Möglichkeiten bereitgestellt:

1. Call anlegen

Der Servicecall wird anhand der übermittelten Daten angelegt.

Funktion: Anhand der Parameter wird im esHelpdesk ein neuer Servicecall angelegt und gestartet.

2. Calldaten abrufen

Dieser Webservice dient zum Updaten von Tickets im Ticket-System. Die Übertragung erfolgt auf Abruf (ein Zeitgesteuerter Webservice beim Kunden fragt die Daten an).

Funktion: Es werden Historiendaten und Kontakteinträge zum Servicecall geliefert.

3. Lösung für Servicecall akzeptieren oder ablehnen

Funktion: Der Servicecall wird auf den in den Grundeinstellungen (Einstellungen | Referenzen - Service | Helpdeskreferenzen - Servicecallstatus) hinterlegten Status für akzeptierte oder nicht akzeptierte Lösungen gesetzt.

Benötigte Einstellungen

esoffice

Einstellungen | Allgemein | Sicherheit - Bereich 'esweb' Basis-Url

Diese Einstellung wird benötigt, damit beim Abrufen der Kontakte die URL des Kontakts zurückgegeben werden kann.

esweb

esweb -> Einstellungen | Allgemein | Service | Helpdesk Webservice

Kundennr. Kunde unbekannt

Wählen Sie hier eine Kundennummer aus, die verwendet wird, wenn die übertragenen Customerid aus dem Ticketsystem in der esoffice Datenbank nicht gefunden werden kann.

Status Kunde unbekannt

Servicecallstatus, der verwendet wird, wenn die übertragenen CustomerId in der esoffice Datenbank nicht gefunden werden kann.

Lösung akzeptiert Status

Servicecallstatus, der gesetzt wird, wenn die Lösung vom Kunden akzeptiert wird.

Lösung abgelehnt Status

Servicecallstatus, der gesetzt wird, wenn die Lösung vom Kunden abgelehnt wird.

Option 'Mit Servicelevel'

Diese Option legt fest, ob der Servicelevel über den Webservice gesetzt werden kann, wenn der Benutzer (zum Beispiel Kundenlogin) nicht die entsprechende Berechtigung hat. Ist die Option nicht aktiviert, kann der Servicelevel ohne entsprechende Berechtigung nicht gesetzt werden.

esweb -> Einstellungen | Allgemein | Service | Helpdesk

Ergebnis für Kunden sichtbar

Hier legen Sie fest bei welchem Servicecallstatus der Wert des Ergebnisfeldes an den Kunden übertragen wird. Aktivieren Sie die Option des entsprechenden Servicecallstatus damit dieser das Ergebnis für den Kunden sichtbar ist bzw. über den Webservice übertragen werden kann.