Two new Telnyx-managed insights, Agent Instruction Following and User Satisfaction, are now available for AI Assistants. These built-in insights measure assistant quality out of the box, with no prompt engineering or custom schema design required.
GET /ai/conversations/conversation-insights/aggregates
. Group by score
, metadata.assistant_id
, metadata.assistant_version_id
, or metadata.telnyx_conversation_channel
. Filter by insight_id
and created_at
range to build per-day time series.To enable these insights on an assistant, add them to an Insight Group first: AI > Insights > AI Insight Groups tab > create or edit a group > search for and add Agent Instruction Following and User Satisfaction > save. Then assign the group to your assistant under Analysis > Insights sub-tab.
To query aggregated insight counts via API:
curl -X GET "https://api.telnyx.com/v2/ai/conversations/conversation-insights/aggregates?group_by=score&group_by=metadata.assistant_version_id&metadata.assistant_id=eq.<your-assistant-id>&insight_id=<insight-id>&created_at=gte.2025-07-01T00:00:00Z&created_at=lt.2025-07-08T00:00:00Z" \
-H "Authorization: Bearer $TELNYX_API_KEY"
Response:
{
"data": [
{ "score": "excellent", "metadata": { "assistant_version_id": "v1" }, "record_count": 142 },
{ "score": "good", "metadata": { "assistant_version_id": "v1" }, "record_count": 38 },
{ "score": "excellent", "metadata": { "assistant_version_id": "v2" }, "record_count": 98 },
{ "score": "good", "metadata": { "assistant_version_id": "v2" }, "record_count": 71 }
]
}
Learn more in the Telnyx-managed insights guide, the Insight Groups docs, or the Aggregate Conversation Insights API reference.