Documentation
How to build voicast, a voice AI agent for phone calls, the web and apps, into your product through the API, MCP and SDK.
voicast is a conversational AI platform for developers. Your product (typically a SaaS) brings the phone numbers and the customers; voicast answers the call, greets the caller, collects what you ask for, answers frequent questions and hands off to a person when needed. After the call you get the outcome, the collected fields, a transcript and a summary through the API and webhooks.
You keep your phone numbers, carrier and customers. voicast keeps the agents (what the AI says and asks), the tenants (the businesses that take the calls) and the call records.
Pages#
| Page | What it covers |
|---|---|
| Getting started | From sign-up to your first call |
| Agents | Role, greeting, fields to collect, FAQ, handoff rules, voice, speaking rate |
| Phone | Twilio Media Streams (TwiML), cloud PBX and contact-center systems, handing off to a person |
| Web and apps | Sessions and WebRTC, audio or text output, pairing with avacast |
| Results | Calls, transcripts, summaries and fields; webhooks and signature verification |
| Tools | Letting the AI call your API or a third-party API during a call (signatures, API keys, confirmation, trying tools, timeouts, idempotency) |
| Connections | Connecting Google Calendar, Google Sheets and kintone, notifying LINE WORKS and Teams, and the embedded connect page |
| MCP | Operating voicast from Claude, Claude Code, Cursor, ChatGPT and other agents |
| SDK | The Node.js / TypeScript SDK |
| Pricing and billing | ¥10 per minute, prepaid credit and auto-recharge, enterprise contracts |
| Deleting data | Deleting a project, an organization or your account, and what is deleted and kept |
| Errors and limits | Status codes, error codes, rate and size limits |
| API reference | Every endpoint |
Dashboard guide#
Step-by-step guides to the dashboard (app.voicast.jp). You can also open them from Guide in the dashboard's left menu.
| Page | What it covers |
|---|---|
| Dashboard guide | Layout, roles and what they can do, tasks |
| Sign-in and account | Sign-up, sign-in, passkeys, connected apps, deleting your account |
| Organizations, projects and environments | Creating organizations and projects, switching environments, deleting projects |
| Members and roles | Invitations, changing roles, removing members, leaving |
| Creating and editing agents | Creating from a template and editing each setting |
| Agent versions | Viewing and going back to earlier versions, deleting agents |
| Test in browser | Talking to an agent with your microphone |
| Agent tools | Adding and trying tools, the signing secret |
| Tenants | Creating, editing, disabling and deleting tenants; reissuing connection secrets |
| Phone numbers and SIP | How phone numbers work, issuing SIP credentials |
| Connections | Connecting and disconnecting services, per-tenant connections |
| Call log | Filtering, details, transcripts, recordings |
| Usage | Totaling minutes and estimated charges, CSV export |
| Top-ups and billing | Top-ups, auto top-up, monthly limit, invoices |
| Retention | Changing how long call records and recordings are kept |
| API keys | Creating and revoking API keys |
| Webhooks | Registering webhook endpoints and delivery logs |
Endpoints#
| Purpose | URL |
|---|---|
| API | https://api.voicast.jp/v1 |
| Dashboard | https://app.voicast.jp |
| Phone audio (Twilio Media Streams) | wss://voice.voicast.jp/ws |
| Phone audio (other systems; see Phone) | wss://voice.voicast.jp/ws/{sender} |
| Phone (SIP from a PBX; see Phone) | sip.voicast.jp (UDP and TCP 5060, TLS 5061) |
| Web and app audio (WebRTC) | https://voice.voicast.jp/v1/webrtc/offer |
| MCP | https://api.voicast.jp/mcp |