Legacy Dev Forum Posts

 View Only

Sign Up

Get Conversation by ContactId

  • 1.  Get Conversation by ContactId

    Posted 06-05-2025 18:23

    Frida | 2022-10-06 15:19:42 UTC | #1

    Hi there,

    I'm looking for an API to get all conversations for a specific external Contact. So far I have just found == GET /api/v2/externalcontacts/contacts/{contactId} == which does not give me any Information about corresponding conversations. There are also APIs like == GET /API/v2/analytics/conversations/details ==, in order to use them though I would need a conversationId.

    Best, Frida


    Eos_Rios | 2022-10-09 15:41:44 UTC | #2

    POST /api/v2/analytics/conversations/details/query

    { "segmentFilters": [ { "type": "and", { "predicates": [ { "type": "dimension", "dimension": "externalContactId", "operator": "matches", "value": "your id goes here" } ] }


    Frida | 2022-10-09 15:41:38 UTC | #3

    Thank you Eos_Rios for your response.

    Unfortunatelly valid Values for dimension are just: conversationEnd, conversationId, conversationInitiator, conversationStart, customerParticipation, divisionId, externalTag, mediaStatsMinConversationMos, originatingDirection.

    Do you know if customerParticipation is the same as externalContactId?


    Eos_Rios | 2022-10-10 12:56:34 UTC | #4

    Those are the conversation filter dimension. You have to use a segment filter. There are 3 different levels you can filter from in that EndPoint;

    https://developer.genesys.cloud/analyticsdatamanagement/analytics/detail/conversation-query#filter-family

    And they all have different properties. That page has some good explanations of the Conversation Query principles overall and is a good read through to get a better understanding of how it works and behaves.


    system | 2022-11-10 12:56:51 UTC | #5

    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: 16615