Skip to main content

​
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, 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 eventMaps to
call_endedThe finished call — transcript, recording, cost, and ended reason.
call_analyzedRetell’s post-call pass — its summary and analysis metadata.
Recordings are persisted to Zelto storage so the player on the conversation detail page keeps working.

​
Verify the first call

Place a test call to your Retell agent, then open 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.

​
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.