Available from CRM.COM R14.2.0
This method provides the ability to provide feedback for a specific job (upon its completion)
Resource URL
Parameters
Name | Type | Description | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
token | String | The token retrieved from the login method | |||||||||||||||||||||
feedback_type (mandatory) | String | The feedback's type. Available options are:
| |||||||||||||||||||||
job_identifier (semi-optional) | Job Identifier | The identifier of the job that the feedback will be provided for. The job must be in a completed Life Cycle State, and only one feedback can be provided per Job. The allowed job identifier fields are the following:
| |||||||||||||||||||||
service_request_identifier (semi-optional) | Service Request Identifier | The identifier of the service request that the feedback will be provided for. The Service Request must be in a completed Life Cycle State, and only one feedback can be provided per Service Request. The allowed service request identifier fields are the following:
| |||||||||||||||||||||
unit_identifier (semi-optional) | Unit Identifier | The identifier of the unit that the feedback will be provided for. If the job_identifier or the service_request_identifier are provided, then the unit is automatically provided as well. The allowed unit identifier fields are the following:
| |||||||||||||||||||||
feedback_classification_identifier (mandatory) | Feedback Classification Identifier | The identifier of the feedback's classification. The allowed feedback classification fields are the following:
| |||||||||||||||||||||
rate (mandatory) | Number | The rate provided by the customer. The rating number should range between 0 and 10 (inclusive). | |||||||||||||||||||||
comments (optional) | String | The comments provided by the customer | |||||||||||||||||||||
contact_identifier (mandatory) | Contact Information identifier | The contact that provided the feedback. The allowed contact identifier fields are the following:
| |||||||||||||||||||||
submitted_on (mandatory) | Date | The date that the feedback was submitted | |||||||||||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved feedback |
number | string | The number of the retrieved feedback |
type | String | The feedback's type. Available options are:
|
rating | Number | The rate of the retrieved feedback |
comments | String | The comments of the retrieved feedback |
performed_on | Date | The date that the feedback was submitted |
contact_information | Contact Information Object | The contact that provided the retrieved feedback |
job | Job Object | The job for which the feedback was provided |
service_request | Service Request Object | The service request for which the feedback was provided |
unit | Unit Object | The unit for which the feedback was provided Deprecated from CRM.COM R18.0.0 |
business_unit | Business Unit Object | The business unit for which the feedback was provided Available from CRM.COM R18.0.0 |
feedback_classification | Feedback Classification Object | The feedback's classification |
Log Information Object | The log information related with the retrieved job |
Referred Objects Response Data
Examples