Casey is a virtual assistant that helps you create and manage GVE cases, anywhere and on the go using Spark.
Our mission is to make the process of raising a case with GVE as natural and intuitive as possible.
Using Casey to open and manage GVE cases gives the case creator the capability to do it through an application
used in all aspects of the working day - Cisco Spark.
The ultimate goal is to save time and reduce much of the complexity and manual tasks behind opening a case with GVE.
Currently, you can interact with Casey on an individual basis or you can add her to a team space. For the latter,
you will have to do a direct mention
(@Casey) every time you want to interact with her or answer her clarification
As of this moment, Casey is able to raise a case with GVE by sending an email to the GVE case handler
team with all the required information.
All you need to do is tell Casey that you wish to open a case. For example:
Hi Casey, I would like to open a case with GVE
Casey will then ask you further clarification questions and send an email out to the GVE case handler team
firstname.lastname@example.org with the requester in CC.
Create a bot in the Spark Developer portal
Follow the instructions to create a new bot in the Cisco Spark Developer Portal.
Cisco requires you to choose an avatar for your bot before you can create it in their portal. This needs to be a 512x512px image icon. - this can be changed later.
You can either choose one of their default icons or you can download this one to your machine and upload it to the portal.
Take note of the bot
username and the
access token that is specific to your bot. Store the
access token somewhere as you won't be able to see this later - but you will be able to revoke it and create a new one.
Set the following environment variables. If developing locally, you can put these in the
access_tokenThe bot's access token that you have created on Cisco Spark Developers page (required)
public_addressThe address at which your bot can be reached (required)
secretUser-defined string to validate the origin of webhooks and for encrypting cookies. Generate a random string for this value. (required)
studio_tokenBotkit Studio API token (optional)
Once you have all the variables above you can run Casey on Heroky by clicking here or by clicking in the icon at the top of this page.
Clone this repository:
git clone https://github.com/JPedro2/SparkBotsANDTings.git
Install all dependencies, including Botkit
cd SparkBotsANDTings npm install
Create a public address
Cisco Spark requires your application be available at an SSL-enabled endpoint. During development it is recommend to use ngrok, which can be used to temporarily expose Casey to the internet. Feel free to use others, such as localtunnel.me.
Once ngrok is set up, run it in order to get Casey's public address. You will need to copy the
ngrok http 3000
Run Casey from the command line:
access_token=<SPARK_BOT_ACCESS_TOKEN> public_address=<HTTPS_ADDRESS_FROM_NGROK_OR_OTHER> node bot.js
Please Note that during development the
secret variable can be ignored.