Hosting External Applications
From v10.7.1563 - It is possible to host an external application by adding a button in the Home login screen. This application will have access to Softdial Contact Center™ (SCC) services (e.g. to request the User list, or create a Break Reason) with the credentials entered on login.
This facility allows users to create an application, fully interworking with SCC, of any complexity, from the very simple to a complete agent desktop.
There is no restriction on where the app is hosted, as Cross-Origin requests are accepted.
To host an external app
A new button must be defined for the login screen:
- In the Softdial\WebServer\www\softdial folder, locate the file ExternalApps.json
- Open it in any text editor.
- In the example entry, edit (and uncomment) the following keys:Show keys
Key Example value Description title Example External App Text shown on the button url ../exampleCustomerPage.html URL of the external application icon x-fa fa-google Icon. Choose any from https://fontawesome.com/v4.7.0/icons/ tenants ["default", "landlord"] Array list of tenants who will see this button.
To allow all tenants (and landlord), delete the line.
minPermission Supervisor Minimum permission required to see this button. Either
- Agent
- Supervisor
- Configuration
- System
- Super User
To allow all permissions, delete the line.
If interworking with backend services
- is not required, the steps above are sufficient.
- is required, follow the steps below.
To allow interworking
A reference to the Javascript file SoftdialRequest.js (which may be found in Softdial\WebServer\www\softdial) must be included in the application, i.e.
<script src="SoftdialRequest.js"></script>
It contains only one function: softdialRequest. It is intended to be globally accessible.
The purpose of this function is to send a request to SCC services with correct authentication.
It achieves this with JavaScript postMessage to the parent document, which will send out the actual request.
It povides an interface similar to Ext.Ajax.request.
Further code examples are contained within the SoftdialRequest.js file ( in Softdial\WebServer\www\softdial).
See the basic example page exampleCustomerPage.html (in Softdial\WebServer\www\softdial).