|
|
(2 intermediate revisions by 2 users not shown) |
Line 1: |
Line 1: |
| = API Commands = | | = API Commands = |
| | | |
− | Once you've registered your own plugin on the bus, you can call commands on other registered plugins. Below we'll quickly register a new plugin on the bus using the global bus object.
| + | {{Template:PEC_Migrated}} |
| | | |
− | {{NoteFormat|The global bus object is a debug tool. When implementing Widgets on your own site, do not use the global bus object to register your custom plugins. Instead, see [[GWCBusExtensions|Widgets Extensions]] for more information about extending Genesys Widgets.|1}}
| |
| | | |
− | <source lang='javascript'>var oMyPlugin = window._genesys.widgets.bus.registerPlugin('MyPlugin');
| |
| | | |
− | oMyPlugin.command('CallbackService.schedule', {
| + | {{NoteFormat|Documentation for this software has moved to a new home. Please update links and bookmarks to content hosted at https://all.docs.genesys.com/WID/Current/SDK/CallbackService-combined#API_Commands.}} |
− | | |
− | userData: {},
| |
− | firstname: 'Bob',
| |
− | lastname: 'Jones',
| |
− | email: 'b.jones@mail.com',
| |
− | subject: 'product questions',
| |
− | desiredTime: '2017-04-04T00:24:17.804Z',
| |
− | phonenumber: '4151110000'
| |
− | });</source>
| |
− | | |
− | == configure ==
| |
− | Internal use only. The main App plugin shares configuration settings to widgets using each widget’s configure command. The configure command can only be called once at startup. Calling configure again after startup may result in unpredictable behavior.
| |
− | | |
− | == schedule ==
| |
− | Schedule a callback service with the GMS callback schedule API.
| |
− | <br /><br />
| |
− | === Example ===
| |
− | <source lang='javascript'>
| |
− | oMyPlugin.command('CallbackService.schedule', {
| |
− | | |
− | userData: {},
| |
− | firstname: 'Bob',
| |
− | lastname: 'Jones',
| |
− | email: 'b.jones@mail.com',
| |
− | subject: 'product questions',
| |
− | desiredTime: '2017-03-03T00:24:17.804Z',
| |
− | email: 'b.jones@mail.com',
| |
− | phonenumber: '4151110000'
| |
− | | |
− | }).done(function(e){
| |
− | | |
− | // CallbackService scheduled successfully
| |
− | | |
− | }).fail(function(e){
| |
− | | |
− | // CallbackService failed to schedule
| |
− | });
| |
− | </source>
| |
− | | |
− | <br />
| |
− | === Options ===
| |
− | {|
| |
− | |-
| |
− | ! Option
| |
− | ! Type
| |
− | ! Description
| |
− | |-
| |
− | | firstname
| |
− | | string
| |
− | | Receive a Call entry Form Data: 'firstname'.
| |
− | |-
| |
− | | lastname
| |
− | | string
| |
− | | Receive a Call entry Form Data: 'lastname'.
| |
− | |-
| |
− | | phonenumber
| |
− | | string
| |
− | | Receive a Call entry Form Data: 'phonenumber'.
| |
− | |-
| |
− | | subject
| |
− | | string
| |
− | | Receive a Call entry Form Data: 'notes'.
| |
− | |-
| |
− | | email
| |
− | | string
| |
− | | Receive a Call entry Form Data: 'email'.
| |
− | |-
| |
− | | desiredtime
| |
− | | string
| |
− | | The preferred desired time user would like to get the callback scheduled. Time should be in UTC format.
| |
− | |-
| |
− | | userData
| |
− | | object
| |
− | | Arbitrary data that is to be attached with callback schedule. Properties defined here will be merged with default userData set in the configuration object.
| |
− | |-
| |
− | |}
| |
− | <br />
| |
− | === Resolutions ===
| |
− | {|
| |
− | |-
| |
− | ! Status
| |
− | ! When
| |
− | ! Returns
| |
− | |-
| |
− | | resolved
| |
− | | When server confirms callback is scheduled.
| |
− | | (AJAX Response Object)
| |
− | |-
| |
− | | rejected
| |
− | | When selected timeslot is not available.
| |
− | | (AJAX Response Object)
| |
− | |-
| |
− | | rejected
| |
− | | When AJAX exception occurs.
| |
− | | (AJAX Response Object)
| |
− | |-
| |
− | | rejected
| |
− | | When server exception occurs.
| |
− | | (AJAX Response Object)
| |
− | |-
| |
− | | rejected
| |
− | | When no form data is found to schedule callback.
| |
− | | 'No data found to schedule callback'
| |
− | |-
| |
− | |}
| |
− | == availability ==
| |
− | Get the list of available callback timeslots via GMS callback service.
| |
− | <br /><br />
| |
− | === Example ===
| |
− | <source lang='javascript'>
| |
− | oMyPlugin.command('CallbackService.availability', {
| |
− | | |
− | startDate: '2017-04-03T00:24:17.804Z',
| |
− | numberOfDays: '5',
| |
− | maxTimeSlots: 20
| |
− | | |
− | }).done(function(e){
| |
− | | |
− | // CallbackService successfully showing availability
| |
− | | |
− | }).fail(function(e){
| |
− | | |
− | // CallbackService failed to show availability
| |
− | });
| |
− | </source>
| |
− | | |
− | <br />
| |
− | === Options ===
| |
− | {|
| |
− | |-
| |
− | ! Option
| |
− | ! Type
| |
− | ! Description
| |
− | |-
| |
− | | startDate
| |
− | | string
| |
− | | The start date is specified in ISO 8601 format, using UTC as the timezone (yyyy-MM-ddTHH:mm:ss.SSSZ).
| |
− | |-
| |
− | | endDate
| |
− | | string
| |
− | | The end date is specified in ISO 8601 format, using UTC as timezone (yyyy-MM-ddTHH:mm:ss.SSSZ). If neither endDate nor numberOfDays is specified, the end date is assumed to be the same as the start date.
| |
− | |-
| |
− | | numberOfDays
| |
− | | string
| |
− | | Used as an alternative to the end date. If neither endDate nor numberOfDays is specified, the end date is assumed to be the same as the start date.
| |
− | |-
| |
− | | maxTimeSlots
| |
− | | number
| |
− | | The maximum number of time slots to be included in the response.
| |
− | |-
| |
− | |}
| |
− | <br />
| |
− | === Resolutions ===
| |
− | {|
| |
− | |-
| |
− | ! Status
| |
− | ! When
| |
− | ! Returns
| |
− | |-
| |
− | | resolved
| |
− | | When server confirms the list of available callback timeslots.
| |
− | | (AJAX Response Object)
| |
− | |-
| |
− | | rejected
| |
− | | When timeslots are available for selected period.
| |
− | | (AJAX Response Object)
| |
− | |-
| |
− | | rejected
| |
− | | When AJAX exception occurs.
| |
− | | (AJAX Response Object)
| |
− | |-
| |
− | | rejected
| |
− | | When server exception occurs.
| |
− | | (AJAX Response Object)
| |
− | |-
| |
− | | rejected
| |
− | | When no query data is found.
| |
− | | 'No query parameters passed for callback availability service'
| |
− | |-
| |
− | |}
| |
| | | |
| [[Category:V:PSAAS:Public]] | | [[Category:V:PSAAS:Public]] |