Detect trackers in conversations
You can detect trackers using the Conversations API Get conversation operation.
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.
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
Request parameter
Parameter | Description |
---|---|
Conversation ID | Required. The Conversation ID of any conversation processed after you added Trackers to Your Trackers. |
To make a sample request directly from docs, see Get conversation.
Get conversation request
To detect Trackers using the Conversations API, use:
GET https://api.symbl.ai/v1/conversations/{conversationId}/trackers`
Example request:
import fetch from 'node-fetch';
const accessToken = '<ACCESS_TOKEN>';
const conversationId = '<CONVERSATION_ID>';
const fetchResponse = await fetch(`https://api.symbl.ai/v1/conversations/{conversationId}/trackers`, {
method: get,
headers: {
'Authorization': 'Bearer ${accessToken}',
'Content-Type': 'application/json'
}
});
const responseBody = await fetchResponse.json();
console.log(responseBody);
Where:
<ACCESS_TOKEN>
is a valid API access token.<CONVERSATION_ID>
is theconversationId
of a previously processed conversation, such as5704813242220544
.
Get conversation response
[
{
"id": "5696807624507392",
"name": "Symbl.Politeness",
"matches": [
{
"type": "vocabulary",
"value": "thank you for holding",
"messageRefs": [
{
"id": "5736285873373184",
"text": "Thank you.",
"offset": -1
}
],
"insightRefs": []
},
{
"type": "vocabulary",
"value": "Please",
"messageRefs": [
{
"id": "6204786492833792",
"text": "Please correct me if I have gotten anything wrong.",
"offset": 0
}
],
"insightRefs": [
{
"text": "Please correct me if I have gotten anything wrong.",
"offset": 0,
"type": "action_item",
"id": "4816122500087808"
}
]
}
]
},
{
"id": "5757332035207168",
"name": "First Tracker ",
"matches": [
{
"type": "vocabulary",
"value": "Hello",
"messageRefs": [
{
"id": "5073351849541632",
"text": "Hi.Hello.",
"offset": 3
}
],
"insightRefs": []
},
{
"type": "vocabulary",
"value": "Hi",
"messageRefs": [
{
"id": "5073351849541632",
"text": "Hi.Hello.",
"offset": 0
}
],
"insightRefs": []
}
]
},
{
"id": "6293381870256128",
"name": "Symbl.Upsell_Opportunity",
"matches": [
{
"type": "vocabulary",
"value": "We need to upgrade our plan",
"messageRefs": [
{
"id": "4848106081353728",
"text": "We need to upgrade our plan.",
"offset": 0
}
],
"insightRefs": []
},
{
"type": "vocabulary",
"value": "We need to deploy at scale",
"messageRefs": [
{
"id": "6280979682426880",
"text": "We need to deploy at scale.",
"offset": 0
}
],
"insightRefs": []
},
{
"type": "vocabulary",
"value": "We have high volumes",
"messageRefs": [
{
"id": "6252116160020480",
"text": "We have high volumes.",
"offset": 0
}
],
"insightRefs": []
}
]
}
]
Response fields
The following fields are returned in the response body.
Field | Description |
---|---|
id | The Tracker ID, in the form of a unique integer string. |
name | The name of the detected Tracker, such as Symbl.Politeness . |
matches | The container for the following values of each detected Tracker. |
type | The type of data triggering the match is vocabulary . |
value | The phrase that triggered the match, such as thank you for holding . |
messageRefs | Identifying information for the detected message, including the id , text , and offset . |
insightRefs | Any insights generated by the detected Tracker instance. |
Updated 7 months ago