Cookbooks - Voice Infra

A cookbook takes one use case from an empty workspace to production. Where the Documentation explains each feature on its own, a cookbook shows how the features fit together for a specific product, with code you can copy.

Available cookbooks

Phone calling

Receive inbound phone calls

Buy a number through Mirai or connect your own supported telco number. Assign your published agent, activate incoming calls, and test the results. Includes console steps, API examples, and troubleshooting.

Agent builders

Build a node based voice agent editor

Build a React Flow editor with a Node.js backend. Create and update agents, attach tools, declare inputs, and connect a phone number. Includes source code you can clone and run.

Browser voice apps

Timed voice interviews in the browser

A 10-minute AI interview in your web app: personalised opening, live captions, a graceful wrap-up and goodbye, moderator controls, an automatic score and a text-only record.

WhatsApp voice apps

WhatsApp calling for partners

Add incoming calls and permitted callbacks to your brands’ existing WhatsApp numbers: separate agents, one partner workspace, signed results and combined billing. Early access; production activation and call acceptance are required.

Transcription apps

Transcript player for recorded calls

Upload a recorded call, read a draft within seconds, then listen along to the finished transcript with speakers, correct it and export it as text, subtitles or JSON.

How every cookbook is laid out

Each cookbook follows the same order, so you can jump to the part you need.

Section	What you get
What you’ll build	The finished behaviour, in plain terms, and what you need before you start.
How it works	The moving parts and the order they talk to each other.
Steps	Numbered steps, each with complete code in cURL, Python and Node.js where it applies.
Test it	A short configuration that shows every behaviour in a few minutes, and a troubleshooting table.
Privacy and compliance	What the recipe stores, what you must tell your users, and how to keep keys and links safe.
Production checklist	What to confirm before real users arrive.

Cookbooks link to the reference pages for every field and error code instead of repeating them. When a cookbook and a reference page seem to disagree, the reference page is correct — tell us at help@miraiminds.co.

Before you start

Every cookbook assumes:

A workspace API key (sk_live_…), and its webhook secret (whsec_…) when the recipe receives webhooks. See the Quickstart.
A backend that can keep the key secret. The key never goes to a browser or a mobile app.
An HTTPS endpoint for webhooks, when the recipe uses them. While you build, a tunnel to your laptop works.

Base URL in the examples: https://sandbox.voice.miraiminds.co. Use the API host your key was issued for.

Ask for a cookbook

Building something the cookbooks don’t cover yet? Write to help@miraiminds.co with a one-line description of your use case.

​Available cookbooks

​Phone calling

Receive inbound phone calls

​Agent builders

Build a node based voice agent editor

​Browser voice apps