Setting Up Zapier.
==================

Outline
-------

This will take you through creating a Zap for sending notifications to your selected \
chat user or group.
I will not provide instructions on creating a `Zapier <https://zapier.com>`_ account.
I believe this is fairly simple and straight forward. Linking your google account to Zapier.

The Steps:
----------

Step 1:
^^^^^^^

Either Click 'MAKE A ZAP' or 'Create Zap'

.. image:: images/Zapier/1-Zapier-CreateZap.png

Step 2:
^^^^^^^
Give your Zap a name. I have used 'ZapierDemo'
If you don't see Gmail in the app list, enter it in the search as I have done.
Click on 'Gmail'

.. image:: images/Zapier/2-Zapier-Gmail.png

Step 3:
^^^^^^^

Choose your 'Trigger Event'
You should choose 'New Thread'

.. image:: images/Zapier/3-Zapier-Gmail-Thread-Select.png

.. image:: images/Zapier/4-Zapier-Gmail-Thread.png

Step 4:
^^^^^^^

Click 'Continue'

Step 5:
^^^^^^^

Select your connected Gmail account. This will tell Zapier which gmail account to monitor.

.. image:: images/Zapier/5-Zapier-Choose-Account.png

Click 'Continue'

step 6:
^^^^^^^

Select the correct Gmail Label. In this case we are using 'ZapierLine'

.. image:: images/Zapier/6-Zapier-Choose-Label.png

Click 'Continue'

Step 7:
^^^^^^^

Next we need to 'Test your Trigger'. So click this button.

This will now look for any messages that contain the label we have provided. 'ZapierLine'

.. image:: images/Zapier/8-Zapier-Thread-Sample.png

If you are happy with the result. Click 'Continue'

Step 8:
^^^^^^^

Enter 'Code by Zapier' and click on 'Code by Zapier'

.. image:: images/Zapier/9-Zapier-Code-By-Zapier.png

Step 9:
^^^^^^^

For 'Choose Action Event' select 'Run Python'

.. image:: images/Zapier/10-Zapier-Run-Python.png

Click 'Continue'

Step 10:
^^^^^^^^

At this point we will start selecting what information we want to extract from the email.
This is of course optional. If you wish you could simply have a notification sent to your line \
account letting you know to check your email.
However in this case we will collect some data to add to the notification.

I will extract the following details. from, subject and body. These names are provided by me.
I will then select from the drop down the actual items I am looking for.

.. image:: images/Zapier/11-Zapier-Extraction.png

.. image:: images/Zapier/12-Zapier-Extraction-Complete.png

Next we need to enter our code in the code window.

Sample 1:
This code simply takes the plain text body of the email and sends it in the notification.

.. code-block:: python
   :linenos:

   import requests
   API_URI = "https://notify-api.line.me/api/notify"

   text_message = input.get('body')
   TOKEN = "YOUR_GENERATED_TOKEN_GOES_HERE"
   HEADER = {"Authorization": "Bearer " + TOKEN}
   PARAMS = {"message": text_message}

   response = requests.post(API_URI, headers=HEADER, params=PARAMS)
   response.raise_for_status()
   return {'rawHtml': response.text}

Sample 2:
This code sends a different text message depending on the from address of the sender.

.. code-block:: Python
   :linenos:

   import requests
   API_URI = "https://notify-api.line.me/api/notify"

   if input.get('from') == 'AddressA':
      text_message = "This is the message from sender A"
   if input.get('from') == 'AddressB':
      text_message = "This is the message from sender B with email body included:\n\n{}".format(input.get('body'))

   TOKEN = "YOUR_TOKEN_GOES_HERE"
   HEADER = {"Authorization": "Bearer " + TOKEN}
   PARAMS = {"message": text_message}

   response = requests.post(API_URI, headers=HEADER, params=PARAMS)
   response.raise_for_status()
   return {'rawHtml': response.text}

.. image:: images/Zapier/13-Zapier-Test.png

.. image:: images/Zapier/14-Zapier-Result.png

NOTE: If you get an error message that execution took more than 1 second. This can be ignored.
Simply Click the 'Skip Test' in the upper right corner.

Step 11:
^^^^^^^^

Activate your ZAP

.. image:: images/Zapier/15-Zapier.png

.. image:: images/Zapier/16-Zapier.png