JavaScript Desktop Integration APIs

Releases

to be released To NTE

• 2014-10-07

to be released To PROD

• 2014-10-08

Changes

• Emits Hold event to agent 2, who is hold disabled, when agent 1 put caller on hold
• Master bug for 2.1.3
• Tag for release: https://github.liveops.com/eng/lo-js-api/tree/chimera-2.1.3

Dependencies

• Presence Minimum Version 3.0.6.6
• CallManager Minimum Version 9.6.7
• CallCenter Minimum Version CC_2014-10-08_MINOR_RELEASE
• PSAPI Minimum Version 1.22

Desktop API Release 2.0.8

Release Date (NTE): 2013-05-13

Release Date (GA): 2013-05-17

Desktop API URL:

• https://static.liveops.com/api/desktop/2.0.8/desktop-api.js
• https://static.liveops.com/api/desktop/latest/desktop-api.js

(New) Browser Phone API URL:

• https://static.liveops.com/api/desktop/2.0.8/phone-api.js
• https://static.liveops.com/api/desktop/latest/phone-api.js

What's New:

• New Browser phone API - VOIP in a browser. It provides a simple API interface to allow you to receive calls in a browser, works alongside DesktopAPI. Currently supports Twilio. Documentation can be found at: https://static.liveops.com/api/desktop/2.0.8/doc/phone/

Bug Fixes:

• Will now work with require.js.
• GoOnlineTimeout message no longer incorrectly sometimes returned upon Presence Recycle (bugId: 221626)

Known Issues:

• Unable to pause an agent that has Twilio number. Workaround for this bug us auto answer calls on browser phone. (bugId 222131)
• Twilio Device can still sometimes respond to incoming calls after uninitializing browser phone. (bugId 221744)

Desktop API Release 2.0.7

Release Date (NTE): 2013-04-01

Release Date (GA): 2013-04-05

Release URL:

• https://static.liveops.com/api/desktop/2.0.7/desktop-api.js
• https://static.liveops.com/api/desktop/latest/desktop-api.js

Features:

• LIVEOPS.desktopAPI.CallParty.disconnect() Now supports ending current call without ending the Open Line Session. (Please see documentation for more information)
• Internal supporting libraries have been upgraded.
• New developer demo page which shows basic functionality of the Desktop API. View Here.

Bug Fixes:

• An error is no longer thrown from DAPI.initialize() after second attempt to initialize (bugId: 219010).
• GoOnlineTimeout event no longer incorrectly occurs after quickly going online then offline bugId: 219128).

Known Issues:

• This version will not work with require.js library. This issue will be resolved in the following version.

Desktop API Release 2.0.6

Release Date (NTE): 2013-03-11

Release Date (GA): 2013-03-13

Release URL:

• http://static.liveops.com/api/desktop/2.0.6/desktop-api.js

Features:

• Release process has been improved. As part of this improvement the URL to access the desktop API has been updated.
• You will now be able to access release by version: http://static.liveops.com/api/desktop/2.0.6/desktop-api.js
• The very latest release can be accessed by using: http://static.liveops.com/api/desktop/latest/desktop-api.js

Bug Fixes:

• All connections are now stopped when Desktop API un-initialize is called (bugId: 214447).
• Desktop API initialize asynchronous errors are now thrown correctly (bugId: 214628).
• Improved timeout error message for PSAPI call (bugId: 216691).

Desktop API Release 2.0.5

Release Date (NTE): 2013-01-10

Release Date (GA): 2013-01-15

Features:

• Detection of network disconnect has been improved and extra logging for failed commands has been added (bugId: 207926)
• Network disconnect is slightly improved in case when an agent submits a command to presence server before Desktop API is aware that there is a network disconnect.

Bug Fixes:

• Time stamps are now visible at all times in the Debug logs (bugId: 204855).
• The Screen pop URL is no longer populated for campaigns that have no offers set (bugId: 204933)
• Transfer no longer fails if agent does not have hold ability enabled (bugId: 207451).

Known Issues:

• Upon restoring an existing call (e.g. loggin back in after a browser crash) the WrapupRequested event will always report "REQUESTOR_MANUAL" as the requester, because the API doesn't actually know who requested wrapup in the call restoration case (if it was manual or automatic), so it defaults to manual.
• Hold event arrives to conference recipient before CallStart.
• If an agent attempts to go online (Agent.goOnline()) at the same time as the auth token is being refreshed (happens every 15 minutes), a race condition can occur that causes the presence server to reject the specified auth token.
• LIVEOPS.desktopAPI.WorkSession#dialNumber should throw an exception if invoked while agent is not using work type TYPE_DIALOUT.

Desktop API Release 2.0.4

Release Date (NTE): 2012-11-07

Release Date (GA): 2012-11-12

Features:

• Added events PresenceRecycleStarted and PresenceRecycleFinished
• to be used to notify a client application when presence server recycle starts and presence server recycle finishes.
• Added events NetworkDisconnectStarted and NetworkDisconnectFinished
• to be used to notify a client application when Desktop API loses connection to presence server and when it re-establishes connection to presence server.
• Desktop API establises connection, on its own, to presence server after presence server recycle or network loss events occure.
• Client applications are not needed any more to catch LIVEOPS.desktopAPI.Exception.NetworkError in order to initialize establishing connection with presence server.
• LIVEOPS.desktopAPI.Exception.NetworkError
• It is not being thrown any more but it is still being kept to minimize changes in client applications.

Bug Fixes:

• None

Known Issues:

• Upon restoring an existing call (e.g. loggin back in after a browser crash) the WrapupRequested event will always report "REQUESTOR_MANUAL" as the requester, because the API doesn't actually know who requested wrapup in the call restoration case (if it was manual or automatic), so it defaults to manual.
• Hold event arrives to conference recipient before CallStart.
• If an agent attempts to go online (Agent.goOnline()) at the same time as the auth token is being refreshed (happens every 15 minutes), a race condition can occur that causes the presence server to reject the specified auth token.
• LIVEOPS.desktopAPI.WorkSession#dialNumber should throw an exception if invoked while agent is not using work type TYPE_DIALOUT.

Desktop API Release 2.0.0

Release Date (NTE): 2012-07-07

Release Date (GA): 2012-07-15

First release of Cometd based API

Bug Fixes:

• None

Known Issues:

• Upon restoring an existing call (e.g. loggin back in after a browser crash) the WrapupRequested event will always report "REQUESTOR_MANUAL" as the requester, because the API doesn't actually know who requested wrapup in the call restoration case (if it was manual or automatic), so it defaults to manual.
• Hold event arrives to conference recipient before CallStart.
• If an agent attempts to go online (Agent.goOnline()) at the same time as the auth token is being refreshed (happens every 15 minutes), a race condition can occur that causes the presence server to reject the specified auth token.
• LIVEOPS.desktopAPI.WorkSession#dialNumber should throw an exception if invoked while agent is not using work type TYPE_DIALOUT.