Merge branch 'master' into master

Author: Joseph Zanini

.gitignore

@@ -1,6 +1,6 @@
 # Local Files
 local/
-
+.vscode/
 
 # Virtual Environments
 .venv/

Pipfile.lock

@@ -1,8 +1,8 @@
 =============
-webexteamssdk
+WebexPythonSDK
 =============
 
-*Work with the Webex Teams APIs in native Python!*
+*Work with the Webex APIs in native Python!*
 
 .. image:: https://img.shields.io/badge/license-MIT-blue.svg
     :target: https://github.com/CiscoDevNet/webexteamssdk/blob/master/LICENSE
@@ -27,8 +27,8 @@ ideas there.
 ------------------------------------------------------------------------------------------------------------------------
 
 
-**webexteamssdk** is a *community developed* Python library for working with the Webex Teams APIs.  Our goal is to make
-working with Webex Teams in Python a *native* and *natural* experience!
+**WebexPythonSDK** is a *community developed* Python library for working with the Webex APIs.  Our goal is to make
+working with Webex in Python a *native* and *natural* experience!
 
 .. code-block:: Python
 
@@ -57,27 +57,27 @@ working with Webex Teams in Python a *native* and *natural* experience!
                         files=["https://www.webex.com/content/dam/wbx/us/images/dg-integ/teams_icon.png"])
 
 
-That's more than 6 Webex Teams API calls in less than 23 lines of code (with comments and whitespace), and likely more
-than that, since webexteamssdk handles pagination_ for you automatically!
+That's more than 6 Webex API calls in less than 23 lines of code (with comments and whitespace), and likely more
+than that, since WebexPythonSDK handles pagination_ for you automatically!
 
-webexteamssdk makes your life better...  `Learn how!`__
+WebexPythonSDK makes your life better...  `Learn how!`__
 
 __ Introduction_
 
 
 Features
 --------
 
-webexteamssdk does all of this for you:
+WebexPythonSDK does all of this for you:
 
-* Transparently sources your Webex Teams access token from your local environment
+* Transparently sources your Webex access token from your local environment
 
 * Provides and uses default arguments and settings everywhere possible, so you don't have to think about things like API
   endpoint URLs, HTTP headers and JSON formats
 
-* Represents all Webex Teams API interactions using native Python tools
+* Represents all Webex API interactions using native Python tools
 
-  * Authentication and Connection to the Webex Teams Cloud ==> **WebexTeamsAPI** "connection object"
+  * Authentication and Connection to the Webex Cloud ==> **WebexTeamsAPI** "connection object"
 
   * API Calls ==> Hierarchically organized methods underneath the **WebexTeamsAPI** 'Connection Object'
 
@@ -139,10 +139,10 @@ published releases.
 Questions, Support & Discussion
 -------------------------------
 
-webexteamssdk is a *community developed* and *community-supported* project.  If you experience any issues using this
+WebexPythonSDK is a *community developed* and *community-supported* project.  If you experience any issues using this
 package, please report them using the issues_ page.
 
-Please join the `Python Webex Teams Devs`__ Webex Teams space to ask questions, join the discussion, and share your
+Please join the `Python Webex Teams Devs`__ Webex space to ask questions, join the discussion, and share your
 projects and creations.
 
 __ Community_
@@ -151,15 +151,15 @@ __ Community_
 Contribution
 ------------
 
-webexteamssdk_ is a community development project.  Feedback, thoughts, ideas, and code contributions are welcome!
+WebexPythonSDK is a community development project.  Feedback, thoughts, ideas, and code contributions are welcome!
 Please see the `Contributing`_ guide for more information.
 
 
 History
 -------
 
-The Webex Teams SDK (webexteamssdk) library started as Cisco Spark API (ciscosparkapi). We updated the library's name in
-alignment with Cisco's re-brand of Cisco Spark to Webex Teams. The Cisco Spark API library has been deprecated and is no
+The Webex Python SDK (webexteamssdk) library started as Cisco Spark API (ciscosparkapi). We updated the library's name in
+alignment with Cisco's re-brand of Cisco Spark to Webex. The Cisco Spark API library has been deprecated and is no
 longer supported; however, its open-source codebase is still available in the `ciscosparkapi`_ branch of this
 repository.
 
@@ -172,7 +172,7 @@ developer.webex.com.
 
 .. _Release Plan: https://github.com/CiscoDevNet/webexteamssdk/wiki/Release-Plans
 .. _Introduction: http://webexteamssdk.readthedocs.io/en/latest/user/intro.html
-.. _pagination: https://developer.webex.com/pagination.html
+.. _pagination: https://developer.webex.com/docs/basics#pagination
 .. _webexteamssdk.readthedocs.io: https://webexteamssdk.readthedocs.io
 .. _Quickstart: http://webexteamssdk.readthedocs.io/en/latest/user/quickstart.html
 .. _examples: https://github.com/CiscoDevNet/webexteamssdk/tree/master/examples

README.rst

@@ -4,23 +4,26 @@
 Cards and Buttons
 =================
 
-Webex Teams supports `AdaptiveCards <https://www.adaptivecards.io/>`_ to allow
+Webex supports `AdaptiveCards <https://www.adaptivecards.io/>`_ to allow
 new levels of interactivity for bots and integrations. You can read more about
 how cards and buttons work `in the official guide <https://developer.webex.com/docs/api/guides/cards>`_.
 
-In this guide I want to cover the abstraction build into the webexteamssdk that
+In this guide I want to cover the abstraction built into the webexteamssdk that
 lets you author adaptive cards in pure python without having to touch the
-underlying json of a adaptive card.
+underlying JSON of an adaptive card.
+
+Sending a card
+==============
 
 Lets dive into a simple example that sends a card to a room
 
 .. code-block:: python
 
     from webexteamssdk import WebexTeamsAPI
-    from webexteamssdk.cards.card import AdaptiveCard
-    from webexteamssdk.cards.inputs import Text, Number
-    from webexteamssdk.cards.components import TextBlock
-    from webexteamssdk.cards.actions import Submit
+    from webexteamssdk.models.cards.card import AdaptiveCard
+    from webexteamssdk.models.cards.inputs import Text, Number
+    from webexteamssdk.models.cards.components import TextBlock
+    from webexteamssdk.models.cards.actions import Submit
 
     greeting = TextBlock("Hey hello there! I am a adaptive card")
     first_name = Text('first_name', placeholder="First Name")
@@ -33,7 +36,41 @@ Lets dive into a simple example that sends a card to a room
     api = WebexTeamsAPI()
     api.messages.create(text="fallback", roomId="...", attachments=[card])
 
-The message we send with this code then looks like this in our Webex Teams
+The message we send with this code then looks like this in our Webex space
 client:
 
 .. image:: ../images/cards_sample.png
+
+
+Processing a card action
+========================
+
+
+Adaptive card interactions are treated as "attachment actions". Once user interacts 
+with your card and submits an action, your app will receive a webhook from Webex. You 
+must :ref:`setup a webhook <webhooks>` in advance with ``resource = "attachmentActions"`` 
+and ``event = "created"``.
+
+Webhook payload will contain a JSON:
+
+.. code-block:: json
+
+    {
+        "resource": "attachmentActions",
+        "event": "created",
+        "data": {
+            "id": "XYXYXY",
+            "type": "submit"
+        }
+    }
+
+Extract attachment action ID from ``['data']['id']`` and 
+use :ref:`attachment_actions.get() <attachment_actions>` to get full information 
+about user action and any submitted data.
+
+.. code-block:: python
+
+    action = api.attachment_actions.get(webhookJson['data']['id'])
+
+    first_name = action.inputs['first_name']
+    age = action.inputs['age']

docs/user/cards.rst

@@ -26,9 +26,9 @@ requesting user.
 To get your personal access token:
 
     1. Login to `developer.webex.com`_
-    2. Click on Docs or browse to the `Getting Started <https://developer.webex.com/getting-started.html>`_ page
+    2. Click on Docs or browse to the `Getting Started <https://developer.webex.com/docs/getting-started>`_ page
     3. You will find your *personal access token* in the
-       `Authentication <https://developer.webex.com/getting-started.html#authentication>`_ section
+       `Authentication <https://developer.webex.com/docs/getting-started#accounts-and-authentication>`_ section
 
 .. image:: ../images/personal_access_token.png
 
@@ -60,7 +60,7 @@ It can be as simple as setting it in your CLI before running your script...
 
 .. code-block:: bash
 
-    $ WEBEX_TEAMS_ACCESS_TOKEN=your_access_token_here
+    $ export WEBEX_TEAMS_ACCESS_TOKEN=your_access_token_here
     $ python myscript.py
 
 ...or putting your credentials in a shell script that you ``source`` when your