POST customer_events/social_media/list
Deprecated from CRM.COM R15.0.0 onwards. This functionality will be provided through achievement customer events
This method returns information related with social media customer events. Multiple social media customer events are returned by each call
Resource URL
Parameters
Name | Type | Description | |||||||||||||||||||||||||||
token | String | The token retrieved from the login method | |||||||||||||||||||||||||||
rewards_participant_identifier (semi-optional) | Rewards Participant Identifier | The identifier of the rewards participant related with the customer events that should be retrieved. The allowed rewards participant identifier fields are the following:
| |||||||||||||||||||||||||||
accounts_receivable_identifier (semi-optional) | Accounts Receivable Identifier | The identifier of the accounts receivable related with the customer events that should be retrieved. The allowed accounts receivable identifier fields are the following:
| |||||||||||||||||||||||||||
classification_identifier (semi-optional) | Customer Event Classification Identifier | The identifier of the classification related with the customer events that should be retrieved. The allowed customer event classification identifier fields are the following:
| |||||||||||||||||||||||||||
submitted_after_date (optional)
| Date | if specified then information related with social media customer events that was submitted after the specified date should be retrieved Available from CRM.COM R12.2.0 | |||||||||||||||||||||||||||
submitted_before_date (optional) | Date | if specified then information related with social media customer events that was submitted before the specified date should be retrieved Available from CRM.COM R12.2.0 | |||||||||||||||||||||||||||
number_of_results (optional) | Number | The number of results that can be retrieved through each call Available from CRM.COM R13.0.0 | |||||||||||||||||||||||||||
offset (optional) | Number | Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number Available from CRM.COM R13.0.0 | |||||||||||||||||||||||||||
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 social media customer event |
number | String | The number of the retrieved social media customer event |
type | String | The type of the retrieved social media customer event which in this case is set to SOCIAL_MEDIA |
life_cycle_state | String | The life cycle state of the customer event which can be POSTED or CANCELLED |
performed_on | Date | The date that the customer event was actually performed |
description | String | A description of the customer event |
process_immediately | boolean | Defines if the customer event was processed immediately by various business processes or not |
social_media | String | The social media related with the customer event, which can be one of the following: FACEBOOK |
profile | String | The social media profile related with the customer event |
action | String | The social media action that was performed. The following actions per social media are supported (if the social media is set to Facebook) LIKE |
external_system | String | Defines the third party system that generated the customer event Available from CRM.COM R10.0.0 |
external_system_reference_number | String | Defines the unique reference number of the customer event in the external system Available from CRM.COM R10.1.0 |
total_awarded_amount | Number | The total amount that was awarded for the customer event Available from CRM.COM R13.1.0 |
total_awarded_alternative_amount | Number | The total amount that was awarded for the customer event in the alternative currency. Available from CRM.COM R14.2.0 |
udf_string_1 | String | User Defined Field of type String |
udf_string_2 | String | User Defined Field of type String |
udf_string_3 | String | User Defined Field of type String |
udf_string_4 | String | User Defined Field of type String |
udf_string_5 | String | User Defined Field of type String |
udf_string_6 | String | User Defined Field of type String |
udf_string_7 | String | User Defined Field of type String |
udf_string_8 | String | User Defined Field of type String |
udf_float_1 | Float | User Defined Field of type Float |
udf_float_2 | Float | User Defined Field of type Float |
udf_float_3 | Float | User Defined Field of type Float |
udf_float_4 | Float | User Defined Field of type Float |
udf_date_1 | Date | User Defined Field of type Date |
udf_date_2 | Date | User Defined Field of type Date |
udf_date_3 | Date | User Defined Field of type Date |
udf_date_4 | Date | User Defined Field of type Date |
classification | Customer Event Classification Object | The classification of the customer event |
accounts_receivable | Accounts receivable Object | The related accounts receivable |
performed_by_unit | Unit Object | The unit that initiated the customer event |
Log Information Object | The log information related with the retrieved invoice | |
award_reward_transactions_set | Set of Award Reward Transaction Object | The award reward transactions that were created as a result of the social media customer event |
Referred Objects Response Data