VoiceXML 2.1 Development Guide Home  |  Frameset Home
  G: Outbound Dialing  |  TOC  |  Disconnect Events  

Transfer Types

One of the two ways that you may dial out within your Voxeo VoiceXML applications is to make use of the <transfer> element. Lesson 6 covers this procedure step by step, so we will content ourselves with a broad overview of the types of calls we can make, and the intricacies of dealing with all of the possible events that can happen during a <transfer>.

There are two kinds of calls that we can make on the Voxeo network, a bridged transfer, and a blind transfer.  A bridged transfer is where the original caller is returned to the VoiceXML application after the dialed party hangs up, and a blind transfer will end the application execution when either party disconnects. Note that at this time, only bridged transfers are allowed; blind transfers are not enabled on either the Staging network, or on the Production network, and attempting to use one within your code willnot result in the 'connection.disconnect.transfer' event.

For a 'true' blind transfer, you will need to contact the Voxeo Sales Team, and get hooked up with the  ‘take-back and transfer’ feature, which allows the caller to dial into the application, and then make a transfer off the Voxeo network. This feature is not enabled on the Staging center, but can be enabled on a Production application upon request. Contact the Voxeo sales team for further details regarding this feature.

Outbound Dialing Permissions

Be aware that outbound dialing is not enabled for developer accounts by default. Unless you have received the account permissions from the Support Team, then all <transfer> attempts will result in a 'busy' event every time. In order to get this permission enabled, you'll need to contact Support.


When requesting the outbound dialing privilege, remember to include:


Inbound International Dialing

While we Americans tend to show a bit of hubris when it comes to our technologies, we certainly don't discriminate when it comes to sharing the love to our friends from other countries. If you happen to live 'across the pond' from us Yanks, then you still have the ability to use our US testing platform for free. Another Capitalist trick, you ask? Not hardly. Check our VoIP dialing information page, and our web-forums for more information on this feature.

If your deployment plans indicate that you will be testing and deploying your applications in our UK platform rather than our US platform, then it is suggested that you specifically request access to the UK platforms, as user accounts on the evolution.voxeo.com site default to using the US datacenters.

Outbound International Dialing

US-based applications with a 'world beat' in mind will likely want to make use of outbound International dialing, such as within the <transfer> element, or within a token-based outbound call. Before we start, there are a few basic things you should know about International dialing on the Voxeo platform.

For development and testing, you can also purchase a pre-paid worldwide developer package, which comes with a local UK inbound DDI number (for the inbound package), international outbound dialing rights, and access to various international ASR and TTS offerings that are not available here in the United States. Should you wish to learn more about this package, you can point your browser to evolution.voxeo.com/worldwide/packages.jsp to learn more about what you'll get.

For commercial-grade call traffic, International dialing access can be enabled for production accounts only, with the following caveats:

You may contact our sales team for additional information on International dialing from the United States, or as a lower-cost, lower commitment alternative, you can also purchase a pre-paid worldwide developer package for your initial testing and proof-of-concept efforts.

Once you have gotten setup with this International dialing rights, then you'll need to actually code it, so a few bits of advice are in order to get you off on the right foot. The number formatting for placing an international call to anyone is as follows:

tel:+[country code][number]


So, if you wanted to place a bridged transfer to '000-111-2222' in Uganda, where the Country Code is '256' then your dialing string might look like this:


<transfer dest="tel:+2560001112222" bridge="true">


For a token-initiated call, the same holds true, but with one caveat: Sending a string value of 'tel:+2560001112222' isn't going to fly at all, as we will need to URL-encode the '+' character before sending it across to session.voxeo.net. To illustrate, let's look at two examples:

From the United States Datacenters

Incorrect Formatting

http://api.voxeo.net/SessionControl/VoiceXML.start?
    numbertodial=tel:+2560001112222&
      tokenid=yourTokenIDhere


Correct Formatting

http://api.voxeo.net/SessionControl/VoiceXML.start?
    numbertodial=tel:%2B2560001112222&
      tokenid=yourTokenIDhere


From the United Kingdom Datacenters

Outbound applications deployed in our UK datacenters will require that you use a different token launch URL as opposed to the US-centric token API listed above to ensure that calls route through the UK datacenters, as illustrated below.


http://api.lon.voxeo.net/SessionControl/VoiceXML.start?
    numbertodial=tel:+2560001112222&
      tokenid=yourTokenIDhere


Correct Formatting

http://api.lon.voxeo.net/SessionControl/VoiceXML.start?
    numbertodial=tel:%2B2560001112222&
      tokenid=yourTokenIDhere






  ANNOTATIONS: EXISTING POSTS
djvergara
11/11/2007 1:56 PM (EST)
Is it possible to place a call to a SIP address? Something like

http://session.voxeo.net/VoiceXML.start?
    numbertodial=sip:user@ekiga.com&
      tokenid=yourTokenIDhere
voxeo.benb
11/11/2007 5:58 PM (EST)
Hello,
    I've enabled SIP outbound dialing for your evolution account. This should allow your applications to call sip numbers.

Thank You,
Ben Bohn
Voxeo Support
mgoebel
3/28/2008 9:13 PM (EDT)
Could you please do the same for me? I would like to configure a transfer to a SIP address in evolution. Could you explain me how to do it?
VoxeoDustin
3/28/2008 9:32 PM (EDT)
Hey,

I have enabled SIP outbound dialing privileges for your account. I assume you want to be able to perform a SIP transfer via Evolution Designer as this is the only application type I see in your account.

In this case, you will want to use the Transfer step of Designer. For the type of transfer, select Phone Number and input the full SIP address like as: sip:number@address

e.g. sip:91111111@sip.voxeo.net

Cheers,
Dustin
kennyd6
3/30/2008 9:15 AM (EDT)
I requested and received a tokenId. Would it be possible to check if outbound SIP is enabled on my account? I need to dial a SIP phone from a html form.

What are my other options (if any) for free outbound dialing considering I live in Ireland? My application needs to be able to dial 2 numbers at once with the same VoiceXML file. Is this possible with my account?

Thanks
VoxeoDustin
3/30/2008 10:38 AM (EDT)
Hey Kenny,

You account is indeed setup for SIP outbound dialing. Currently, the only option for free international dialing is via SIP. You can dial in via Skype currently, but currently dialing out to a Skype address is not supported.

With VoiceXML, you'll only be able to do a bridged transfer from one number to another. If you need to dial two numbers from a VXML app, you could launch the first call via token and once connected, perform a bridged transfer via the transfer element to the second number.

Cheers,
Dustin
mohitjain
2/9/2009 11:48 AM (EST)
Hi,

Created a VXML Application and have got a toll free number for the same using the VOXEO application manager.In the vxml app - I am trying to transfer the call to other toll free number.Though we have enabled my voxeo account for outbound call transfer It says ..."My voxeo account has not been enabled for outbound transferring calls".

Note: Iam trying to transfer the call to a US toll free number.

Need help on this.


Thanks,
Priya
voxeojeff
2/9/2009 11:57 AM (EST)
Hi Priya,

It looks like you weren't using proper E.164 formatting in your transfer destination.  You'll want to format it such that it follows this pattern:

tel:+1[number]

The [number] is your 10 digit destination, area code included.

Hope this helps,
Jeff
jonesy
4/5/2009 1:58 PM (EDT)
Hi,

Is it possible to have my account set so I can make outbound calls to a gizmo sip number? Also, I'm also having problems with a link 'lesson 6' at the top of this page, if you could post me a another link to that page too.

Thanks,

Chris.
mikethompson
4/5/2009 2:54 PM (EDT)
Hello,

I've enabled outbound dialing for your account.  Also, you can reach Lesson 6 via this link:

http://www.vxml.org/t_6.htm

Best,
Mike Thompson
Voxeo Corporation
jonesy
4/5/2009 3:31 PM (EDT)
thank you.

Chris
marand
7/19/2010 9:10 AM (EDT)
Hi,

could you please enable SIP outgoing calls for our account. We would like to test a feature of our platform and will be calling destination@ourserver.com

Thanks,
Tomaz

http://lab.marand.com
VoxeoDustin
7/19/2010 3:44 PM (EDT)
Tomaz,

I have enabled SIP outbound dialing on your account.

Let me know if we can be of further assistance.

Regards,
Dustin Hayre
Solutions Engineer
Voxeo Corporation
amit85
12/1/2010 4:03 AM (EST)
Can you tell me how to activate the Outbound Dialing Permissions.
And how i will get the Token id
voxeoJeffK
12/1/2010 4:17 AM (EST)
Hello,

I've now enabled outbound privileges for your account. For call start tokens, just let us know what application you would like us to provision with a token.

Regards,
Jeff Kustermann
Voxeo Support
SSA_Zoove
11/2/2011 11:11 PM (EDT)
Where can I find CCXML & VXML dialog interaction for transfer calls

thanks
Vinay
VoxeoDante
11/3/2011 10:01 AM (EDT)
Hello Vinay,

I am afraid that I am not really sure what you are looking for here.  Can you give me a little more information on what you are looking to achieve/learn?

Regards,
Danté Vitulano
Hosted Solutions Engineer

[url=http://www.voxeo.com/university/home.jsp]
[img=http://www.voxeo.com/images/logos/VoxeoUnivLogo.png/]
[/url]
[b][color=blue]Interested in Training? Visit the Voxeo University Page to Learn More![/color][/b]

login
  G: Outbound Dialing  |  TOC  |  Disconnect Events  
© 2012 Voxeo Corporation  |  Voxeo IVR  |  VoiceXML & CCXML IVR Developer Site