reflected changes from Webex rebrand

Author: ObjectIsAdvantag

.env

@@ -11,10 +11,10 @@
 # - note that ".env" is formatted like a shell file, so you may (depending on your platform) need to add double quotes if strings contains spaces
 #
 
-# Uncomment if you wish to statically set a Cisco Spark access token
+# Uncomment if you wish to statically set a Webex Teams API access token
 # - if you do so, make sure not to version that file in a public repo
 # - if running the code from a private machine, setting secrets on the command line is recommended
-SPARK_TOKEN=
+ACCESS_TOKEN=
 
 # Secret used to generate an HMAC-SHA1 for each payload submitted to your bot
 # Optional but highly recommended to use a Secret when going to production
@@ -27,19 +27,19 @@ SECRET="Not that secret !"
 #PUBLIC_URL=https://your-app.herokuapp.com
 #PUBLIC_URL=https://sharp-stove.glitch.me
 
-# Name used to create the webhook to register your bot against Cisco Spark
+# Name used to create the webhook to register your bot against Webex
 # Defaults to 'built with BotKit (development)'
 #
 # WARNING: if you set or update this value,
-#   - BotKit will automatically create a new Cisco Spark WebHook with the SPARK_TOKEN above
+#   - BotKit will automatically create a new webHook with the ACCESS_TOKEN above
 #   - BUT BotKit will not delete the previously created WebHook entry
 #   - YOU will need to take this action manually
 # HERE'S HOW
-#   - manually list your bot webhooks via Postman or the Spark API documentation
+#   - manually list your bot webhooks via Postman or the Webex for Developers API documentation
 #     /!\ make sure to use your bot's access token
-#     https://developer.ciscospark.com/endpoint-webhooks-get.html
+#     https://developer.webex.com/endpoint-webhooks-get.html
 #   - identify the previously registered webhook identifier and delete it
-#     https://developer.ciscospark.com/endpoint-webhooks-webhookId-delete.html
+#     https://developer.webex.com/endpoint-webhooks-webhookId-delete.html
 #WEBHOOK_NAME="built with BotKit (development)"
 
 # Local port where your bot will be started

.gitignore

@@ -1 +1,2 @@
 node_modules
+*.lock

.vscode/launch.json

@@ -8,7 +8,7 @@
             "program": "${workspaceRoot}/bot.js",
             "envFile": "${workspaceRoot}/.env",
             "env": {
-                "SPARK_TOKEN": "PLACE_YOUR_BOT_TOKEN_HERE_FOR_DEBUG_PURPOSE",
+                "ACCESS_TOKEN": "PLACE_YOUR_ACCESS_TOKEN_HERE",
                 "PUBLIC_URL": "https://718670a3.ngrok.io",
                 "REDIS_URL": "redis://127.0.0.1:6379"
             }

CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changes
+
+### v0.7-redis (2018-05-17): reflecting Webex Teams rebrand
+   - introducing ACCESS_TOKEN env variable
+   - backward compatibility for SPARK_TOKEN env variable
+   - documentation updates (removing spark mentions)
+   - added popular skills from convos@sparkbot.io
+
+### v0.6-redis (2017-11-17): legacy version for Cisco Spark
+   - Redis support via the REDIS_URL variable
+
+and all others features for the master branch
+   - configuration through environment variables or hard-coded values in the .env file
+   - skills: organize your bot behaviours by placing 'commands', 'conversations' and 'events' in the skills directory
+   - user experience: the template comes with ready-to-use skills: a 'welcome' invite, as well as 'help' and 'fallback' commands.
+   - healthcheck: easily check that everything goes well by hitting the ping endpoint automatically exposed.
+   - metadata: expose extra info via command and on a public address so that Spark users can inquire on Bot Author / Legal mentions / Healthcheck endpoint...
+   - mentions: the appendMention utility function helps Spark users remind to mention the bot in Group spaces.
+popular cloud providers: the bot self-configures when run on Glitch, and also Heroku (if dyno-metadata are installed for Heroku).

README.md

@@ -1,4 +1,4 @@
-# Template to bootstrap a Botkit project for Cisco Spark
+# Template to bootstrap a Botkit project for Webex Teams
 
 This template regroups a set of best practices:
 
@@ -10,18 +10,18 @@ This template regroups a set of best practices:
 
 - healthcheck: easilly check that everything goes well by hitting the `ping` endpoint automatically exposed.
 
-- metadata: expose extra info via command and on a public address so that Spark users can inquire on Bot Author / Legal mentions / Healthcheck endpoint...
+- metadata: expose extra info via command and on a public address so that Webex Teams users can inquire on Bot Author / Legal mentions / Healthcheck endpoint...
 
-- mentions: the appendMention utility function helps Spark users remind to mention the bot in Group spaces.
+- mentions: the appendMention utility function helps Webex Teams users remind to mention the bot in Group spaces.
 
-- popular cloud providers: the bot self-configures when run on Glitch and Heroku (if )
+- popular cloud providers: the bot self-configures when run on Glitch and Heroku (if the dyno_metadata feature is activated)
 
 
 ## Quick start on Glitch
 
 Click [![Remix on Glitch](https://cdn.glitch.com/2703baf2-b643-4da7-ab91-7ee2a2d00b5b%2Fremix-button.svg)](https://glitch.com/edit/#!/import/github/CiscoDevNet/botkit-template)
 
-Then open the `.env` file and paste your bot's token into the SPARK_TOKEN variable.
+Then open the `.env` file and paste your bot's token into the ACCESS_TOKEN variable.
 
 You bot is all set, responding in 1-1 and 'group' spaces, and sending a welcome message when added to a space,
 Its healthcheck is accessible at your application public url, suffixed with "/ping" 
@@ -33,7 +33,7 @@ _Note that thanks to Glitch 'PROJECT_DOMAIN' env variable, you did not need to a
 
 Create a new project pointing to this repo.
 
-Reach to your app settings, reveal your config variables, and add a SPARK_TOKEN variable with your bot token as value.
+Reach to your app settings, reveal your config variables, and add a ACCESS_TOKEN variable with your bot token as value.
 
 Unless your app is using [Dyno Metadata](https://devcenter.heroku.com/articles/dyno-metadata), you also need to add a PUBLIC_URL variable pointing to your app domain.
 
@@ -48,7 +48,7 @@ Its healthcheck is accessible at your application public url, suffixed with "/pi
 Assuming you plan to expose your bot via [ngrok](https://ngrok.com),
 you can run this template in a snatch.
 
-1. Create a Bot Account from the ['Spark for developers' bot creation page](https://developer.ciscospark.com/add-bot.html), and copy your bot's access token.
+1. Create a Bot Account from the ['Webex for developers' bot creation page](https://developer.webex.com/add-bot.html), and copy your bot's access token.
 
 2. Launch ngrok to expose port 3000 of your local machine to the internet:
 
@@ -62,7 +62,7 @@ you can run this template in a snatch.
 
     _Note that you can also specify any of these settings via env variables. In practice, the values on the command line or in your machine env will prevail over .env file settings_
 
-    To successfully run your bot, you'll need to specify a PUBLIC_URL for your bot, and a Cisco Spark API token (either in the .env settings or via env variables). In the example below, we do not modify any value in settings and specify all configuration values on the command line.
+    To successfully run your bot, you'll need to specify a PUBLIC_URL for your bot, and a Webex Teaùs API ACCESS_TOKEN (either in the .env settings or via env variables). In the example below, we do not modify any value in settings and specify all configuration values on the command line.
 
 4. You're ready to run your bot
 
@@ -72,7 +72,7 @@ you can run this template in a snatch.
     git clone https://github.com/CiscoDevNet/botkit-template
     cd botkit-template
     npm install
-    SPARK_TOKEN=0123456789abcdef PUBLIC_URL=https://abcdef.ngrok.io node bot.js
+    ACCESS_TOKEN=0123456789abcdef PUBLIC_URL=https://abcdef.ngrok.io node bot.js
     ```
 
     From a windows shell:
@@ -81,13 +81,13 @@ you can run this template in a snatch.
     > git clone https://github.com/CiscoDevNet/botkit-template
     > cd botkit-template
     > npm install
-    > set SPARK_TOKEN=0123456789abcdef
+    > set ACCESS_TOKEN=0123456789abcdef
     > set PUBLIC_URL=https://abcdef.ngrok.io
     > node bot.js
     ```
 
     where:
 
-    - SPARK_TOKEN is the API access token of your Cisco Spark bot
-    - PUBLIC_URL is the root URL at which Cisco Spark can reach your bot
+    - ACCESS_TOKEN is the API access token of your bot
+    - PUBLIC_URL is the root URL at which the Webex cloud platform can reach your bot
     - [ngrok](http://ngrok.com) helps you expose the bot running on your laptop to the internet, type: `ngrok http 3000` to launch

bot.js

@@ -10,15 +10,19 @@
 // Load environment variables from project .env file
 require('node-env-file')(__dirname + '/.env');
 
-if (!process.env.SPARK_TOKEN) {
-    console.log("Could not start as bots require a Cisco Spark API access token.");
-    console.log("Please add env variable SPARK_TOKEN on the command line or to the .env file");
+
+// Fetch token from environement
+// [COMPAT] supports SPARK_TOKEN for backward compatibility
+var accessToken = process.env.ACCESS_TOKEN || process.env.SPARK_TOKEN 
+if (!accessToken) {
+    console.log("Could not start as this bot requires a Webex Teams API access token.");
+    console.log("Please invoke with an ACCESS_TOKEN environment variable");
     console.log("Example: ");
-    console.log("> SPARK_TOKEN=XXXXXXXXXXXX PUBLIC_URL=YYYYYYYYYYYYY node bot.js");
+    console.log("> ACCESS_TOKEN=XXXXXXXXXXXX PUBLIC_URL=YYYYYYYYYYYYY node bot.js");
     process.exit(1);
 }
 
-// Get public URL where Cisco Spark will post spaces notifications (webhook registration)
+// Get public URL where Web will post notifications (webhook registration)
 var public_url = process.env.PUBLIC_URL;
 // Infer the app domain for popular Cloud PaaS
 if (!public_url) {
@@ -37,7 +41,7 @@ if (!public_url) {
     console.log("Could not start as this bot must expose a public endpoint.");
     console.log("Please add env variable PUBLIC_URL on the command line or to the .env file");
     console.log("Example: ");
-    console.log("> SPARK_TOKEN=XXXXXXXXXXXX PUBLIC_URL=YYYYYYYYYYYYY node bot.js");
+    console.log("> ACCESS_TOKEN=XXXXXXXXXXXX PUBLIC_URL=YYYYYYYYYYYYY node bot.js");
     process.exit(1);
 }
 
@@ -53,9 +57,8 @@ var env = process.env.NODE_ENV || "development";
 var configuration = {
     log: true,
     public_address: public_url,
-    ciscospark_access_token: process.env.SPARK_TOKEN,
-    secret: process.env.SECRET, // this is a RECOMMENDED security setting that checks of incoming payloads originate from Cisco Spark
-    webhook_name: process.env.WEBHOOK_NAME || ('built with BotKit (' + env + ')')
+    ciscospark_access_token: accessToken,
+    secret: process.env.SECRET, // this is a RECOMMENDED security setting that checks if incoming payloads originate from Webex    webhook_name: process.env.WEBHOOK_NAME || ('built with BotKit (' + env + ')')
 }
 
 if (process.env.REDIS_URL) {
@@ -73,7 +76,7 @@ if (process.env.REDIS_URL) {
         //, namespace: 'cisco:devnet'         
     };
 
-    // Create Redis storage for BotKit
+    // Create Redis storage for Botkit
     try {
         var redisStorage = require('botkit-storage-redis')(redisConfig);
 
@@ -102,7 +105,7 @@ var bot = controller.spawn({
 var port = process.env.PORT || 3000;
 controller.setupWebserver(port, function (err, webserver) {
     controller.createWebhookEndpoints(webserver, bot, function () {
-        console.log("Cisco Spark: Webhooks set up!");
+        console.log("webhooks setup successfully");
     });
 
     // installing Healthcheck
@@ -115,7 +118,7 @@ controller.setupWebserver(port, function (err, webserver) {
     };
     webserver.get(process.env.HEALTHCHECK_ROUTE, function (req, res) {
 
-        // As the identity is load asynchronously from Cisco Spark token, we need to check until it's fetched
+        // As the identity is load asynchronously from the access token, we need to check until it's fetched
         if (healthcheck.bot == "unknown") {
             var identity = bot.botkit.identity;
             if (bot.botkit.identity) {
@@ -125,7 +128,7 @@ controller.setupWebserver(port, function (err, webserver) {
 
         res.json(healthcheck);
     });
-    console.log("Cisco Spark: healthcheck available at: " + process.env.HEALTHCHECK_ROUTE);
+    console.log("healthcheck available at: " + process.env.HEALTHCHECK_ROUTE);
 });
 
 
@@ -137,20 +140,20 @@ var normalizedPath = require("path").join(__dirname, "skills");
 require("fs").readdirSync(normalizedPath).forEach(function (file) {
     try {
         require("./skills/" + file)(controller, bot);
-        console.log("Cisco Spark: loaded skill: " + file);
+        console.log("loaded skill: " + file);
     }
     catch (err) {
         if (err.code == "MODULE_NOT_FOUND") {
             if (file != "utils") {
-                console.log("Cisco Spark: could not load skill: " + file);
+                console.log("could not load skill: " + file);
             }
         }
     }
 });
 
 
 //
-// Cisco Spark Utilities
+// Webex Teams Utilities
 //
 
 // Utility to add mentions if Bot is in a 'Group' space

docs/heroku_config-variables.png

@@ -1,19 +1,20 @@
 {
-  "description": "Botkit template for Cisco Spark",
-  "version": "0.6.0-redis3",
+  "description": "Botkit template for Webex Teams with Redis support",
+  "version": "0.7.0-redis1",
   "main": "bot.js",
   "scripts": {
     "start": "node bot.js"
   },
   "keywords": [
-    "ciscospark",
+    "webex",
+    "webex-teams",
     "botkit",
     "devnet"
   ],
   "author": "Stève Sfartz (Cisco DevNet) <stsfartz@cisco.com>",
   "license": "MIT",
   "dependencies": {
-    "botkit": "0.6.0",
+    "botkit": "0.6.14",
     "botkit-storage-redis": "1.1.0",
     "node-env-file": "0.1.8"
   },

package.json

@@ -1,11 +1,6 @@
 # Placeholder for your bot's skills
 
+This directory and subdirectories are automatically imported.
 Add scripts to enrich your bot skills.
 
 _Note that the skills are imported in alphabetical order of their file name. As such, the fallback skill is prefixed with a 'z-' to ensure it is loaded last, ie, if no pattern match, the fallback skill will apply to any message sent to the bot_
-
-
-This directory and subdirectories are automatically imported by the Cisco Spark starter kit.
-
-_Note that you can place common code in the 'utils' directory, as it is not loaded automatically by design._
-

skills/README.md

@@ -21,9 +21,11 @@ module.exports = function (controller, bot) {
         "support-contact": "Stève Sfartz <mailto:stsfartz@cisco.com>",
 
         // Messaging platform
-        "plaform": bot.type,
+        // [WORKAROUND] overriding Botkit's integrated support temporarly as 'ciscospark' is still returned
+        //"plaform": bot.type,
+        "plaform": "webex",
 
-        // the precise bot identity is loaded asynchronously, as /people/me request - issued by "BotKit CiscoSparkBot.js" - returns
+        // the precise bot identity is loaded asynchronously, from a GET /people/me request
         "identity": "unknown",
 
         // Endpoint where to check the bot is alive
@@ -37,13 +39,13 @@ module.exports = function (controller, bot) {
     // Adding a metadata endpoint
     //
     controller.webserver.get(process.env.BOTCOMMONS_ROUTE, function (req, res) {
-        // As the identity is load asynchronously from Cisco Spark token, we need to check until it's fetched
+        // As the identity is load asynchronously from the access token, we need to check until it's fetched
         if ((botcommons.identity == "unknown") && (bot.botkit.identity)) {
             botcommons.identity = bot.botkit.identity.emails[0];
         }
         res.json(botcommons);
     });
-    console.log("CiscoSpark: Bot metadata available at: " + process.env.BOTCOMMONS_ROUTE);
+    console.log("bot metadata available at: " + process.env.BOTCOMMONS_ROUTE);
 
     //
     // .botcommons skill
@@ -62,4 +64,4 @@ module.exports = function (controller, bot) {
         bot.reply(message, '```json\n' + metadata + '\n```');
     });
 
-}
+}