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

# Overview

> Build, launch, and operate production voice agents with FormantAI.

FormantAI is a production platform for AI-powered phone calls. Use it to configure voice agents, initiate outbound calls, run batch campaigns, ground conversations in your knowledge base, call external tools, and receive call outcomes through webhooks.

Configure the prompt, voice, providers, tools, knowledge base, phone settings, and webhooks.

Start one outbound call, wait for the terminal event, and retrieve the conversation result.

***

## What you can build

Trigger personalized calls from your backend with dynamic parameters, idempotency, metadata, and trace IDs.

Upload a CSV, call many contacts with the same agent, monitor outcomes, and reconcile campaign results.

Attach approved FAQs, policies, pricing sheets, SOPs, and support playbooks to improve answer quality.

Let agents call your CRM, calendar, ticketing, payment, or internal APIs during live conversations.

Retrieve statuses, transcripts, recordings, trace IDs, and structured results after calls finish.

Send signed terminal call events to your backend, CRM, warehouse, or operations workflow.

***

## How FormantAI works

```mermaid
flowchart LR
    A[Configure agent] --> B[Start call or batch]
    B --> C[Live voice conversation]
    C --> D[Transcript and results]
    D --> E[Webhook or API retrieval]
```

1. **Configure an agent** with prompts, call parameters, voice, providers, tools, knowledge base access, and webhook targets.
2. **Start a call** with `POST /v1/call` or launch a CSV campaign with `POST /v1/batch-call`.
3. **Run the conversation** through the configured telephony, speech, model, and voice providers.
4. **Extract outcomes** such as status, transcript, recording, disposition, and structured result fields.
5. **Sync downstream systems** through webhooks or by fetching conversations from the API.

***

## Start by goal

Set up the agent before sending production traffic.

Upload a CSV, personalize each row, monitor progress, and reconcile outcomes.

Configure signed webhooks so your backend receives terminal call events in real time.

Review API keys, idempotency, rate limits, monitoring, consent, and retry handling.

***

## Base URLs

Use the global production API unless your workspace is provisioned in the India region.

| Environment       | Base URL                             |
| ----------------- | ------------------------------------ |
| Global production | `https://api.voice.formantai.com`    |
| India production  | `https://api.in.voice.formantai.com` |