Quickstart

import os, httpx

API = "https://api.voice.miraiminds.co"
auth = {"Authorization": f"Bearer {os.environ['MIRAI_API_KEY']}"}

agent = httpx.post(
    f"{API}/v2/agents",
    headers=auth,
    json={
        "name": "Order Confirmation",
        "system_prompt": (
            "You are Priya from Acme. Confirm order {{order_id}} with "
            "{{customer_name}} and ask whether the delivery address is "
            "unchanged. Keep replies to one or two short sentences. When "
            "the customer is done, thank them and end the call."
        ),
        "first_message": "नमस्ते {{customer_name}}, मैं Acme से Priya बोल रही हूँ।",
        "voice": {"voice_id": "priya", "language": "hi-IN"},
        "language": "hi-IN",
        "max_duration_secs": 300,
    },
    timeout=30,
).raise_for_status().json()

print(agent["id"])  # agt_01JZQ8F3K7M2N5P9R4T6V8W0XZ

const API = "https://api.voice.miraiminds.co";
const auth = { Authorization: `Bearer ${process.env.MIRAI_API_KEY}` };

const res = await fetch(`${API}/v2/agents`, {
  method: "POST",
  headers: { ...auth, "Content-Type": "application/json" },
  body: JSON.stringify({
    name: "Order Confirmation",
    system_prompt:
      "You are Priya from Acme. Confirm order {{order_id}} with {{customer_name}} " +
      "and ask whether the delivery address is unchanged. Keep replies to one or " +
      "two short sentences. When the customer is done, thank them and end the call.",
    first_message: "नमस्ते {{customer_name}}, मैं Acme से Priya बोल रही हूँ।",
    voice: { voice_id: "priya", language: "hi-IN" },
    language: "hi-IN",
    max_duration_secs: 300,
  }),
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
const agent = await res.json();
console.log(agent.id); // agt_01JZQ8F3K7M2N5P9R4T6V8W0XZ

call = httpx.post(
    f"{API}/v2/calls",
    headers={**auth, "Idempotency-Key": "order-8842-confirm-1"},
    json={
        "agent_id": "agt_01JZQ8F3K7M2N5P9R4T6V8W0XZ",
        "to": "+919876543210",
        "variables": {"customer_name": "Rahul", "order_id": "8842"},
        "webhook_url": "https://example.com/mirai/webhook",
    },
    timeout=30,
).raise_for_status().json()

print(call["id"], call["status"])  # call_01JZQ9B4M8N3P6R2S5T7V9W1YA queued

const res = await fetch(`${API}/v2/calls`, {
  method: "POST",
  headers: {
    ...auth,
    "Content-Type": "application/json",
    "Idempotency-Key": "order-8842-confirm-1",
  },
  body: JSON.stringify({
    agent_id: "agt_01JZQ8F3K7M2N5P9R4T6V8W0XZ",
    to: "+919876543210",
    variables: { customer_name: "Rahul", order_id: "8842" },
    webhook_url: "https://example.com/mirai/webhook",
  }),
});
const call = await res.json();
console.log(call.id, call.status); // call_01JZQ9B4M8N3P6R2S5T7V9W1YA queued

import express from "express";
import crypto from "node:crypto";

const app = express();
const WHSEC = "whsec_7d4f1a09c2e58b36a1f0d7c93b2e64a8";
const TOLERANCE_SECS = 300;

function verify(rawBody, header, secret) {
  const parts = Object.fromEntries(
    header.split(",").map((p) => {
      const i = p.indexOf("=");
      return [p.slice(0, i).trim(), p.slice(i + 1).trim()];
    })
  );
  const { t, v1 } = parts;
  if (!t || !v1) return false;
  if (Math.abs(Date.now() / 1000 - Number(t)) > TOLERANCE_SECS) return false;
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${t}.`)
    .update(rawBody)
    .digest("hex");
  const a = Buffer.from(expected, "utf8");
  const b = Buffer.from(v1, "utf8");
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

// raw body is required — a re-serialized JSON object will not match
app.post("/mirai/webhook", express.raw({ type: "application/json" }), (req, res) => {
  if (!verify(req.body, req.get("X-Mirai-Signature") ?? "", WHSEC)) {
    return res.sendStatus(401);
  }
  const event = JSON.parse(req.body.toString("utf8"));
  console.log(event.type, event.data.call.status);
  res.sendStatus(200); // 2xx stops our retries
});

app.listen(3000);