Messaging Contacts Report
Overview
The Messaging Contacts Report provides detailed information about all digital interactions at the conversation level, such as interaction ID, channel type, interaction status, notes and dispositions, agent info, contact person info, etc.
Interaction
An interaction consists of the full activity of communication between agents and callers, and contacts are subsets of an interaction (transfers or fallbacks to different ring groups).
Usage
Specify messaging_contacts as report type in the Explore API request path: /data/reports/messaging_contacts/jobs.
Report Example
{
"entries": [{
"channel_type": "SMS",
"contact_assigned_at": "2022-08-19 07:46:11",
"contact_duration": 0.0009259259,
"contact_finished_at": "2022-08-19 07:47:31",
"contact_finished_reason": "MANUALLY CLOSED",
"contact_handle_time": "0d 0h 0m 42s",
"contact_id": "dc840686-9159-43a5-94fb-54fa2b0ee83a",
"contact_person_channel_identifier": "+13308993827",
"contact_person_id": "618ccc879fe88900194d5317",
"contact_person_name": "",
"contact_started_at": "2022-08-19 07:46:11",
"conversation": "https://demo.talkdeskapp.com/atlas/apps/conversation-history/SMS/35d4a62d02ce473b878c20a8b3a3b7ce",
"direct_assignment_user_id": null,
"direct_assignment_user": null,
"direction": "Outbound",
"disposition_name": null,
"first_response_time": "0d 0h 0m 30s",
"handling_queues": "agents + julie",
"interaction_duration": 0.0009837963,
"interaction_finished_at": "2022-08-19 07:47:36",
"interaction_handle_time": "0d 0h 0m 42s",
"interaction_id": "35d4a62d02ce473b878c20a8b3a3b7ce",
"interaction_started_at": "2022-08-19 07:46:11",
"interaction_status": "CLOSED",
"is_virtual_agent": "NO",
"notes": null,
"queues": "agents + julie",
"touchpoint_identifier": "+17742512323",
"touchpoint_name": "xianyan test111",
"transfer_out": "No",
"user_id": "620f632ce8eca350158310d0",
"user_name": "Pablo Diego",
"virtual_agent_id": null,
"virtual_agent_name": null,
"wrap-up_duration": 0.00005787037
}, {
"channel_type": "EMAIL",
"contact_assigned_at": "2022-08-23 02:50:38",
"contact_duration": 0.7526852,
"contact_finished_at": "2022-08-23 02:58:43",
"contact_finished_reason": "MANUALLY CLOSED",
"contact_handle_time": "0d 0h 0m 45s",
"contact_id": "c12ba758-5167-403a-aa11-e0f2fac43f3a",
"contact_person_channel_identifier": "[email protected]",
"contact_person_id": "63034439faba8c001eaaefda",
"contact_person_name": "",
"contact_started_at": "2022-08-22 08:54:50",
"conversation": "https://demo.taldeskapp.com/atlas/apps/conversation-history/EMAIL/f5a626721e914762bf049c711ec8084b",
"direct_assignment_user_id": null,
"direct_assignment_user": null,
"direction": "Outbound",
"disposition_name": null,
"first_response_time": "0d 0h 0m 30s",
"handling_queues": "jiali",
"interaction_duration": 0.75309026,
"interaction_finished_at": "2022-08-23 02:58:48",
"interaction_handle_time": "0d 0h 0m 45s",
"interaction_id": "f5a626721e914762bf049c711ec8084b",
"interaction_started_at": "2022-08-22 08:54:20",
"interaction_status": "CLOSED",
"is_virtual_agent": "NO",
"notes": null,
"queues": "jiali",
"touchpoint_identifier": "[email protected]",
"touchpoint_name": "testGmail",
"transfer_out": "No",
"user_id": "616d0559a89c8e632282d95a",
"user_name": "Jiali Xiang",
"virtual_agent_id": null,
"virtual_agent_name": null,
"wrap-up_duration": 0.00005787037
}],
"total": 220
}
Data and Report Availability
Up to a month of data per request.
There are no limits on the data availability regarding timeframe.
Messaging Contacts Report @ Explore API vs @ Reporting API - Data Availability and Data Freshness
Regarding data freshness, there is no difference between the Explore API and Reporting API. Both share the same assumptions of data and report availability.
Troubleshooting
If you have questions or technical issues, please open a ticket using this form.
Updated 8 months ago