pskobel | 2024-01-31 13:04:00 UTC | #1
i am new to Genesys and need to get completed chat conversations to save into our system. which API should i be using?
tim.smith | 2024-01-31 15:21:17 UTC | #2
See https://developer.genesys.cloud/analyticsdatamanagement/analytics/
pskobel | 2024-01-31 15:55:28 UTC | #3
which endpoints should i use to get list of completed chats and loop through the chats to get the conversation between agent and customer?
tim.smith | 2024-01-31 15:58:11 UTC | #4
pskobel, post:3, topic:24409
get list of completed chats
That would be the analytics detail query.
pskobel, post:3, topic:24409
get the conversation between agent and customer
The conversation object is the data returned by analytics queries and jobs. See the previous link for that documentation. I believe you're asking for the recording of the conversation, which you would use the recording APIs for that. Those docs are adjacent to the ones above: https://developer.genesys.cloud/analyticsdatamanagement/recording/
pskobel | 2024-01-31 20:38:36 UTC | #5
is that endpoint for chat conversations? we are only using chat software in our e-commerce website
tim.smith | 2024-01-31 21:01:55 UTC | #6
Analytics and recording are available for all media types. Certain details of recordings will vary by media type, but neither analytics nor recording endpoints are segregated by media type. If you want to filter your analytics queries by media type, you can do so using with the mediaType dimension: https://developer.genesys.cloud/analyticsdatamanagement/analytics/detail/conversation-data-model#dimensions-for-sessions.
pskobel | 2024-02-06 21:34:53 UTC | #7
thank, so far this really has helped me out.
next question we pass a sessionId into the chat window and i don't see that value in the api i have called. which api will have that info?
i do see it in the portal under Participant Data called sessionID
tim.smith | 2024-02-06 21:54:33 UTC | #8
pskobel, post:7, topic:24409
next question we pass a sessionId into the chat window and i don't see that value in the api i have called. which api will have that info?
From here: https://developer.genesys.cloud/analyticsdatamanagement/analytics/jobs/conversation-details-job#differences-to-conversation-detail-queries
- Job results contain participant attributes for each conversation. The keys and values of the attributes are truncated to 1024 characters but there is no limit in analytics on the number of attributes.
Take note the section below on that page about data availability. If you need participant attribute data immediately, it's available via the conversation APIs.
pskobel | 2024-02-06 22:08:16 UTC | #9
i am looking for this data
tim.smith | 2024-02-06 22:12:10 UTC | #10
Right, participant data == participant attributes
pskobel | 2024-02-06 22:18:23 UTC | #11
i first call endpoint PostAnalyticsConversationsDetailsQuery and i get conversation in the participant model i do not see attributes section
tim.smith | 2024-02-06 23:13:06 UTC | #12
pskobel, post:11, topic:24409, full:true
i first call endpoint PostAnalyticsConversationsDetailsQuery and i get conversation in the participant model i do not see attributes section
That's working as expected.
quote="tim.smith, post:8, topic:24409"] From here: [https://developer.genesys.cloud/analyticsdatamanagement/analytics/jobs/conversation-details-job#differences-to-conversation-detail-queries
- Job results contain participant attributes for each conversation. The keys and values of the attributes are truncated to 1024 characters but there is no limit in analytics on the number of attributes.
[/quote]
This implicitly means the inverse, that queries do not have participant attributes.
pskobel | 2024-02-09 19:45:40 UTC | #13
thank you very much, every reply has been very helpful.
next question on getting the " Wrap-up Information" code. which endpoint can i use to get that?
tim.smith | 2024-02-09 21:04:55 UTC | #14
Wrap up codes are on both the conversation and analytics resources. They'll be on the participant's segment/session that assigned it.
pskobel | 2024-02-10 18:31:26 UTC | #15
thank you very much.
which api end point should i use to get all active agents
- Logged in and active but not in chat
- Logged in and active but in a chat
tim.smith | 2024-02-12 15:32:21 UTC | #16
Genesys Cloud doesn't have a concept of "logged in/out". A user has presence, however. One of the presences is offline and the rest are not offline. The concept of presence is what you should use to determine something like "is the user at work right now?". If you want to understand their ACD status, use routing status. https://developer.genesys.cloud/useragentman/presence/understanding-presence
If your app is getting conversations for the authenticated user, use GET /api/v2/conversations. If you're trying to view another user's conversations, use an analytics query with a filter for the desired user as a participant.
If you're just looking for a count of conversations for a user, use one of the get users endpoints that fits your case using expand=conversationSummary to get that count. You can expand presence for users using this method as well.
pskobel | 2024-02-12 22:02:42 UTC | #17
On the portal the agent marks themselves as available, is there a endpoint to get all users that marked themselves as available and is there a endpoint to know if currently in chat
tim.smith | 2024-02-12 22:08:15 UTC | #18
pskobel, post:17, topic:24409
is there a endpoint to get all users that marked themselves as available
analytics user status observation query
pskobel, post:17, topic:24409
is there a endpoint to know if currently in chat
See previous answer
pskobel | 2024-02-12 23:13:28 UTC | #19
thank, do u have the url to each endpoint
pskobel | 2024-02-13 14:28:18 UTC | #20
i am looking through the API endpoints and don't see one to get users. can u post which endpoint to use
tim.smith | 2024-02-13 14:58:22 UTC | #21
GET /api/v2/users
pskobel | 2024-03-04 16:30:54 UTC | #22
which endpoint and sample code will get people waiting in a queue? i just need the count of waiting for agents to answer them
system | 2024-04-04 16:31:37 UTC | #23
This topic was automatically closed 31 days after the last reply. New replies are no longer allowed.
This post was migrated from the old Developer Forum.
ref: 24409