Ytel understands it is a difficult situation when your provider halts business operations. We can offer you a solution to easily forklift out your current code from Tropo to Ytel and get you up and running again.

To make the transition process from Tropo as simple as possible, we will assist you in porting your Toll Free and Local Numbers from your Tropo account at no cost. Email us at support@ytel.com for free 24/7 support or message us on intercom 24/7 via ytel.com and we can get that process going for you.  

Ytel is a RESPORG and has the capability to quickly transition your numbers.  

The information below will help guide you in setting up an account, adding some promotional funds, and sending out your first SMS.  It will also provide you some examples on how you can convert Tropo Call and SMS functionality over to the Ytel API. You will be surprised at how easy it really is!

Welcome, Tropo Customers!

Go straight to the docs
Get right to it - go straight to the API Reference Documentation.

Enable voice, messaging, or mail communications into your applications with just a few lines of code. Our RESTful API will get you up and running in no time.

An account is required to get started.
Are you new to Ytel and the API we offer? Sign up for our API or visit our website for more information and start communicating today.

Once you sign up for an account, check our documentation regularly. We update and improve features quite often and are constantly adding functionality to the API.  We are also adding and growing out our library of communication API SDKs for both developers and content managers.

Below you will find some quick links to help you get started:

• Ytel API Reference docs for viewing sample code and documentation on all our API endpoints.
• Access all our SDKs Libraries for connecting to the API.
• Quick links to popular language package indexes:
• RubyGems.org: https://rubygems.org/gems/YtelAPI
• PyPi: https://pypi.org/project/YtelAPI/
• npm: https://www.npmjs.com/package/ytelapi
• Changelogs showing recent updates and fixes

For updates and news, follow the AskYtel blog and find us on Twitter @askytel.

The below guide will get you going in sending out your first SMS.

First Steps

Visit the web portal and sign up for the API. You will be asked to verify your phone number when you sign up to make sure you are human and not a bot.

Once the form is filled out, you'll get an email with an activation link that will guide you through getting your account set up and configured.

Your first number is on the house!

As a Tropo customer, we are extending to you a promotional code offer for $25. This will allow you to buy a number free of charge and test out our services. You can add that promo code under the Billing->Add Funds menu at the top the page after logging in.

Tropo Promotional Code: tropo-vip-promotion

Once you have $25 in your account, go to the top menu and select Numbers-> Buy a Number.

Buy a number from the top menu bar.

Once there, select any SMS enabled number and click Buy.

Authentication for your account

Once you go through the account sign up and verification process and login for the first time, you will see your API credentials. Understanding where your Account SID and Token are located is the first step in utilizing the API platform. On the dashboard, your Account SID and Token can be found in the upper left.

Location of your Account SID and token in the Dashboard

Using the API Reference

We supply you a list of all of our API endpoints. Make sure you have everything you need to send a test SMS.

Checklist:

• A phone number you purchased from our API Portal
• Your Account SID
• Your token

Now let’s take a look at the Ytel API Reference for sending an SMS. Below is an image that describes what the pertinent fields mean that you will be filling out.

Steps to send your first SMS:

1. Enter in your “From” number. This number is the number you purchased in the Ytel API portal and should be entered in the format +14445556666
2. Enter in your “To” number. This is your mobile number where you will receive the SMS and also entered in the format +14445556666
3. Type in the message you want to send to yourself. One message is 160 characters in length.
4. Click the “Try It” button. You will be prompted to enter in your username and password. Your Account SID is your username and your Token is your password.

Converting your Tropo functionality into the equivalent Ytel API functionality

Send SMS Example
Example Tropo Code in Python:

call("+13069990432", {
    "network":"SMS"})
say("Don't forget your meeting at 2 p.m. on Wednesday!") 

Equivalent Code in the Ytel API using Python

collect = {}

mfrom = 'From'
collect['mfrom'] = "+13063336654"

to = 'To'
collect['to'] = "+13069990432"

body = 'Body'
collect['body'] = "Don't forget your meeting at 2 p.m. on Wednesday!"

result = sms_controller.create_sms_sendsms(collect) 

Make a Call Example
Example Tropo Code in Python: 

call("+17700900444")
say("Tag, you're it!")

Equivalent Code in the Ytel API using Python

>mfrom = 'From'
collect['mfrom'] = "+17702342212"

to = 'To'
collect['to'] = "+17700900444"

url = 'Url'
collect['url'] = "https://subdomain.yoururl.com/yourinboundxml.xml"

method = 'Method'
collect['method'] = "POST"

result = call_controller.create_calls_makecall(collect)

The Ytel API uses an XML Schema called InboundXML. When your outbound call is answered by the party you are calling, the URL you supply in the “URL” field will be sent some basic call information.  

This URL should serve up some basic InboundXML code and will help you interact with the call. To keep in line with our example, you would output:

<Response>
  <Say>Tag, you're it!</Say>
  <Hangup></Hangup>
</Response>

We understand the difficult situation you are in as a current Tropo customer. We're happy to help get you migrated over to the Ytel API and up and running in no time. For more assistance, email support@ytel.com or click here to get in touch. We look forward to working with you!