Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Twilio Voice Insights (BYOK) — connector documentation

  • MCP endpoint: https://byok-twilio-insights.connectorbay.com/mcp
  • REST API: POST https://byok-twilio-insights.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-twilio-insights.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own Twilio Voice Insights Account SID or API key SID (use a restricted API key, SID starts with SK, rather than the main Auth Token where possible), sent in the X-Upstream-Key header and the Auth Token, or the secret of the API key in X-Upstream-Key-2 of every request (never stored, logged or cached)
  • Health: https://byok-twilio-insights.connectorbay.com/health · Tool schemas: https://byok-twilio-insights.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-twilio-insights · agent@connectorbay.com

What Twilio Voice Insights (BYOK) is for

Twilio Voice Insights (BYOK) lets an AI assistant read your own Twilio Voice Insights data through the Twilio Voice Insights API with a key you supply (Account SID or API key SID (use a restricted API key, SID starts with SK, rather than the main Auth Token where possible)). Read-only: 10 tools (get_voice_insights_settings, list_call_summaries, get_call_summary, get_call_annotation, list_call_metrics, list_conference_summaries, get_conference_summary, list_conference_participant_summaries, list_video_rooms, get_video_room). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to insights.twilio.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Twilio Voice Insights. Twilio Voice Insights and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "Are Voice Insights advanced features turned on for my Twilio account?"
  • "Which of my Twilio calls failed or went unanswered recently?"
  • "How did Twilio call CA... end and how long did it last?"
  • "Was Twilio call CA... marked as spam or poor quality?"
  • "What were the jitter and packet loss metrics for Twilio call CA...?"
  • "Which Twilio conferences ended abnormally this week?"

What it does

  • get_voice_insights_settings: Show whether Voice Insights Advanced Features and Voice Trace are enabled for the account.
  • list_call_summaries: List Voice Insights call summaries (newest first by default) with call type, final state, answered-by, duration and tags. Caller and callee numbers are not returned. Advanced Features may be required for some fields.
  • get_call_summary: Get the Voice Insights summary of one call: type, final state, answered-by, duration, connect duration and tags.
  • get_call_annotation: Get the annotation attached to a call: answered-by, connectivity issue, quality issues, spam flag, call score and comment.
  • list_call_metrics: List the per-edge quality metrics of one call (carrier, SIP, SDK and client edges) as time-stamped samples.
  • list_conference_summaries: List Voice Insights conference summaries with status, duration, participant counts, end reason, mixer region and detected issues.
  • get_conference_summary: Get the Voice Insights summary of one conference: duration, participants, end reason, region, detected issues and tags.
  • list_conference_participant_summaries: List the participant summaries of one conference with label, direction, call status, role, join and leave times, region and call type. Numbers are not returned.
  • list_video_rooms: List Programmable Video rooms with analytics: type, status, duration, participant counts, media region and end reason.
  • get_video_room: Get the analytics of one video room: type, status, duration, participant counts, recording seconds and media region.

BYOK key

You bring your own Twilio Voice Insights Account SID or API key SID (use a restricted API key, SID starts with SK, rather than the main Auth Token where possible) (https://www.twilio.com/docs/iam/api-keys/keys-in-console). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to insights.twilio.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the Twilio Voice Insights API (insights.twilio.com) with a BYOK key; documentation: https://www.twilio.com/docs/voice/voice-insights/api. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Twilio Voice Insights. Twilio Voice Insights and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Twilio Voice Insights account.

Built for: Worldwide. Languages: English.