feat(docs): add customer properties definitions and values to v3.6 EUEE-1513 (#1679)

Author: wfabjanczuk

payloads/messaging/v3.6/agent-chat-api/index.js

@@ -17,6 +17,7 @@ export { default as cart } from "./other-structures/cart.json";
 export { default as cartItem } from "./other-structures/cartItem.json";
 export { default as chat } from "./other-structures/chat.json";
 export { default as chatSummary } from "./other-structures/chatSummary.json";
+export { default as customerProperty } from "./other-structures/customerProperty.json";
 export { default as formFields } from "./other-structures/formFields.json";
 export { default as filledFormFields } from "./other-structures/filledFormFields.json";
 export { default as properties } from "./other-structures/properties.json";

payloads/messaging/v3.6/agent-chat-api/other-structures/customerProperty.json

@@ -0,0 +1,6 @@
+{
+  "value": 42,
+  "last_updated_at": "2026-06-11T12:00:00Z",
+  "last_updated_agent_account_id": "464d206a-ba7d-4ce1-98d6-d03f8f14970e",
+  "last_updated_agent_client_id": "71d32c598862b01b9e2298281339dbc2"
+}

payloads/messaging/v3.6/agent-chat-api/users/customer.json

@@ -116,5 +116,13 @@
     "country": "United States",
     "state": "DC",
     "postal_code": "20500"
+  },
+  "customer_properties": {
+    "550e8400-e29b-41d4-a716-446655440000": {
+      "value": 42,
+      "last_updated_at": "2026-06-11T12:00:00Z",
+      "last_updated_agent_account_id": "464d206a-ba7d-4ce1-98d6-d03f8f14970e",
+      "last_updated_agent_client_id": "71d32c598862b01b9e2298281339dbc2"
+    }
   }
 }

src/pages/messaging/agent-chat-api/changelog/index.mdx

@@ -37,13 +37,8 @@ The developer preview version provides a preview of the upcoming changes to the
 
 ### Customers
 
-- The [**Customer**](/messaging/agent-chat-api/v3.7/data-structures#customer) data structure has new fields:
-  - `carts`, an array of [**Cart**](/messaging/agent-chat-api/v3.7/data-structures#cart) objects,
-  - `customer_properties`, a map of [**Customer Property**](/messaging/agent-chat-api/v3.7/data-structures#customer-property) objects.
 - The [**customer_updated**](/messaging/agent-chat-api/v3.7/rtm-pushes/#customer_updated) push now includes cart data.
 - The **Update Customer** ([Web](/messaging/agent-chat-api/v3.7/#update-customer) & [RTM](/messaging/agent-chat-api/v3.7/rtm-reference/#update-customer)) method now allows to clear the values of `name`, `email`, `phone_number` and `address` components by providing an empty string as the new field value.
-- There are new pushes:
-  - [customer_properties_values_updated](/messaging/agent-chat-api/v3.7/rtm-pushes/#customer_properties_values_updated)
 
 ### Other
 
@@ -79,11 +74,15 @@ The developer preview version provides a preview of the upcoming changes to the
   - [**ticket_created**](/messaging/agent-chat-api/rtm-pushes/#ticket_created)
   - [**ticket_deleted**](/messaging/agent-chat-api/rtm-pushes/#ticket_deleted)
   - [**customer_statistics_updated**](/messaging/agent-chat-api/rtm-pushes/#customer_statistics_updated)
+  - [**customer_property_definition_created**](/messaging/agent-chat-api/rtm-pushes/#customer_property_definition_created)
+  - [**customer_property_definition_updated**](/messaging/agent-chat-api/rtm-pushes/#customer_property_definition_updated)
+  - [**customer_properties_values_updated**](/messaging/agent-chat-api/rtm-pushes/#customer_properties_values_updated)
 - The [**Customer**](/messaging/agent-chat-api/data-structures#customer) data structure now contains information about phone number and omnichannel data (when available).
 - The **Update Customer** ([Web](/messaging/agent-chat-api/#update-customer) & [RTM](/messaging/agent-chat-api/rtm-reference/#update-customer)) method has new fields, `phone_number` and `omnichannel`.
 - The `omnichannel` field now supports WhatsApp data: `id`, `name`, and `phone_number`.
 - The [**Customer**](/messaging/agent-chat-api/data-structures#customer) data structure now contains the customer's `address` information.
 - The [**Customer**](/messaging/agent-chat-api/data-structures#customer) data structure has a new `carts` field containing an array of [**Cart**](/messaging/agent-chat-api/data-structures#cart) objects.
+- The [**Customer**](/messaging/agent-chat-api/data-structures#customer) data structure has a new `customer_properties` field containing a map of [**Customer Property**](/messaging/agent-chat-api/data-structures#customer-property) objects.
 - The [**customer_updated**](/messaging/agent-chat-api/rtm-pushes/#customer_updated) push now includes cart data.
 
 ### Status

src/pages/messaging/agent-chat-api/data-structures/index.mdx

@@ -436,9 +436,10 @@ It is not possible to send a System event in API version 3.6.
 | `visit`                          | optional  |                                                                                                                                                           |
 | `present`                        | optional  |                                                                                                                                                           |
 | `statistics`                     | optional  |                                                                                                                                                           |
-| `carts`                          | optional  | An array of customer's shopping carts. See [Cart](#cart) for the object structure.                                                                         |
+| `carts`                          | optional  | An array of customer's shopping carts. See [Cart](#cart) for the object structure.                                                                        |
 | `omnichannel`                    | optional  |                                                                                                                                                           |
 | `address`                        | optional  | An object of the customer's address data.                                                                                                                 |
+| `customer_properties`            | optional  | An object where the keys are the IDs of the [customer properties](#customer-property) and the values are their data.                                      |
 
 ### Cart
 
@@ -467,6 +468,20 @@ It is not possible to send a System event in API version 3.6.
 | `quantity`   | `number`           | The quantity of the item in the cart.      |
 | `variant_id` | `number`           | The variant ID of the item.               |
 
+### Customer Property
+
+Customer properties are identified by the UUID generated in the [Create customer property definition](/management/customer-data-platform-api#/paths/~1v1~1create_customer_property_definition/post) method.
+The customer property's type is set on creation by the agent.
+
+<CodeResponse version="v3.6" type="agent" title={'Sample Customer Property data structure'} json="customerProperty"/>
+
+| Field                           | Req./Opt. | Data type | Notes                                                                                      |
+| ------------------------------- | --------- | --------- | ------------------------------------------------------------------------------------------ |
+| `value`                         | required  | `any`     | The current value of the property. The type is defined by the `CustomerPropertyType` enum. |
+| `last_updated_at`               | required  | `string`  | RFC 3339 datetime string.                                                                  |
+| `last_updated_agent_account_id` | optional  | `string`  | Account ID of the agent that last set this value.                                          |
+| `last_updated_agent_client_id`  | optional  | `string`  | Client ID of the application that last set this value.                                     |
+
 # Other common structures
 
 Apart from [Events](#events) and [Users](#users), there are also other common data structures you might work with. Those are: