Using the Gmail Connector

Let's get started!

Setting up the message broker profile

The message broker profile (which is an instance of WSO2 Message Broker) is shipped with the WSO2 EI product distribution. You need to enable the following configurations to be able to store messages in the broker profile.

1. Open the <EI_HOME>/conf/jndi.properties file and add the following line after the queue.MyQueue = example.MyQueue line:

   queue.PaymentRequestJMSMessageStore=PaymentRequestJMSMessageStore

2. Copy the following JAR files from the <EI_HOME>/wso2/broker/client-lib/ directory to the <EI_HOME>/lib/ directory.
   • andes-client-3.2.13.jar
   • geronimo-jms_1.1_spec-1.1.0.wso2v1.jar
   • org.wso2.securevault-1.0.0-wso2v2.jar

Creating the credentials for using the using the Gmail Connector

Creating a Client ID and Client Secret

1. As the email sender, navigate to the URL  https://console.developers.google.com/projectselector/apis/credentials  and log in to your google account. 

2. If you do not already have a project, create a new project and navigate to Create Credential -> OAuth client ID.

   At this point, if the consent screen name is not provided, you will be prompted to do so.

3. Select the Web Application option and create a client. Provide  https://developers.google.com/oauthplayground  as the redirect URL under Authorized redirect URIs and click on Create. The client ID and client secret will then be displayed. 

   See Gmail API documentation for details on creating the Client ID and Client Secret.

4. Click on the Library on the side menu, and select Gmail API. Click enable.

Obtaining the Access Token and Refresh Token

Follow these steps to automatically refresh the expired token when connecting to Google API:

1. Navigate to the URL  https://developers.google.com/oauthplayground and click on the gear wheel at the top right corner of the screen and select the option Use your own OAuth credentials. Provide the client ID and client secret you previously created and click on Close.
2. Now under Step 1, select Gmail API v1 from the list of APIs and check all the scopes listed down and click on Authorize APIs. You will then be prompted to allow permission, click on Allow.
3. In Step 2, click on Exchange authorization code for tokens to generate an display the access token and refresh token. 

Importing the Gmail Connector into EI-Tooling

1. Right click on Sample Services in the Project Explorer and Select Add or Remove Connector. Then select Add Connector and click Next.
2. Select Connector Store location and click on Connect to connect to WSO2 Connector store and scroll down and select Gmail from the list of connectors.
   

   

   
   Click Finish. 
   
   The connector is now downloaded into your Tooling environment and the connector operations will be available in the Gmail Connector palette.
   

   

Let's use these connector operations in the configuration.

Creating the Deployable Artifacts

The connector operations are used in the PaymentRequestProcessingSequence. Select this sequence, and do the following updates:

1. Add a Property Mediator just before the Call mediator to retrieve and store the patient's email address. 

   

   With the Property mediator selected, access the Properties tab of the mediator and fill in the information in the following table:

   Field	Value
   Property Name	Select New Property
   New Property Name	email_id
   Propety Action	Select Set
   Value Type	Select Expression
   Value Expression	json-eval($.patient.email)
   Description	Get Email Id

2. Add another Property mediator just after the Log mediator to retrieve and store the response sent from SettlePaymentEP. This will be used within the body of the email.

   

   With the Property mediator selected, access the Properties tab and fill in the information in the following table:

   Field	Value
   Property Name	Select New Property
   New Property Name	payment_response
   Property Action	Select Set
   Value Type	Select Expression
   Value Expression	json-eval($.)
   Description	Get Payment Response

3. Drag and drop the init method from the Gmail Connector palette adjoining the Property mediator you added in the previous step.

   

   With the init method selected, access the Properties tab and fill in the information in the following table:

   Field	Value
   Parameter Editor Type	Select inline
   userId	The sender's email address
   accessToken	The access token you obtained
   apiUrl	https://www.googleapis.com/gmail
   clientId	The client ID you created.
   clientSecret	The client secret you created.
   refreshToken	The refresh token you obtained.

4. Add the sendMail method from the Gmail Conector palette and access the Properties tab and fill in the information in the following table:

   Field	Value	Description
   Parameter Editor Type	Select inline
   to	{$ctx:email_id}	Retreives the patient email address that was stored in the relevant Property mediator.
   subject	Payment Status	The subject line in the email that is sent out.
   messageBody	{$ctx:payment_response}	Retreives the payment response that was stored in the relevant Property mediator.

   
   The updated PaymentRequestProcessingSequence should now look like this:
   

5. Save the updated sequence configuration.
6. Right click on SampleServicesConnectorExporter and navigate to New -> Add/Remove Connectors and select Add connector and click on Next. Select Workspace to list down the connectors that were added.
   

   

   

   
   Select the Gmail connector from the list and click OK and then Finish.

Packaging the artifacts

Since you added a connector to the Conector Exporter Project, this will need to be packaged into our existingCApp.

Package the C-App names SampleServicesCompositeApplication project with the artifacts created. 

Starting the Message Broker runtime 

Start the message broker profile as follows:

1. Open a terminal and navigate to the <EI_HOME>/wso2/broker/bin directory.

2. Start the runtime by executing the message broker startup script as shown below.

   sh wso2server.sh 

The message broker profile is now ready to receive messages from the integrator profile.

Starting the MSF4J profile

To be able to send requests to the back-end service (which is an MSF4J service deployed in MSF4J profile), you need to first start the MSF4J runtime:

1. Open a terminal and navigate to the <EI_HOME>/wso2/msf4j/bin directory.

2. Start the runtime by executing the MSF4J startup script as shown below.

   sh carbon.sh 

The Healthcare service is now active and you can start sending requests to the service.

Starting the Integrator runtime and deploying the artifacts

On the Servers tab, expand the WSO2 Carbon server, right-click SampleServicesCompositeApplication, and choose Redeploy. The Console window will indicate that the CApp has been deployed successfully.

Sending requests to WSO2 EI

1. Create a JSON file names request.json with the following request payload. Make sure you provide a valid email address so that you can test the email being sent to the patient. 

   {
   "name": "John Doe",
   "dob": "1940-03-19",
   "ssn": "234-23-525",
   "address": "California",
   "phone": "8770586755",
   "email": "johndoe@gmail.com",
   "doctor": "thomas collins",
   "hospital": "grand oak community hospital",
   "cardNo": "7844481124110331",
   "appointment_date": "2017-04-02"
   }

2. Open a command line terminal and execute the following command from the location where request.json file you created is saved:
   

   curl -v -X POST --data @request.json http://localhost:8280/healthcare/categories/surgery/reserve --header "Content-Type:application/json"

   This is derived from the URI-Template defined when creating the API resource.

   http://<host>:<port>/categories/{category}/reserve

   You will see the response as follows:

   {"message":"Payment request successfully submitted. Payment confirmation will be sent via email."}

   An email will be sent to the provided patient email address with the following details:

   Subject: Payment Status
    
   Message:
   {"appointmentNo":2,"doctorName":"thomas collins","patient":"John
   Doe","actualFee":7000.0,"discount":20,"discounted":5600.0,"paymentID":"8458c75a-c8e0-4d49-8da4-5e56043b1a20","status":"Settled"}

You have now explored how to import the Gmail connector in WSO2 EI and then use the connector operation to send emails.