mcpField
R
retell

retell

github.com/gracebotlyData & databases056 installsUpdated 31w ago
Repository

About retell

Retell Platform Skill describes how Retell voice-agent call data is normalized for Getflowetic dashboards. It defines call metrics, field mappings, and dashboard templates for performance and quality monitoring.

Key features

  1. 01Call volume and success metrics
  2. 02Average duration tracking
  3. 03Agent and disconnect breakdowns
  4. 04Event field normalization mapping
  5. 05Voice analytics dashboard templates

Use cases

  1. 01Monitoring call volume and success rates
  2. 02Comparing performance across agents
  3. 03Reviewing disconnect trends and duration outliers

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gracebotly/flowetic-app --skill retell

After installing, type/retellin Claude Code to confirm it loaded.

Bundled filesfield-semantics.yaml

Details

From the project README

Retell Platform Skill

Overview

Retell is a conversational AI platform for building voice agents. Users connect Retell agents to Getflowetic to monitor call quality, track agent performance, and analyze conversation patterns.

Vocabulary

  • call: A single voice interaction between a Retell agent and a caller
  • agent: A configured Retell voice agent with an LLM backend and voice
  • call_status: Call outcome — ended or completed (success) vs other (failure)
  • disconnect_reason: Why the call ended (agent_hangup, user_hangup, error, silence, max_duration)
  • duration_ms: Call length in milliseconds
  • start_timestamp / end_timestamp: Unix timestamps for call timing

Key Metrics for Dashboards

  • Call Volume: Total calls over time — trend chart on started_at
  • Success Rate: Percentage of calls with successful outcome — hero stat
  • Avg Duration: Average call length in ms — supporting metric card
  • Agent Breakdown: Calls per agent — pie chart on agent_name/workflow_name
  • Disconnect Reasons: Why calls end — pie chart for quality monitoring

Event Field Mapping

The Retell import route normalizes call data into the standard event schema. These are the fields that appear in event.state:

Event FieldSemantic TypeDashboard Use
workflow_ididentifierMaps to agent_id — count only
workflow_namedimensionMaps to agent_name — breakdown charts
execution_idsurrogate_keyMaps to call_id — "Total Calls" KPI
statusdimensionSuccess rate percentage — hero stat
duration_msmeasure (avg)"Avg Call Duration" metric card
started_attime_dimensionTimeseries trend axis
ended_attime_dimensionDetail only
platformconstantAlways "retell" — skip

These fields also appear in event.labels:

  • agent_id, agent_name, call_id, status

Dashboard Templates

  • voice-analytics: Call volume trend, success rate, avg duration, agent breakdown
  • agent-performance: Per-agent comparison, disconnect reasons, quality metrics
  • quality-monitor: Disconnect reason trends, error rates, duration outliers

Mapping Heuristics (Legacy Aliases)

  • call_status → status
  • agent_id → workflow_id
  • agent_name → workflow_name
  • call_id → execution_id

Comments

Markdown supported