Calls | Leilani Docs

Leilani handles inbound SIP calls in real time.

During a call, the agent receives caller audio, transcribes speech, reasons over instructions and available tools, speaks back to the caller, and can route or end the call.

Call flow

Leilani receives an inbound call for a registered agent.
Leilani starts the configured voice agent for the call.
The agent can use built-in tools, configured Functions, MCP tools, the Directory, Knowledge Base, and allowed web search.
Transcript segments stream into the Inbox while the call is active.
On hangup, elapsed call time is recorded and the agent balance is reduced.
If a transcript email is configured, Leilani sends the transcript after the call ends.

Caller context

Each call includes caller context the agent can use while following its instructions:

caller.display_name, when the caller display name is available
caller.username, the caller username, extension, or number

Use this context for personalization, lookup hints, routing, or workflow rules. Do not treat it as verified identity unless your phone system and operating process explicitly support that assumption.

Built-in call tools

Every call includes built-in tools for:

searching the Directory
transferring a call
starting and finishing warm transfers
sending fallback warm-transfer messages
searching the Knowledge Base
ending the call
updating the call's short summary

Web search is only added when the agent has allowed domains configured.

Operator surfaces

Dashboard

Use the Dashboard for registration status, active-call counts, recent call metrics, call-log search, and funds.

Inbox

Use the Inbox to select active calls, watch transcripts, manually transfer, or hang up.