retell
Mapping guidance for Retell AI voice agent events. Covers call metrics, agent performance, disconnect reasons, and conversation analytics.
How do I install this agent skill?
npx skills add https://github.com/gracebotly/flowetic-app --skill retellIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides mapping guidance and semantic rules for Retell AI voice agent events. It contains no executable code, remote dependencies, or sensitive operations.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1/2 files flagged
What does this agent skill do?
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 —
endedorcompleted(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 Field | Semantic Type | Dashboard Use |
|---|---|---|
| workflow_id | identifier | Maps to agent_id — count only |
| workflow_name | dimension | Maps to agent_name — breakdown charts |
| execution_id | surrogate_key | Maps to call_id — "Total Calls" KPI |
| status | dimension | Success rate percentage — hero stat |
| duration_ms | measure (avg) | "Avg Call Duration" metric card |
| started_at | time_dimension | Timeseries trend axis |
| ended_at | time_dimension | Detail only |
| platform | constant | Always "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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/gracebotly/flowetic-app/retell">View retell on skillZs</a>