Legacy Dev Forum Posts

 View Only

Sign Up

Back to discussions
Expand all | Collapse all

Query all conversations that have a transcript

  • 1.  Query all conversations that have a transcript

    Posted 06-05-2025 18:33

    bsami | 2025-01-16 20:52:36 UTC | #1

    I am building an application that requires the ability to pull any conversations that have a communication transcript URL associated with them, but I am running into the issue that the SpeechAndTextAnalytics API does not have a query endpoint where I can search by interval and whether or not a transcript URL exists.

    The ideal goal is to get details on all the calls in the last X hours which have a transcript, though the only way I can tell to do this right now is by querying the conversations API (conversationsAPI: postAnalyticsConversationsDetailsQuery), performing a GET on each conversationId (conversationsAPI: getConversation), then with the communicationId from that conversation, fetching the transcript URL (speechTextAnalyticsAPI: getSpeechandtextanalyticsConversationCommunicationTranscripturl).

    This seems like an overkill way to get a list of transcripts for the last X hours, is there a better way to do it?

    Jerome.Saint-Marc | 2025-01-17 16:50:51 UTC | #2

    Hello,

    Not that I have used this API Endpoint myself. But did you have a look at the transcript search endpoint? It appears you can define a start/end times for the conversationStartTime. See the example here.

    Regards,

    bsami | 2025-02-12 18:50:15 UTC | #3

    Thanks for the response @Jerome.Saint-Marc . It seems like even giving a simple POST request like:

    {
                types: ["transcripts"],
                returnFields: ["conversationId", "communicationId"],
                query: [
                    {
                        type: "DATE_RANGE",
                        fields: ["conversationStartTime"],
                        startValue: "2025-02-06T00:00:00.000Z",
                        endValue: "2020-02-07T00:00:00.000Z",
                        dateFormat: "yyyy-MM-dd'T'HH:mm:ss.SSSX",
                    },
                ],
            }

    yields the following error:

    {
  message: 'BAD_REQUEST',
  code: 'bad.request',
  status: 400,
  messageParams: {},
  contextId: '7660fb48-8a79-42da-9df8-4ea00f653a4c',
  details: [ { errorCode: 'BAD_SEARCH_REQUEST', fieldName: 'searchCriteria' } ],
  errors: []
}

    I read in a different thread you responded in that my organization needs access to the endpoint, is this still true even though it seems the transcript search API is no longer a Preview API? Thank you!

    Jerome.Saint-Marc | 2025-02-13 08:13:54 UTC | #4

    Hello,

    I don't know which request you are using/trying. The API endpoint I was referring to is POST /api/v2/speechandtextanalytics/transcripts/search

    The thread you have referenced has nothing to do with transcripts. It is about a different endpoint - "/api/v2/conversations/participants/attributes/search" as written in this thread.

    Using POST /api/v2/speechandtextanalytics/transcripts/search, I have just tried this body and it gets a response:

    {
    "types": [
        "transcripts"
    ],
    "returnFields": [
        "conversationId",
        "communicationId"
    ],
    "query": [
        {
            "type": "DATE_RANGE",
            "fields": [
                "conversationStartTime"
            ],
            "startValue": "2025-02-06T00:00:00.000Z",
            "endValue": "2020-02-07T00:00:00.000Z",
            "dateFormat": "yyyy-MM-dd'T'HH:mm:ss.SSSX"
        }
    ]
}

    Here is the link to the endpoint in API Explorer with data set.

    Regards,

    system | 2025-03-16 08:14:02 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: 31259



Related Content