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

# Answer Calls in the Dashboard

> Set up an AI agent that picks up your phone numbers, hands a caller to one of your people when they need one, and logs every call. No code.

An inbound campaign is an AI agent that waits for calls. Someone rings one of your numbers, the agent picks up, says your opening line and runs the conversation from your instructions. If the caller needs a person, it can put them through to one of your people mid-call. Every call lands in **Calls** with a recording, a transcript and a summary.

This page walks through the dashboard. The same setup over the API is in [Inbound Calls](https://docs.topcalls.ai/guides/inbound-calls.md) and [Transfer to a Person](https://docs.topcalls.ai/guides/transfer-to-a-person.md).

## Before you start

You need a phone number in your TopCalls account that can take calls. A number on your own carrier works too, once the carrier has **Allow inbound calls** switched on and its addresses declared under **Carrier setup for inbound calls**. See [Bring your own trunk](https://docs.topcalls.ai/guides/inbound-calls.md#bring-your-own-trunk).

What a minute costs is on [Pricing and Zones](https://docs.topcalls.ai/concepts/pricing.md).

## Build the campaign

**1. 1. Pick Answers calls**

Go to **Campaigns** and create a campaign. On **Basics**, choose **Answers calls** instead of **Calls out**. The steps change: there's no list to call, and a **Numbers it answers** step appears.

**2. 2. Choose the voice and what it knows**

On **How it sounds**, pick the voice and the language. On **What it knows**, attach the knowledge sources the agent may quote from, like a price sheet or an FAQ, and any workflows it may run mid-call, like booking a slot.

**3. 3. Pick the numbers it answers**

On **Numbers it answers**, tick one or more numbers. When one of them rings, this campaign picks up. A number answers for one campaign at a time, so a number already answering for another campaign has to move over.

Set **Answering hours** if the agent should only pick up on some days and hours. Without them it answers around the clock. Outside the hours, nobody picks up.

**4. 4. Write the opening line and the instructions**

On **What it says**, write the **Opening line**: who's speaking and what the caller can ask for, for example "Thanks for calling Bright Dental, this is Ana. How can I help?". It can't use placeholders like `{{name}}`, because the caller isn't a known lead yet.

Then write the **Instructions**: what the agent should find out, what it may promise, and when a person should take over. Plain language works best.

By default the agent speaks as soon as it picks up. Under **When it speaks** you can have it wait for the caller to say hello first.

**5. 5. Set how it answers**

On **How it answers**, choose a **Background sound** if you want a quiet office behind the voice, and add a **Call results** address if your own system should get a write-up after each call.

**6. 6. Turn on transfers, if a person should finish some calls**

On **Transfer to a person**, switch on **Transfer calls** and add up to five destinations. Each one has:

* a **Name** the caller hears, like "our support desk". The agent never reads out the number.
* a **Number** with its country code, like +40722000001. From the dashboard a destination must be a Romanian number (+40), and premium and shared-cost ranges are refused. Other country codes are set over the API with `allowed_prefixes`, see [Transfer to a Person](https://docs.topcalls.ai/guides/transfer-to-a-person.md).
* **When to transfer**, written about the caller: "the caller asks to speak with a person or has a billing dispute".

Under **What the caller hears** you can write the sentence the agent says before it connects them. Under **How it connects**, set how long the destination rings (10 to 60 seconds) and how many transfer attempts the agent may make on one call (1 or 2). **When transfers are offered** limits transfers to your opening hours; outside them the agent handles the call itself.

If nobody picks up, or the line is busy, the agent comes back to the caller and carries on. Tell it in the instructions what to offer then, such as a callback the next working day.

A transfer the call's price doesn't cover is refused before it dials, and so is one to a destination in a more expensive zone than the call. On a number from your own carrier, transfers that would go out through our carriers are refused. The [transfer guide](https://docs.topcalls.ai/guides/transfer-to-a-person.md#limits) has the details.

**7. 7. Test it, then launch**

Open **Test campaign** and use **Call it yourself**: save a draft, ring one of the numbers you picked from your own phone, and you hear what a customer hears. Then go to **Check and launch** and press **Launch**. The campaign starts answering on the numbers you picked.

> [!TIP]
>
> You can also point a number at a campaign from **Phone numbers**. Open the number's menu, choose **Inbound Calls** and pick the campaign that should answer it. A number answers for one campaign at a time.

## Split the work across a team of agents

If one set of instructions has grown too long, the **Team** setting on **What it says** lets you split the call across two to five agents. One greets and finds out what the caller wants, another answers product questions from the knowledge base, a third books. The caller hears one voice and one conversation. See [Crews](https://docs.topcalls.ai/guides/crews.md).

## What you get after each call

Inbound calls show up in **Calls** next to outbound ones. Filter by **Direction** to see only **Inbound**. Each call has its recording, transcript and summary, and a transferred call shows who it was **Transferred to**.

A caller whose number matches one of your leads is linked to that lead, and the agent knows their name. A new caller whose number isn't withheld becomes a lead in a list called "Inbound callers", so you can call them back from your lists.

## Limits to plan around

| Limit | Value |
| - | - |
| Inbound calls in progress at once, per account | 5. Further callers are declined until one ends. |
| Longest call | **Longest call** on **Basics**, 1 to 60 minutes |
| Transfer destinations per campaign | 1 to 5, one rings at a time |
| Transfer destinations set in the dashboard | Romanian numbers (+40) only |
| Agents in a team | 2 to 5 |

A caller who rings while the campaign is paused, outside its answering hours, or when your credit can't cover the call is declined without being answered, so the call costs nothing. The person you transfer to isn't briefed before the call connects, and the part of the call with them isn't transcribed. The recording covers the whole call.

## Related

> [card] [Inbound Calls](https://docs.topcalls.ai/guides/inbound-calls.md)
>
> The same setup over the API, with every error code.

> [card] [Transfer to a Person](https://docs.topcalls.ai/guides/transfer-to-a-person.md)
>
> Destinations, limits and the transfer outcome on each call.

> [card] [Crews](https://docs.topcalls.ai/guides/crews.md)
>
> Split one call across a small team of AI agents.

> [card] [Pricing and Zones](https://docs.topcalls.ai/concepts/pricing.md)
>
> What an inbound minute costs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.