Return conversations matching the parameters — Ada

Returns a list of conversation objects along with a status message and next_page_uri if applicable.

Query parameters

created_sincedatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

Return records that were created after this date. Note that updated_since and created_since are mutually exclusive, so you must only use one in a request.

updated_sincedatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

Return records that were updated after this date. Note that updated_since and created_since are mutually exclusive, so you must only use one in a request.

page_sizeintegerOptional>=100<=10000

Number of records to return in response. The maximum and default is 10000, the minimum is 100.

created_todatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

Return records that were created earlier than this date. If created_since is used and this parameter is not specified, this value defaults to 7 days after created_since.

updated_todatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

Return records that were updated earlier than this date. If updated_since is used and this parameter is not specified, this value defaults to 7 days after updated_since.

Response

Ada successfully processed the request.

messagestringOptional

Request status message

datalist of objectsOptional

Records returned from the query

next_page_uristringOptional

Relative link to the next page of results matching the query

1 import requests 2 3 url = "https://{bot-name}.ada.support/data_api/v1.4/conversations" 4 5 querystring = {"created_since":"2024-01-15T09:30:00Z","updated_since":"2024-01-15T09:30:00Z","page_size":"100"} 6 7 headers = {"Authorization": "Bearer <token>"} 8 9 response = requests.get(url, headers=headers, params=querystring) 10 11 print(response.json())

1 { 2 "message": "OK", 3 "data": [ 4 { 5 "_id": "5d8a7d080afd19b55945c8ab", 6 "agent_id": [ 7 "619d95c0c063a5bf2b1efb7c" 8 ], 9 "agent_name": [ 10 "Ada Lovelace" 11 ], 12 "agent_handle_time": 4, 13 "automated_resolution_classification": "Resolved", 14 "automated_resolution_classification_reason": "The bot provided a detailed step-by-step guide on how to disable auto deposits, both on the mobile app and the web version.", 15 "bot_handle_time": 4, 16 "browser": "chrome", 17 "browser_version": "95.0.4638.69", 18 "chatter_id": "5dbaef7283d791f585563d84", 19 "csat": { 20 "key": "value" 21 }, 22 "date_created": "2019-10-31T14:28:02Z", 23 "date_updated": "2019-10-31T14:28:02Z", 24 "device": "macos", 25 "end_user_id": "619d95c0c063a5bf2b1efb64e", 26 "generated_topic_id": "654952d3e90767ff49713fbf", 27 "generated_topic_label": "Billing Inquiries", 28 "generated_topic_v2_id": "654952d3e90767ff49713fb1", 29 "generated_topic_v2_title": "Password Reset Inquiries", 30 "generated_topic_v2_desc": "All conversations regarding resetting passwords", 31 "generated_topic_v2_parent_id": "654952d3e90767ff49713fb2", 32 "inquiry_summary": "The customer wanted to know how to temporarily disable auto deposits.", 33 "is_engaged": true, 34 "is_escalated": false, 35 "is_test_user": false, 36 "language": "en", 37 "metavariables": { 38 "key": "value" 39 }, 40 "oauth_channel": "sms", 41 "platform": "chat", 42 "record_last_updated": "2019-10-31T14:28:02Z", 43 "variables": { 44 "key": "value" 45 } 46 } 47 ], 48 "next_page_uri": "/data_api/conversations?updated_since=2019-12-10T20:20:07.308000%2B00:00" 49 }

1	import requests
2
3	url = "https://{bot-name}.ada.support/data_api/v1.4/conversations"
4
5	querystring = {"created_since":"2024-01-15T09:30:00Z","updated_since":"2024-01-15T09:30:00Z","page_size":"100"}
6
7	headers = {"Authorization": "Bearer <token>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())

1	{
2	"message": "OK",
3	"data": [
4	{
5	"_id": "5d8a7d080afd19b55945c8ab",
6	"agent_id": [
7	"619d95c0c063a5bf2b1efb7c"
8	],
9	"agent_name": [
10	"Ada Lovelace"
11	],
12	"agent_handle_time": 4,
13	"automated_resolution_classification": "Resolved",
14	"automated_resolution_classification_reason": "The bot provided a detailed step-by-step guide on how to disable auto deposits, both on the mobile app and the web version.",
15	"bot_handle_time": 4,
16	"browser": "chrome",
17	"browser_version": "95.0.4638.69",
18	"chatter_id": "5dbaef7283d791f585563d84",
19	"csat": {
20	"key": "value"
21	},
22	"date_created": "2019-10-31T14:28:02Z",
23	"date_updated": "2019-10-31T14:28:02Z",
24	"device": "macos",
25	"end_user_id": "619d95c0c063a5bf2b1efb64e",
26	"generated_topic_id": "654952d3e90767ff49713fbf",
27	"generated_topic_label": "Billing Inquiries",
28	"generated_topic_v2_id": "654952d3e90767ff49713fb1",
29	"generated_topic_v2_title": "Password Reset Inquiries",
30	"generated_topic_v2_desc": "All conversations regarding resetting passwords",
31	"generated_topic_v2_parent_id": "654952d3e90767ff49713fb2",
32	"inquiry_summary": "The customer wanted to know how to temporarily disable auto deposits.",
33	"is_engaged": true,
34	"is_escalated": false,
35	"is_test_user": false,
36	"language": "en",
37	"metavariables": {
38	"key": "value"
39	},
40	"oauth_channel": "sms",
41	"platform": "chat",
42	"record_last_updated": "2019-10-31T14:28:02Z",
43	"variables": {
44	"key": "value"
45	}
46	}
47	],
48	"next_page_uri": "/data_api/conversations?updated_since=2019-12-10T20:20:07.308000%2B00:00"
49	}