How the handoff works
Your agent hands the caller off with a blind SIP transfer and leaves the call, and your carrier, not your software, connects the caller to Natural.- Your agent creates a voice session and gets its
dialUri. - Your agent asks your carrier to transfer the caller to
dialUriwith a blind SIP REFER, then leaves the call. - Your carrier connects the caller to Natural over an encrypted leg, where Natural’s agent takes the card and charges it.
- Natural asks your carrier to transfer the caller back to your
returnTarget, or hangs up if you didn’t set one.
Requirements
Every setup must meet all of these, and Natural checks them with you before you go live.
Natural supports Twilio and Telnyx today, so if you use a different carrier, contact hi@natural.com.
Choose your carrier
Twilio
Elastic SIP Trunking and LiveKit
Telnyx
SIP connection and LiveKit
Choose your agent platform
The carrier guides use LiveKit, but any platform works if it sends a SIP REFER and leaves the call. The call must reach the platform over your own Twilio or Telnyx SIP trunk, because numbers bought inside these platforms sit on the platform’s carrier account, where you can’t control recording, encryption, or transfers. Several platforms bridge by default, so set the transfer mode explicitly.Get the caller back
SetreturnTarget to a SIP address your agent platform answers, such as your LiveKit SIP host, with a fixed user that marks returning calls:
- Is this a returning caller? A returning call is addressed to
pay-return, while a new call is addressed to your phone number. - Which conversation is it? Look it up by the caller’s phone number, and accept the match only if you handed that caller to Natural within the last 30 minutes, the longest a payment call can run, since caller ID alone can be faked.
Go live
Before your first live call, Natural reviews your setup with you, and together you place test calls in Sandbox to confirm card details never reach your systems. Check each test call for these:- Your agent’s logs show no speech-to-text after the transfer.
- Your agent left the call within a second of the transfer.
- Your carrier has no recording or transcript of the call.
- Your webhooks received no key presses.
- The caller heard Natural’s agent, and after they read the Sandbox test card, the session’s
payment.outcomeispaid.