Start Service
POST /services/start
| |
Available since: 8.0.200.00
|
Description
Starts a service based on:
- The service type passed in the body.
- The contact information available (customer ID or contact key for later lookup).
If your application does not assign a customer ID, your service is anonymous. In that case, your application must assign a contact key. For further information, read the following pages:
Your application is not responsible for the service ID creation. UCS automatically assigns 64-bit integer IDs to the created services.
Operation
ID | CV.WS.SRV.1 | |||
---|---|---|---|---|
Method | POST | |||
URL | /services/start | |||
Field Name | Type | Mandatory | Description | |
Body: Service Start Event<ref>The body of this operation is mandatory and makes use of the Service Start Event.</ref> | ||||
customer_id | string | yes if no contact_key | The unique ID of the customer associated with the given service. Services with no customer_id are anonymous. In this case, the event should include a contact_key. | |
contact_key | string | yes if no customer_id | Key for later lookup of the service. This contact_key is mandatory if no customer ID is specified. For example, the application might store a PIN or ANI as the contact key when the service is first started. Later, if the customer is identified then the contact key is used to lookup the existing service record and associate it with the customer. | |
service_type | long or string | yes | The unique ID associated with the type of service, typically the DB ID of a value in the Service Type Business Attribute<ref name="business">
Refer to Configuration Options for more details on Business Attribute mapping.</ref>. | |
session_id | string | no | The ID of the related session, for instance, the orchestration session, or any other business session. | |
interaction_id | string | no | The ID of the related Genesys interaction. This ID can be used by other Genesys reporting products such as Stat Server, URS, Composer, and GVP. | |
application_type | long or string | no | The unique ID associated with the type or class<ref name="business" />application issuing the service event. May be used to group related applications, potentially across resource types. | |
application_id | integer | no | The unique ID (Genesys DB ID) for the application issuing the service event, such as a GVP VoiceXML application or an Orchestration SCXML application. | |
resource_type | long or string | no | The unique ID associated with the type or class<ref name="business"/> of resource which provides the service (such as GVP, Agent Desktop, or Orchestration). | |
resource_id | integer | no | The unique DB ID for the specific resource which provides the service. For instance:
| |
media_type | long or string | no | The media type<ref name="business"/> applicable to the given service, for instance, e-mail, voice, chat, etc. | |
est_duration | integer | no | The estimated service duration in seconds. | |
timestamp | date/time | no | The UTC time at which the event was raised, with a precision of milliseconds, using the ISO 8601 representation : [YYYY]-[MM]-[DD]T[HH]:[mm]:[ss].[SSS]Z . If the application does not specify this timestamp, the server does it when the event is processed.
| |
<extension n> Supported since 8.0.2
|
Extension (single-valued) or Extension[] (multi-valued) |
no | Service extensions, where <extension n> corresponds to the unique name of the service extension. Your application can specify as many extensions as needed as long as they were previously defined with the Create Service Extension Schema operation. |
<references />
Response
The Context Management Service API answers with HTTP codes for every request. The following table shows the correct response for a successful request. See HTTPResponseCodesandErrors for further details on the possible codes that this operation can return.
HTTP code | 201 |
---|---|
HTTP message | Created |
Header | Location: ${base_uri}/service/${service_id}
where:
|
Body | {"service_id": ${service_id}}
where:
|
Example
Operation
POST /services/start { "timestamp": "2009-05-12T12:05:12.145Z", "interaction_id": "123ABCAADFJ1259ACF", "application_type":400, "application_id":40, "est_duration":60, "contact_key":"42", "service_type":100, "media_type": 1, "resource_id": 5005, "resource_type": 2, "disposition": 10, "coupon": { "coupon_name": "DISCOUNTCODE15" }, "satisfaction": { "score": 85, "agentID": 2025 }, "relatedOffers": [ { "offer_name":"VIP credit card black ed.", "type":9, "comments":"proposed to all client" }, { "offer_name":"3 times payment GOLD", "type":4, "comments":"limited offer" } ,{ "offer_name":"life insurance", "type":3, "comments":"healt check to be done before approval" } ] }
Result
HTTP 201 Created location: /services/12349857 {"service_id": 12349857}
This page was last edited on November 23, 2017, at 16:00.
Comments or questions about this documentation? Contact us for support!