KioWare allows a phone number to be dialed two different ways. A special tag can be embedded into the HTML that will direct KioWare to place a phone call, or a phone number can be related to the title tag of a specific URL, and whenever a screen navigation is directed to one of these URLs, then KioWare will place the phone call. In either case, a dialog box will appear indicating that the kiosk is placing a phone call and that the user needs to pick up the handset. KioWare will dial the phone number on the modem, wait until the connection is made, then drop the call leaving the handset directly connected to the phone number dialed. There is no limit to the number of phone numbers that the kiosk can dial.
General Settings
COM Port
COM port that the modem is configured to use to communicate.
Enable Embedded-Tag Dialing
When enabled, KioWare will search each page for a <kiowaredialer> HTML tag, and when one is found will display the dialog message and phone number defined in the tag. For example:
<kiowaredialer msg="Calling KioWare" pn="9,17178434790" dialpad="yes">
Where:
msg = A descriptive message that will be displayed in the calling dialog box
pn = The phone number
dialpad = Set to yes if you want the dialing pad to be shown, otherwise, no
Note: Another way to initiate a dial is found in the scripting section.
Handset Timeout
The number of seconds after the call is dialed before KioWare will hang up the modem. The number entered should be long enough that you are certain the user has picked up the handset, otherwise when KioWare hangs up the modem, the call will be disconnected.
Dialer Messages
While KioWare is placing the call, there are several messages that are displayed to the user.
Handset Message
The message initially displayed when KioWare initiates dialing – generally used to tell the user to pickup the handset.
Dialer Success Message
The message displayed when the call has been successfully dialed.
Dialer Error Message
The message displayed when the call cannot be successfully dialed.
Phone Number List
When not using embedded-tag dialing, KioWare will match title tags of all pages to be navigated to against the list of title tags entered below, and if a match is found will dial the matching phone number. Refer to the following screenshot.
Add New
To add a new phone number, click the Add New button.
Name
A descriptive name (ex, Human Resources Department) that will be displayed to the user to confirm who they are calling.
Page Title
The title tag of the URL that will initiate the phone call.
Phone Number
The phone number to be dialed by the modem. ex, 18005551212, or in the case where a prefix number must be dialed to access an outside line: 9,18005551212
Edit Selection
To edit an entry, highlight the row and either doubleclick or click the Edit Selection button.
Remove Selection
To remove an entry, highlight the row and either doubleclick or click the Remove Selection button.
HTML Dialpad
When dialing, a dialer HTML window is displayed and the width, height, position, opacity level, and URL can be configured.
The dialer window HTML is configurable via query string parameters and is located inside of the KioWare exe, so you need to link to it via resource as shown below:
res://C:\Program
Files\KioWare\KioWare.exe//220?autoDial=0&hideOnConnect=0&showHideButtonOnConnect=1&keepHidden=0
Make sure the path matches the path to your KioWare.exe file.
| autoDial | Set to 0 to allow the user to dial any number they want (SIP only). |
| hideOnConnect | Set to 1 to hide the dialer window on connect. |
| showHideButtonOnConnect | Set to 1 to show the hide button on connect. |
| keepHidden | Set to 1 to keep the dialer window hidden as much as possible. |
When you press the Preview button the dialer is displayed with all controls shown.
SIP is a standard generic VoIP protocol that many VoIP providers use. Your first step is to sign up for service with a VoIP provider that uses the SIP protocol before you will be able to try out this feature.
Audio In Device
Device on your machine that you will speak into.
Audio Out Device
Device on your machine that you will hear from.
Microphone Volume
Volume level that the microphone (Audio In Device) will default to.
SIP Codecs
List of SIP codecs that you find acceptable to use.
If the list is left empty, KioWare defaults to: PCMA, PCMU, G729.
Use SIPINFO for DTMF
RFC 2833 is the default SIP DTMF tone protocol. Enable this setting to use the SIPINFO protocol instead.
All Other Settings
The other settings are specific to your VoIP provider. They will be able to tell you what those values should be. If you have trouble dialing out, these setting are the most likely cause. KioWare usually cannot give specifics as to why those settings fail because the SIP server (for security reasons) will not say what specific setting is wrong.
Troubleshooting
If you are having trouble getting KioWare to talk with a specific provider, you can turn on a debugging entry that will dump out a ton of information to a PortSIP text file in the current working directory. Open the Windows registry to
LocalMachine/SOFTWARE/KioWare/Communications/Sip Phone
Create a dword called SipDebugLog and set it to 1.
Note: The correct SOFTWARE key will be located under a Wow6432Node key on 64 bit machines.