Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getsmartalex.com/llms.txt

Use this file to discover all available pages before exploring further.

This is the page most CTOs evaluating a voice AI platform spend the longest on. It’s the technical truth about what happens when the AI hands a call off.

​
The four kinds of transfer

Telephony vendors use “transfer” to mean at least four different things. Here’s the precise vocabulary, what SmartAlex does today, and what’s on the roadmap.
Transfer typeWhat it meansDo we support it?
Cold / blind / unattendedThe AI says “connecting you”, issues a SIP REFER, and drops out. The caller lands on the target cold.Yes , default today.
Warm / attended / consultativeThe AI puts the caller on hold, calls the target privately, briefs them, then bridges the caller in.Yes , for named targets via the warm transfer system.
Semi-attendedDial the target, wait for ring, complete the transfer before the target answers.Not directly supported.
Transfer with REPLACESSIP-level mechanism where an existing dialog is replaced by a new one, used in call-parking scenarios.Handled transparently , not a user-facing feature.

​
Cold (blind) transfer , the default

When the AI calls transfer_to_pbx with a destination that resolves to a PBX extension, or transfer_call with a PSTN number, a standard SIP REFER is sent on the existing call dialog. Key properties:
  • REFER travels on the existing dialog , no new outbound trunk needed on our side
  • Your PBX applies its own routing rules after receiving the REFER , queue, ring group, busy-forward, no-answer-forward
  • The original caller’s phone number is preserved via P-Asserted-Identity (RFC 3325)
  • Once the transfer is accepted, SmartAlex is no longer in the media path

​
Warm transfer , named targets

For named people (as opposed to extensions), SmartAlex supports warm transfer where the AI briefs the target before bridging in the caller.
1

AI speaks a filler line to the caller

“Let me grab Craig for you.”
2

Target is dialled in the background

While the caller waits, the target’s number rings. Call screening is applied based on their number.
3

When the target answers, a briefing is spoken

“Hi Craig, I have a caller on the line about a service appointment for an X5. Putting you through now.”
4

Caller and target are bridged

The AI exits the call.
Warm targets are configured on the agent as “transfer destinations” , name, aliases, phone number, optional briefing template.

​
Transfer targets , what the AI can send a caller to

Target typeHow it’s configuredSIP URI format
PBX extensionPbxExtensionsManager → extension number + name + aliasessip:EXT@PBX_DOMAIN
PBX queueAdded as an extension with the queue’s numbersip:QUEUE@PBX_DOMAIN
PBX ring groupAdded as an extension with the ring group’s numbersip:RING@PBX_DOMAIN
Individual PSTN numberConfigured as a “transfer target” on the agent with name, alias, phonetel:+27xxxxxxxxx
Default call-forwarding numberAgent setting , single external numbertel:+27xxxxxxxxx
VoicemailFalls through automatically if extension no-answer-forwards to VMPBX-managed

​
Caller ID forwarding

When SmartAlex transfers a call, it forwards the original caller’s phone number to your PBX via the P-Asserted-Identity SIP header (RFC 3325). Your PBX reads this and displays the real caller ID on the target extension’s phone , not the SmartAlex trunk’s number. What the receiving extension sees: the original caller’s ANI (A-number). What gets logged in your CDR: original caller’s number as the calling party, routed through the SmartAlex trunk.

​
How transfers appear in your PBX’s CDRs

Your PBX logs transfers as two legs:
  1. Leg 1: inbound call from SmartAlex trunk , duration equals time the AI was on the call
  2. Leg 2: transferred call to the extension , duration equals time spent with the human
Both legs are linked in most PBX CDR exports. Reporting, recording (if your PBX records transferred calls), and quality monitoring continue to work normally.

​
Failure modes

Whatever your PBX does normally , ring-through to another extension, voicemail, queue fallback , continues to apply. SmartAlex has already dropped out; we don’t re-take control.
PBX handles this per its own rules (often ring-group fallback or voicemail). SmartAlex is out.
Usually means the extension doesn’t exist or is disabled. The REFER completes anyway (from SmartAlex’s perspective), but the caller ends up wherever your PBX sends declined calls.
30-second timeout. If no response, the AI speaks the fallback: “I wasn’t able to connect you. Can I take a message instead?” The caller remains on the line with the AI.
Most commonly a SIP-header compatibility issue. Enable detailed SIP logging on your PBX, capture the REFER and the response, and contact support.

​
Latency

PhaseTypical
AI speaks acknowledgement (“Transferring you now”)0–2 seconds
Scheduled delay before firing REFER3 seconds
REFER → PBX accepts → new INVITE → extension rings0.5–2 seconds
Target picks upHuman-dependent
Total time from the AI’s acknowledgement to the target’s phone ringing: 3–5 seconds.

​
What we don’t do today

Be direct about these in customer conversations. Over-promising is worse than acknowledging the gap.
  1. Semi-attended transfer (complete transfer before target answers) , not supported. Uncommon request.
  2. Real-time transfer fallback chaining , if extension 101 doesn’t answer and we wanted to fall through to ext 102 by our rules. Today, this is handled by your PBX’s fallback rules instead.
  3. Cross-platform transfer , e.g., PBX extension to a Microsoft Teams user. Works if your Teams deployment has an SBC exposing Teams numbers as SIP targets; otherwise not directly supported.
  4. Transfer to WebRTC endpoints , for bespoke “transfer to a web agent” cases, custom integration work is needed.

​
Configuration summary , what drives what

Thing you wantWhere you configure it
AI can transfer to an extensionSettings → PBX → [trunk] → Extensions
AI can transfer to a PSTN number by nameAgent Studio → Transfer Targets
Default fallback number if AI can’t helpAgent Studio → Call Forwarding Number
Transfer rules (when to hand off)Agent Studio → system prompt / custom instructions
Caller ID shown on transferred callAutomatic via P-Asserted-Identity

​
Next steps

Testing & Validation

End-to-end test procedures.

Troubleshooting

Every SIP error and fix.

Observability

Monitor transfer success rates.