README.md

Spark Tropo

This is a simple application that integrates Tropo with Spark. When a user texts the Tropo number, their text is posted to a specific Spark room. This app is an introductory tutorial to the Tropo Scripting API and Spark Web API.

Setup repo

1. Clone this repo onto your machine

Setup Spark

1. Register on Spark
   Go to https://web.ciscospark.com/#/signin and enter your email.
   Cisco will send an email to confirm your email. Then you will set your password.
   After that it will log you into the Spark chat room.

<script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>

2. Get Spark Access Token
3. Go to https://developer.ciscospark.com
4. Click Login. It should automatically log you in since you already logged in to Spark.
5. Click the avatar in the right hand upper corner.
6. Click Copy.
   <script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>
7. In heroku/constants.py replace 'Put your token here' on line 19 with your access token.
   <script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>
8. Commit your change.

Setup Tropo

1. Register on Tropo

2. Go to https://www.tropo.com

3. Click Register

4. Submit the registration form

5. Check your email and confirm your account

6. Create new scripting app

7. Click Create New App

8. Name your app
   <script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>

9. Create new script
   1. Click on New script. 2. Paste the code from tropo/spark.py, enter the filename and click Save.
   <script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>

10. Click CREATE APP

11. Add number

12. Scroll down to the Numbers section

13. Select Country

14. Select Region

15. Click ADD
    <script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>

Setup Heroku

1. Sign up or Log in to Heroku: https://www.heroku.com

2. Create new app

3. Click the + icon in the upper right hand corner.
   <script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>

4. Select Create new app

5. Enter your app name

6. Select the region for app's runtime (eg. United States or Europe).

7. Click Create App
   <script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>

8. Deploy the app.
   Note: you should be on the Deploy tab.
   <script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>

9. Scroll down to the section Deploy using Heroku Git.
   <script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>

10. Follow the instructions.
    Note: You will not need to enter git init since the repo was cloned.

11. Enter heroku app name in Tropo script

12. On your Tropo app, click Edit script

13. Change the url on line 15 to your Heroku app url
    <script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>

Play with your app

1. Congratulations! Your app is live.
2. Text the Tropo number and watch your text post in Spark. :)

Text

<script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>

Chat

<script async src="//embedr.flickr.com/assets/client-code.js" charset="utf-8"></script>