JSON Service Project

Dieser Service liest Daten von einem Webservice und rendert diese in eine Tabelle. Der ACD WebAgent ruft den JSON Service je nach dem konfigurierten Agenten-Status und der Berechtigung in der ACD CRM Konfiguration auf. Der JSON Service schickt eine HTML-Seite als Antwort zurück, welche im WebAgent bei Anrufannahme dem Agenten angezeigt wird.

Features

GeneralRendererController:

Der hier beschriebene JSON Service ruft eine Kunden-URL auf und kriegt ein JSON Object zurück. Das JSON Object wird in eine HTML-Tabelle formatiert und an den WebAgent (als HTML-Seite) geschickt. Hinweis: Wenn das JSON Object https-Adressen beinhaltet, werden diese automatisch als Link in der Tabelle angezeigt. Der Link ist somit für den Agenten klickbar.

In sonstigen Fällen wird der Inhalt des JSON Objects als Text (Key Value) angezeigt. Beinhaltet das JSON Object den Parameter “openLink: true”, wird der im JSON Object enthaltene Link unmittelbar nach der Anzeige im WebAgent automatisch als neuer Tab im Browser geöffnet.

LinkRendererController:

Der JSON Service liest die enthaltenen URLs aus den Property-Dateien und schickt eine HTML-Seite an den WebAgent.

Hinweis: In diesem Fall wird die enthaltene URL nicht automatisch aufgerufen. Der Agent muss den im CRM-Fenster angezeigten Link manuell ansteuern. Beinhaltet das JSON Object den Parameter “openLink: true” als Property, wird der im JSON Object enthaltene Link unmittelbar nach der Anzeige im WebAgent automatisch als neuer Tab im Browser geöffnet.

CRM Einrichtung

Beispiel:

Rest Method: PUT
Rest URL: https://acdx.telegra.de/restacd/crm/configuration
Header: admin: xxxxx password: xxxxx content-type: Application/json
Body:
{
“id”: 0,
“url”: “http://maxmustermann.de”,
“token”: “1234567”,
“status”: “???” // ALERTING/CONNECTED/OUTALERTING/OUTCONNECT/… alle AgentStatus außer ONLINE und OUTONLINE
“parameters”: [
“callid”, “hotline_id”, “hotline_name”, “mode”, “calling_number”, “called_number”, “mandator_id”,
“mandator_name”, “agent_id”, “agent_user”, “call_waiting_time”
]
}

Hinweis: Kunden können die folgenden Informationen konfigurieren und diese als RequestParameter (kundenURL?callid=1234&calling_number=0123456789) versenden.

– “callid” // callid
– “hotline_id” // Hotline ID
– “hotline_name” // Hotline name
– “mode” // INBOUND / OUTBOUND
– “calling_number” // Calling number
– “called_number” // Called number
– “mandator_id”, // Mandator ID
– “mandator_name” // Mandator name
– “agent_id” // Agent ID – Intern
– “agent_user” // Sechsstellige Loginnummer des Agenten
– “call_waiting_time” // Länge der Zeit, welche der Anruf in Sekunden in Warteschleife gewartet hat. Nur für eingehende Anrufe (INBOUND) relevant.

Konfiguration

yaml
Beispiel / Example GeneralRendererController Konfiguration:

KundenService: # Kundenname
#Kunden URL zum CRM
url: https://acd.telegra.de/crm
#Authentifizierungstoken für diesen Dienst
token: 1234567
#BasicAuth für Kunden CRM (optional)
basicAuthUser: username
basicAuthPass: password

Beispiel LinkRendererController Konfiguration / Configuration:

KundenService: # Kundenname
#Kunden URL zum CRM
url: https://acd.telegra.de/crm
#Authentifizierungstoken für diesen Dienst
token: 1234567
#Beschreibung für den oberen Link die im WebAgent angezeigt wird
urlCaption: CRM-Link klicken
properties: “{\”openLink\”: \”true\”, \”CRM_Link_ACD4\”: \”https://acd4.telegra.de\”, \”Link2_ACD8\”: \”https://acd8.telegra.de/acdweb\” }”

JSON Service Project

English version

This project reads data from a web service and renders it into a table. The ACD WebAgent calls the JSON service depending on the configured agent status and permissions in the ACD CRM configuration. The JSON service returns an HTML page as response.

Features

GeneralRendererController:

The JSON service calls the customer URL and gets a JSON object back. The JSON object is formatted into an HTML table and sent to the WebAgent (as an HTML page). Note: If the JSON object contains https addresses, they are automatically displayed as a link in the table. The link is thus clickable by the agent.

In other cases, the content of the JSON Onject is displayed as text (Key Value). If the JSON object contains the parameter “openLink: true”, the link contained in the JSON object is automatically opened as a new tab in the browser immediately after it is displayed in the WebAgent.

LinkRendererController:

The JSON service reads the contained URLs from the property files and sends an HTML page to the WebAgent.

Note: In this case the contained URL is not called automatically. The agent must manually navigate to the link displayed in the CRM window. If the JSON object contains the parameter “openLink: true” as a property, the link contained in the JSON Object is automatically opened as a new tab in the browser immediately after it is displayed in the WebAgent.

CRM Setup

Example:

Rest Method: PUT
Rest URL: https://acdx.telegra.de/restacd/crm/configuration
Header: admin: xxxxx password: xxxxx content-type: Application/json
Body:
{
“id”: 0,
“url”: “http://maxmustermann.de”,
“token”: “1234567”,
“status”: “???” // ALERTING/CONNECTED/OUTALERTING/OUTCONNECT/… all AgentStatus except ONLINE and OUTONLINE
“parameters”: [
“callid”, “hotline_id”, “hotline_name”, “mode”, “calling_number”, “called_number”, “mandator_id”,
“mandator_name”, “agent_id”, “agent_user”, “call_waiting_time”
]
}

Note: The customer can configure the following information and send it as a request parameter (customersURL?callid=1234&calling_number=0123456789)- “callid” // callid

– “hotline_id” // Hotline ID
– “hotline_name” // Hotline name
– “mode” // INBOUND / OUTBOUND
– “calling_number” // Calling number
– “called_number” // Called number
– “mandator_id”, // Mandator ID
– “mandator_name” // Mandator name
– “agent_id” // Agent ID – Intern
– “agent_user” // Six-digit login number of the agent
– “call_waiting_time” // Length of time the call has been on hold in seconds. Only relevant for incoming calls (INBOUND).

Configuration

yaml
Example / Example GeneralRendererController configuration:

KundenService #Customer Name
#Customer URL to CRM
url: https://acd.telegra.de/crm
#Authentication token for this service
token: 1234567
#BasicAuth for the customer CRM (optional)
basicAuthUser: username
basicAuthPass: password

Examle for LinkRendererController Konfiguration / Configuration:

KundenService #Customer Name
#Customer URL to CRM
url: https://acd.telegra.de/crm
#Authentication token for this service
token: 1234567
#escription for the upper link displayed in WebAgent
urlCaption: Click CRM-Link
properties: “{\”openLink\”: \”true\”, \”CRM_Link_ACD4\”: \”https://acd4.telegra.de\”, \”Link2_ACD8\”: \”https://acd8.telegra.de/acdweb\” }”