> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.voicebip.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.voicebip.com/_mcp/server.

# Changelog

> Release history

## April 2026

### Plan Switching (Tier Upgrades and Downgrades)

You can now change between Starter, Builder, and Scale mid-period via `PATCH /v1/workspace/subscription`. The API returns a `proration` breakdown showing the exact refund and charge for the remaining days in your billing period, plus a `quota_after` snapshot so you can see your new limits immediately. Unused quota from your old plan carries over. Plan changes are limited to once per 24 hours — a second request within the window returns `429 TIER_SWITCH_TOO_FREQUENT`.

### Balance Enforcement

When a workspace balance reaches zero, all billable operations (voice calls, SMS, WhatsApp) are automatically suspended. Calls return `402 WORKSPACE_BLOCKED`. The block lifts automatically as soon as a top-up clears via Paystack webhook — no manual action needed.

### Low Balance Email Alerts

Workspace owners now receive an email when their balance drops below the configured low-balance threshold. Alerts fire at most once per 24 hours per workspace.

### Tool Calling Support

Agents can now invoke tools during voice calls. Built-in tools (`hang_up`, `transfer_call`, `hold_call`, `resume_call`) execute via the voice pipeline. Custom tools dispatch to your webhook URL. Configure via `tool_definitions` on the agent or the dashboard Config tab.

### Agent Playground

Test your agent's AI responses with text chat via `POST /v1/agents/{id}/playground` before making live calls.

### Number Reclaim

Released numbers can now be reclaimed within the 30-day quarantine window via `POST /v1/numbers/{id}/reclaim`.

### Live Call Transcript

The dashboard Test Call tab now shows real-time transcription for both caller speech and agent AI responses via WebSocket streaming.

### Call History

Outbound calls are now persisted to the database and visible on the dashboard Calls page.

### Custom Greeting

Agents can configure a custom greeting message that plays via TTS when a call connects, replacing the default "Hello, welcome to Voicebip."

### Webhook Signing Secret Rotation

Workspaces can rotate their signing secret with a 24-hour grace period. During rotation, deliveries carry both `X-Voicebip-Signature` and `X-Voicebip-Signature-Previous` headers.

---

## v0.1.0.0 — Platform Repositioning (April 10, 2026)

Major release that repositions Voicebip from API-only to a full-stack developer experience.

### New Features

* **Agent Templates** — Pre-built configurations for Loan Recovery, Customer Support, Appointment Booking, and Payment Reminders. Create a working agent in 30 seconds via `GET /v1/templates` and `POST /v1/agents` with `template_id`.
* **Browser-Based Test Calls** — Call your AI agent directly from the dashboard using WebRTC. No phone needed. Real-time audio visualization and live transcript streaming.
* **Shareable Links** — Generate public "try my agent" URLs. Anyone can test-call from a browser without signing up. Rate-limited (10 concurrent, 50/day per agent). Enable via `PATCH /v1/agents/{id}/shareable`.
* **Conversation Analytics** — Resolution rate, average call duration, calls per day, MOS score, and sentiment trend via `GET /v1/analytics?days=7|30|90`.
* **Multi-Agent Routing** — Route inbound calls on one number to different agents based on keywords, regex, or default rules. Full CRUD via `/v1/routing-rules`.
* **Voice Quality MOS Scoring** — E-model MOS estimation per call from RTP statistics (jitter, packet loss, RTT).
* **Recording Playback** — Listen to past calls via `GET /v1/calls/{id}/recording` with range-request support. 30-day retention.
* **Conversation Export** — Download transcripts as CSV or JSON via `GET /v1/agents/{id}/conversations/export?format=csv|json`.
* **Agent Greeting Customization** — Custom `greeting_text` field for the first TTS utterance when a call connects.
* **X-Voicebip-Duration Header** — Every API response now includes request processing time.

### Changes

* Recording storage moved to persistent volumes for improved durability.
* AI circuit breaker updated for improved per-workspace isolation.
* TTS audio files cleaned up automatically (WAV files older than 5 minutes deleted every 60 seconds).

### API Changes

New endpoints: `GET /v1/templates`, `GET /v1/calls/{id}/recording`, `GET /v1/agents/{id}/conversations/export`, `GET /v1/analytics`, `POST/GET/PUT/DELETE /v1/routing-rules`, `PATCH /v1/agents/{id}/shareable`, `POST /v1/public/try/{agent_id}/offer`.

Updated schemas: `Agent` (added `greeting_text`, `shareable`), `Call` (added `quality_mos`, `resolution`, `classified_at`, `recording_url`), `CreateAgentRequest` (added `template_id`, `greeting_text`, `shareable`).

---

## What's Coming

WhatsApp direct Meta Cloud API integration (zero developer-facing changes on migration). Python SDK for server-side integrations. Pan-Africa expansion beyond Nigeria.