> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usesimple.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Calls

> Make and receive AI-powered phone calls with Simple AI

Calls are the core of Simple AI. Every voice conversation — inbound or outbound — is a call. You can trigger calls from the API, the dashboard, or through [campaigns](/campaigns), and each call is recorded, transcribed, and available for analysis.

## Inbound Calls

Attach an agent to a phone number and every call to that number is handled by your AI. To set up inbound calls:

1. Buy or connect a phone number — see [Phone Numbers](/numbers)
2. Assign an agent to that number — see [Agents](/agents)
3. When someone calls, the agent picks up and follows its configured prompt and flow

You can also run a [pre-call webhook](/call-flow) before the conversation starts to inject dynamic parameters (like caller identity or account details) into the agent.

## Outbound Calls

Outbound calls can be triggered three ways:

* **API** — send a POST request to [Create Call](/api-reference/calls/create-call) with a phone number and agent
* **Dashboard** — place a call directly from the Simple AI web app
* **Campaigns** — reach a list of contacts automatically with scheduling and retries. See [Campaigns](/campaigns)

When making an outbound call, you can either reference an agent you have already configured or provide a prompt inline to create an agent on the fly.

**Compliance note**: Outbound calls must follow all rules and regulations in your jurisdiction, including FCC rules and any applicable local laws.

## Call Parameters

You can pass custom key-value parameters when creating a call. These parameters are available to the agent during the conversation and can be referenced in the prompt using `{{parameter_name}}` syntax.

Parameters are useful for personalizing calls — for example, passing in a customer name, order number, or account ID so the agent can reference it during the conversation.

## Call Lifecycle

Every call follows this sequence:

1. **Pre-call webhook** (optional) — your server is notified before the call starts and can inject parameters
2. **Call started** — the call is created and the agent connects
3. **In progress** — the conversation happens, with real-time transcript updates available via [webhooks](/webhooks)
4. **Call completed** — the call ends, recording and transcript are finalized, and post-call [analyzers](/analyzers) run

For full details on each step, see [Call Flow](/call-flow).

## Call Data

After a call completes, Simple AI stores:

* **Recording** — the full audio of the conversation
* **Transcript** — a text transcript of what was said by each party
* **Duration** — how long the call lasted
* **Outcome** — whether the call was answered, went to voicemail, or failed
* **Analyzer results** — structured data extracted by your [analyzers](/analyzers)
* **Tags** — labels applied by your [tag](/tags) rules
* **Sentiment** — automatic [sentiment analysis](/call-sentiment) of the caller's tone

You can review this data in the dashboard, retrieve it through the [API](/api-reference/calls/get-call), or export it as CSV.

## Language Support

Simple AI currently supports English and Spanish. If you need support for other languages, contact us at [support@usesimple.ai](mailto:support@usesimple.ai).

## API Reference

* [Create a call](/api-reference/calls/create-call)
* [Get a call](/api-reference/calls/get-call)
* [List calls](/api-reference/calls/list-calls)
* [Find call by attribute](/api-reference/calls/find-by-attribute)
* [Delete a call](/api-reference/calls/delete-call)