tropowebapi tutorial - hosting files with tropo

Tropo WebAPI Development Guide

| TOC

Tropo Hosting

Do you need a place to store audio files, JSON catalog files, XML address books and so on for reference and use in your applications? Tropo hosting is for you! Yay!

With Tropo hosting, you can host your resource files for free and access them directly from Tropo when you need to edit them.

Tropo’s File Manager

Working with your hosted files is simple. Once you're logged into your account, click on the “Your Hosted Files” link from the menu. Here you will be presented with a file manager where you can access your files, rename them, or upload new ones.

FTP

You can also use your favorite FTP client to manage your files. You can access them by connecting to ftp://ftp.tropo.com, then just use your regular Tropo Username and Password to log in.

WebDav

What is it?

Your Tropo Hosting account is now available via WebDav! WebDav is an HTTP-based content management protocol originally created by the IETF. With Tropo WebDav, you can "mount" your web hosting files just like you would a thumb drive, which also allows you to edit (and save!) your Tropo scripts directly from your favorite editor.

How does it work?

Mac OS X

From the Finder, press APPLE-K. This will open the "Connect to Server" dialog. In the Server Address box enter http://webdav.tropo.com and click on the Connect button. When asked for your username and password simply enter your Tropo.com login credentials.

That's it! Your Tropo Web Hosting files will appear as another drive on your computer. You can drag files in and out of your account and any changes made to these files will be automatically synchronized across all 3 US data centers.

Windows XP

The Windows instructions are a bit longer.

Here are the instructions to create a shortcut to your Tropo "Web Folder".

While it’s a few more steps on Windows, once setup is complete all the features are the same.

Using hosted resource files

If you wanted to reference a file that you hosted with Tropo in a script, maybe an audio file to be used in a 'say', you would use a path that begins with:

http://hosting.tropo.com/12345/www

Replace 12345 with your account ID (which can be found by examining the path for any application that uses a Tropo hosted script); if you have the file in a sub-directory, like the already provided 'audio' folder, just append the sub-directory to the end of the path followed by the file's name. Your path might look like this in your script:

http://hosting.tropo.com/12345/www/audio/background_music.wav

Security

Files hosted at hosting.tropo.com are only available within our network, so any files you place on our servers will not be publicly accessible. This is done for security purposes, however this also means hosted audio files will only be accessible within a Tropo application, you couldn't link the file on a website or any other external app.

One other note on security - the tokens you use to launch an application should be kept private and guarded like a password, otherwise it's possible for other people to launch your application without your permission.

Recorded Audio Files

Note that we do not keep any recorded audio files (those created via record or startRecording/stopRecording) on hosting.tropo.com. These are sent via FTP or HTTP to the server you define in the recordURI parameter.

Next Step: Hosting Audio Files

Additional Reading

Check out the Recording Caller Input and Recording the Entire Call chapters for more information on recording.

ANNOTATIONS: EXISTING POSTS

0 posts - click the button below to add a note to this page

Accessing Call Detail Records

| TOC

| Logging & Debugging