TradeHarbor offers both a web services interface and integration through VoiceXML subdialogs hosted on TradeHarbor servers. This guide explains the steps to perform a basic integration using the hosted subdialogs.

<subdialog name="dialogid" srcexpr="'/api/complete_vss_session.vxml'" namelist="parameters to pass" />

The steps involved in using TradeHarbor are:

• Set up a TradeHarbor trial account
• Enroll the caller by loading the Register Claim subdialog
• Establish a TradeHarbor session by calling the Session subdialog
• Verify the caller’s identity and complete the session
• Check the result and notify the caller

To start out with TradeHarbor, contact sales@tradeharbor.com to get a trial account set up. TradeHarbor will provide you with an authentication key you can use in your code.

Your application will have two possible flows: enrollment and verification. In enrollment, a caller who has not previously set up biometrics will provide an initial voiceprint for use in future calls to your application. In verification, callers will be asked for their passphrase and TradeHarbor will match that to what was recorded when they enrolled.

For our sample application, these two flows will be combined into a single call. The caller will be asked to enroll and once enrollment is complete, we’ll immediately verify them.

When a caller calls your application, we’ll play them a short greeting using a VoiceXML prompt. Then the vxml code will load a subdialog hosted on TradeHarbor’s servers that will perform the enrollment. Once enrollment is complete, we’ll load up another subdialog that will start the verification session and a third subdialog to complete verification.

All the recording and biometrics work is completed on the TradeHarbor servers through these hosted subdialogs, and your code authenticates to these subdialogs using the authentication key provided as part of your trial account. The results of each subdialog are placed into variables that our VoiceXML code can then inspect to see if verification succeeded.

You can get the sample VoiceXML application from Voxeo’s GitHub account.