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

# Retell

> Connect a Retell account and forward calls into Zelto.

## Connect

1. Open **Settings → Integrations → Retell** and click **Connect Retell**.
2. Paste your Retell API key. We use it to fetch agent metadata,
   recordings, and analyses on demand.
3. The card shows the webhook URL Zelto exposes. Copy it into your
   Retell dashboard → **Webhooks** so Retell can push call lifecycle
   events to us. If you use [Hookdeck](https://hookdeck.com), an
   alternative Hookdeck-fronted URL is shown too — same destination,
   extra delivery retries and replay.

You can connect multiple Retell accounts to one organization.

## What gets ingested

Zelto ingests two Retell events; any others are acknowledged and ignored.

| Retell event    | Maps to                                                            |
| --------------- | ------------------------------------------------------------------ |
| `call_ended`    | The finished call — transcript, recording, cost, and ended reason. |
| `call_analyzed` | Retell's post-call pass — its summary and analysis metadata.       |

Recordings are persisted to Zelto storage so the player on the
[conversation](/docs/conversations) detail page keeps working.

## Verify the first call

Place a test call to your Retell agent, then open
[Conversations](/docs/conversations) — the call shows up within a few seconds with
its transcript. If it doesn't, the agent's **Connections** card shows whether
calls are arriving and flags the most recent delivery if it errored. See
[Connect a voice provider](/docs/guides/connect-a-voice-provider#troubleshoot-a-missing-call).

## Manage Retell from chat

Once your Retell account is connected, Ask Zelto can read and change
your Retell account through your own Retell API key:

* **list\_retell\_agents** — see every agent in your account.
* **get\_retell\_agent** — fetch one agent including the current
  system prompt of its `retell-llm` (when applicable).
* **list\_retell\_calls** — recent calls for an agent to inspect how it
  has been performing.
* **update\_retell\_agent\_prompt** — replace the prompt on the
  underlying `retell-llm`. Only works for agents whose response engine
  is `retell-llm` — conversation-flow agents are not editable through
  this tool yet.
* **update\_retell\_agent** — change an agent's `name`, `voiceId`, or
  `language`.

Reads run as soon as you ask. Writes (`update_*`) route through a
confirmation card — nothing is sent to Retell until you click
**Confirm**.

### Control who can use these tools

Each voice integration has a **Chat tool access** setting in its
**Manage** dialog (Settings → Integrations → Retell → Manage):

* **Everyone** (default) — any member can drive Retell from chat.
* **Admins & owners** — only owners, admins, and global admins.
* **Disabled** — the Retell tools disappear from chat for everyone.

Only owners and admins can change this setting. The gate is enforced
both when building the chat toolset and again when a write is
confirmed, so disabling it removes the capability completely.

## Connection status & disconnecting

The card shows the connected account and the webhook URL Zelto exposes. The
**Disconnect** action removes the stored API key; remove the webhook from your
Retell dashboard separately to stop the push side.

## Related

* [Connect a voice provider](/docs/guides/connect-a-voice-provider) — pick a path and verify ingestion.
* [Conversations](/docs/conversations) — where Retell calls land.
* [Agents](/docs/agents) — how Zelto models each agent.
* [MCP](/docs/mcp) — manage agents and query your data from your editor.