feat: agent-api: change field name from last_visit to visit in customer object v3.6 (#1575)

wfabjanczuk · web-flow · commit c3c524613cd9 · 2025-07-17T11:16:52.000+02:00
diff --git a/payloads/messaging/v3.6/agent-chat-api/other-structures/chat.json b/payloads/messaging/v3.6/agent-chat-api/other-structures/chat.json
@@ -64,7 +64,7 @@
       "type": "customer",
       "present": true,
       "created_at": "2019-11-02T19:19:50.625101Z",
-      "last_visit": {
+      "visit": {
         "started_at": "2020-05-12T11:32:03.497479Z",
         "ended_at": "2020-05-12T11:33:33.497000Z",
         "ip": "<customer_ip>",
diff --git a/payloads/messaging/v3.6/agent-chat-api/other-structures/chatSummary.json b/payloads/messaging/v3.6/agent-chat-api/other-structures/chatSummary.json
@@ -32,7 +32,7 @@
       "type": "customer",
       "present": true,
       "created_at": "2019-11-02T19:19:50.625101Z",
-      "last_visit": {
+      "visit": {
         "started_at": "2020-05-12T11:32:03.497479Z",
         "ended_at": "2020-05-12T11:33:33.497000Z",
         "ip": "<customer_ip>",
diff --git a/payloads/messaging/v3.6/agent-chat-api/users/customer.json b/payloads/messaging/v3.6/agent-chat-api/users/customer.json
@@ -5,7 +5,7 @@
   "email": "t.anderson@example.com",
   "email_verified": false,
   "avatar": "https://example.com/avatars/1.png",
-  "last_visit": {
+  "visit": {
     "started_at": "2017-10-12T15:19:21.010200Z",
     "ended_at": "2017-10-12T15:21:01.000000Z",
     "referrer": "http://www.google.com/",
diff --git a/src/pages/messaging/agent-chat-api/changelog/index.mdx b/src/pages/messaging/agent-chat-api/changelog/index.mdx
@@ -40,8 +40,9 @@ The developer preview version provides a preview of the upcoming changes to the
 
 - The **List Customers** method was removed.
 - The **Subscribe Customers** ([RTM](/messaging/agent-chat-api/v3.6/rtm-reference/#subscribe_customers)) and **Unsubscribe Customers** ([RTM](/messaging/agent-chat-api/v3.6/rtm-reference/#unsubscribe_customers)) methods along with a [**subscribed_customers_totals_updated**](/messaging/agent-chat-api/v3.6/rtm-pushes/#subscribed_customers_totals_updated) push were added.
+- The name of the `last_visit` field was changed to `visit` in the [**Customer**](/messaging/agent-chat-api/v3.6/data-structures#customer) data structure.
 - The [**Customer**](/messaging/agent-chat-api/v3.6/data-structures#customer) data structure now contains information about HelpDesk tickets (when available).
-- There are new pushes: 
+- There are new pushes:
   - [**ticket_created**](/messaging/agent-chat-api/v3.6/rtm-pushes/#ticket_created)
   - [**ticket_deleted**](/messaging/agent-chat-api/v3.6/rtm-pushes/#ticket_deleted)
 
diff --git a/src/pages/messaging/agent-chat-api/v3.6/data-structures/index.mdx b/src/pages/messaging/agent-chat-api/v3.6/data-structures/index.mdx
@@ -413,7 +413,7 @@ It is not possible to send a System event in API version 3.6.
 | `session_fields`                 | optional  | An array of custom object-enclosed `key:value` pairs. Expires along with the session.                                                                     |
 | `name`                           | optional  |                                                                                                                                                           |
 | `events_seen_up_to`              | optional  | RFC 3339 datetime string                                                                                                                                  |
-| `last_visit`                     | optional  |                                                                                                                                                           |
+| `visit`                          | optional  |                                                                                                                                                           |
 | `present`                        | optional  |                                                                                                                                                           |
 | `statistics`                     | optional  |                                                                                                                                                           |
 
diff --git a/src/pages/messaging/agent-chat-api/v3.6/index.mdx b/src/pages/messaging/agent-chat-api/v3.6/index.mdx
@@ -1832,7 +1832,7 @@ Returns the info about the Customer with a given `id`.
 | `created_at`     | string    | Specifies when the customer's identity was created.                                                                               |
 | `session_fields` | []object  | An array of custom object-enclosed `key:value` pairs. Returned only if set. Available for the session duration.                   |
 | `statistics`     | object    | Counters for started threads, opened pages, etc.                                                                                  |
-| `last_visit`     | object    | Geolocation and opened pages from the customer's most recent online visit. Returned only if the customer logged in at least once. |
+| `visit`          | object    | Geolocation and opened pages from the customer's most recent online visit. Returned only if the customer logged in at least once. |
 | `chat_ids`       | []string  | IDs of a customer's chats. Returned only if the customer had at least one chat.                                                   |
 
 </Text>
@@ -1865,7 +1865,7 @@ https://api.livechatinc.com/v3.6/agent/action/get_customer \
   }, {
     "another_custom_key": "another_custom_value"
   }],
-  "last_visit": {
+  "visit": {
     "started_at": "2017-10-12T15:19:21.010200Z",
     "ended_at": "2017-10-12T15:20:22.010200Z",
     "referrer": "http://www.google.com/",
diff --git a/src/pages/messaging/agent-chat-api/v3.6/rtm-reference/index.mdx b/src/pages/messaging/agent-chat-api/v3.6/rtm-reference/index.mdx
@@ -85,7 +85,7 @@ The `filters`, `limit`, and `sort_order` parameters can't be provided along with
 
 ## Calling the API as a bot
 
-Sometimes, you want to [send an event as a bot](#send-event). To do it, you need to have a token that allows you to send it. The token can be easily generated for an agent, but you cannot generate a token for a bot. The other time you want to [add a user to your chat](#add-user-to-chat), and this user happens to be a bot in the group with no access to this chat, so you cannot add it.  
+Sometimes, you want to [send an event as a bot](#send-event). To do it, you need to have a token that allows you to send it. The token can be easily generated for an agent, but you cannot generate a token for a bot. The other time you want to [add a user to your chat](#add-user-to-chat), and this user happens to be a bot in the group with no access to this chat, so you cannot add it.
 
 In both situations, the `Author-Id` header is what you need to include in your request. With it, you can authorize using the agent’s token and send the event as a bot or add a bot to a chat even if the bot belongs to the group that has no access to this chat.
 
@@ -2018,7 +2018,7 @@ Returns the info about the Customer with a given `id`.
 | `created_at`     | string    | Specifies when the customer's identity was created.                                                                               |
 | `session_fields` | []object  | An array of custom object-enclosed `key:value` pairs. Returned only if set. Available for the session duration.                   |
 | `statistics`     | object    | Counters for started threads, opened pages, etc.                                                                                  |
-| `last_visit`     | object    | Geolocation and opened pages from the customer's most recent online visit. Returned only if the customer logged in at least once. |
+| `visit`          | object    | Geolocation and opened pages from the customer's most recent online visit. Returned only if the customer logged in at least once. |
 | `chat_ids`       | []string  | IDs of a customer's chats. Returned only if the customer had at least one chat.                                                   |
 
 </Text>
@@ -2055,7 +2055,7 @@ Returns the info about the Customer with a given `id`.
     }, {
       "another_custom_key": "another_custom_value"
     }],
-    "last_visit": {
+    "visit": {
       "started_at": "2017-10-12T15:19:21.010200Z",
       "ended_at": "2017-10-12T15:20:22.010200Z",
       "referrer": "http://www.google.com/",
@@ -2422,7 +2422,7 @@ Removes the agent from the list of customer's followers. Calling this method on
 
 ### Subscribe Customers
 
-Creates a subscription for tracking customers based on the group they belong to. The response will contain customers currently matching the criteria. After a successful subscription, the agent will receive pushes about tracked customers on this RTM connection. 
+Creates a subscription for tracking customers based on the group they belong to. The response will contain customers currently matching the criteria. After a successful subscription, the agent will receive pushes about tracked customers on this RTM connection.
 
 If the number of tracked customers exceeds the limit, the `subscribed_customers_totals_updated` push will be periodically sent to indicate the total number of customers matching the criteria at the given moment.
 
