Build what your client needs. We handle the phone.

// app/api/twilio/inbound.ts — Vercel function on your client's project
import { speakOnly, wrap, say } from "crixin/voice";
import { getMenu, reserveTable } from "./pos";

export default async function handler(req, res) {
  const caller = req.body.From;
  const menu = await getMenu();

  // Inbound call lands here as a Twilio webhook. Return TwiML.
  const twiml = `<Response>
    <Gather input="speech" action="/api/twilio/handle" language="es-MX,en-US">
      <Say voice="Polly.Hala-Neural" language="es-MX">
        ${menu.greeting}
      </Say>
    </Gather>
  </Response>`;

  res.setHeader("Content-Type", "text/xml");
  res.send(twiml);
}

// Your AI agent picks up via the crixin-voice MCP server,
// classifies intent (reservation / hours / menu / human),
// and either books via reserveTable() or speaks back.

// scripts/morning-confirms.ts — runs daily at 9am via cron
import { TwilioClient, makeCall, loadEnv } from "crixin/voice";
import { tomorrowsAppointments, recordOutcome } from "./ehr";

const client = new TwilioClient(loadEnv());
const appts = await tomorrowsAppointments();

for (const a of appts) {
  const call = await makeCall(client, {
    to: a.phone,
    prompt: `Hi ${a.firstName}, this is Apex Dental confirming
    your ${a.procedure} appointment tomorrow at ${a.time}.
    Press 1 to confirm, 2 to reschedule, 3 to cancel.`,
    voice: "Polly.Joanna-Neural",
    record: true,
    maxRecordingSeconds: 20,
    consented: true, // existing patient relationship
  });
  recordOutcome(a.id, call.sid);
}

// services/activation-checker.ts — runs hourly
import { TwilioClient, makeCall, loadEnv } from "crixin/voice";
import { stalledTrials, trackEvent } from "./analytics";

const client = new TwilioClient(loadEnv());

for (const user of await stalledTrials({ daysSinceSignup: 3, activatedEvent: false })) {
  await makeCall(client, {
    to: user.phone,
    prompt: `Hi ${user.firstName}, I'm calling from Acme. I saw you
    signed up Tuesday but haven't connected your first data source yet.
    It's a 90-second step. Can I walk you through it, or would you rather
    book 15 minutes with someone on our team?`,
    voice: "Polly.Joanna-Neural",
    consented: true, // signup ToS captures consent
  });
  trackEvent(user.id, "activation_call_placed");
}

// scripts/b2b-discovery.ts — fed leads from Clay / Apollo / Google Places
import { TwilioClient, makeCall, loadEnv } from "crixin/voice";
import { qualifyLead, bookMeeting } from "./crm";

const client = new TwilioClient(loadEnv());

for (const lead of leads) {
  // Geo-gate auto-enforces: this is a US business landline.
  // crixin voice doctor confirmed our setup.
  const call = await makeCall(client, {
    to: lead.businessPhone,
    prompt: `Hi, this is James from Apex. I'm calling because
    I noticed ${lead.companyName} just expanded to a second location —
    nice. Quick question — who handles your POS integration these days?
    Looking to chat about a 15% margin lift if you're open to it.`,
    voice: "Polly.Joanna-Neural",
    record: true,
    maxRecordingSeconds: 120,
    machineDetection: "DetectMessageEnd",
    // B2B landline + no DNC: no --consented needed under TCPA carve-out
  });

  const outcome = await qualifyLead(call.sid); // transcribe + classify
  if (outcome === "qualified") await bookMeeting(lead);
}

// app/api/triage.ts — inbound webhook from Twilio
import { promptAndRecord } from "crixin/voice";
import { TwilioClient, sendSms, transcribeRecording } from "crixin/voice";
import { classifyUrgency, pageOnCall, createTicket } from "./crm";

// 1. Inbound TwiML: ask what the issue is, record 30s.
export const twimlPrompt = promptAndRecord({
  prompt: "You've reached Houston HVAC after hours. Tell me what's going on — be specific.",
  voice: "Polly.Joanna-Neural",
  recordOptions: { maxLength: 30 },
});

// 2. Recording webhook: transcribe → classify → route.
export async function onRecording(req, res) {
  const t = await transcribeRecording(client, {
    recordingSid: req.body.RecordingSid,
  });
  const urgency = await classifyUrgency(t.transcript);

  await createTicket({ phone: req.body.From, transcript: t.transcript, urgency });
  if (urgency === "emergency") await pageOnCall(t.transcript);
}

// queues/post-delivery-nps.ts — fires 7 days after fulfillment
import { TwilioClient, makeCall, sendSms, loadEnv } from "crixin/voice";
import { orderById, saveNPS } from "./shopify";

const client = new TwilioClient(loadEnv());

export async function processNPS(orderId: string) {
  const order = await orderById(orderId);

  const call = await makeCall(client, {
    to: order.customer.phone,
    prompt: `Hi ${order.customer.firstName}, this is Anna from
    ${order.brand}. Quick 30 seconds — did your ${order.itemName} arrive
    in good shape, and on a scale of 1 to 10, how likely are you to
    recommend us to a friend?`,
    voice: "Polly.Joanna-Neural",
    record: true,
    maxRecordingSeconds: 30,
    consented: true, // captured at checkout
  });

  const { score, sentiment } = await saveNPS(call.sid);
  if (score >= 9) {
    await sendSms(client, {
      to: order.customer.phone,
      body: `Thanks! If you have 60s, would love a Google review: ${order.reviewUrl}`,
    });
  }
}