Added spark_checkin

Author: hpreston

spark_checkin/README.md

@@ -0,0 +1,72 @@
+# EEM Spark-CheckIn
+
+This example script sends a notification message to a Cisco Spark user of a Configuration Change.  It was created to be used along with an EEM Applet that monitors for configuration changes, and then executes the script leveraging Python withing Guest Shell.  
+
+This example was tested using IOS-XE 16.5.1b on an ISR 4K router, and on a Nexus 9000 7.0(3)I5(2) but should work on other platforms supporting Guest Shell.  
+
+This example script uses the CiscoSparkApi Python library to send the Spark Message.  
+
+You will need to provide the Spark Authorization Token and recipient email address within the EEM Configuration.  It is recommended that you create a [Bot Account](https://developer.ciscospark.com/bots.html) for this use case.  
+  
+This script has been tested with Python 2.7, however may work with other versions.  
+    
+    
+# Requirements and Setup 
+
+## Host Device and Guest Shell
+
+IOS-XE or NX-OS device supporting Guest Shell and EEM.  
+
+Example Steps to configure Guest Shell on IOS-XE are: 
+
+```
+conf t
+iox
+exit
+guestshell enable 
+
+! Enter Guest Shell with 
+guestshell run bash 
+```
+
+### Python Library
+
+- ciscosparkapi Python Library 
+
+```
+# From within Guest Shell 
+sudo -E pip install ciscosparkapi 
+```
+
+## Create folder for Scripts and Add Script 
+
+```
+# From within Guest Shell 
+mkdir /bootflash/scripts 
+cd /bootflash/scripts
+wget https://raw.githubusercontent.com/CiscoDevNet/python_code_samples_network/master/spark_checkin/spark_checkin.py
+
+```
+
+## Test Script 
+
+Test the script by running in manually from within guestshell.  
+
+```
+python spark_checkin.py -t SPARK_AUTH_TOKEN -e DESTINATION_EMAIL
+```
+
+You should recieve a message similar to this in Spark.  
+
+![](Spark_Message.png)
+
+## Setup EEM Applet
+
+Back within IOS, configure the EEM Applet to monitor for Configuration Changes.  
+
+```
+event manager applet GUESTSHELL-CONFIG-CHANGE-TO-SPARK
+ event syslog pattern "%SYS-5-CONFIG_I: Configured from"
+ action 0.0 cli command "en"
+ action 1.0 cli command "python spark_checkin.py -t SPARK_AUTH_TOKEN -e DESTINATION_EMAIL"
+```

spark_checkin/Spark_Message.png

@@ -0,0 +1 @@
+ciscosparkapi

spark_checkin/requirements.txt

@@ -0,0 +1,25 @@
+from ciscosparkapi import CiscoSparkAPI
+
+if __name__=='__main__':
+    # Use ArgParse to retrieve command line parameters.
+    from argparse import ArgumentParser
+    parser = ArgumentParser("Spark Check In")
+
+    # Retrieve the Spark Token and Destination Email
+    parser.add_argument(
+        "-t", "--token", help="Spark Authentication Token", required=True
+    )
+    # Retrieve the Spark Token and Destination Email
+    parser.add_argument(
+        "-e", "--email", help="Email to Send to", required=True
+    )
+
+    args = parser.parse_args()
+
+    token = args.token
+    email = args.email 
+    message = "**Alert:** Config Changed"
+
+    api = CiscoSparkAPI(access_token=token)
+    api.messages.create(toPersonEmail=email, markdown=message)
+