You can detect trackers in real-time using Detect trackers in streaming conversations, or you can Detect trackers after the conversation.

Before detecting trackers, you need to select one or more trackers from the Managed Trackers Library or create your own Custom Trackers.

After selecting or creating trackers, you need to process a conversation. All trackers in Your Trackers are applied when you process a conversation. By default, trackers are enabled for all conversations.

Detect trackers after the conversation

You can detect trackers using the Conversations API Get conversation operation.

Authentication

Before using this API, you must generate your authentication token (AUTH_TOKEN) as described in Authenticate.

Use Case

You recently selected some trackers from the Managed Trackers Library. Then you processed a conversation and have the conversation ID. You need to see the which trackers were detected. Then you can analyze the results and decide if you want to edit one of the Managed Trackers or create your own custom tracker.

Get conversation

GET https://api.symbl.ai/v1/conversations/{conversationId}/trackers

To make a request from the API reference, see Get conversation.

Detect trackers in streaming conversations

For streaming conversations, Symbl.ai uses the WebSocket protocol to process audio and provide conversation intelligence in real time. When you process a streaming conversation, all the Trackers in Your Trackers are automatically detected.

Before processing a streaming conversation, select one or more Trackers from the Managed Trackers Library or create your own Custom Trackers.

There are a few different methods of setting up your streaming conversations. For more information, see Streaming API.

After a streaming conversation ends and processing is complete, you can detect trackers using the Conversations API Get Conversation operation.

Interim results are available as described in Interim Results.

Request body example

{
    "type": "start_request",
    "insightTypes": [
      "question",
      "action_item"
    ],
    "config": {
      "confidenceThreshold": 0.9,
      "speechRecognition": {
        "encoding": "LINEAR16",
        "sampleRateHertz": 44100
      },
      "meetingTitle": "Client Meeting",
      "trackers": {
        "enableAllTrackers": true, // default is true
        "interimResults": true // default is false
      }
    },
    "speaker": {
      "userId": "[email protected]",
      "name": "Jane"
    } 
}

Request parameters

Disable trackers

Trackers are enabled by default for all conversations. If you need to disable Trackers, change "enableAllTrackers": true to "enableAllTrackers": false in the preceding example.

Interim results

With interim results enabled, you can view trackers from transcripts in progress. Use interim results to detect trackers in time-critical situations before transcription is complete.

Interim results are disabled by default. To enable interim results, set "interimResults": true as shown in the previous example. When you set “interimResults”: true, detected trackers are included in an interim transcription request.

If you set “interimResults”: false, trackers are only detected in the final transcript.

Response

{
    "type": "tracker_response",
    "trackers": [
      {
        "id": "4476908732794496",
        "name": "Documents",
        "matches": [
          {
            "value": "Documents",
            "messageRefs": [
              {
                "id": "53867534-0459-4d22-b590-984ee82166aa",
                "text": "Anyways, so I will submit documents tomorrow.",
                "offset": 26
              },
              {
                "id": "4d20d90c-50a7-4594-bb10-2995dcd4bbd1",
                "text": "I will submit documents tomorrow.",
                "offset": 14
              }
            ]
            "insightRefs": []
          }
        ]    
      }
    ]
}

Response fields

The following fields are returned in the response body.