Zapier Integration


About This Integration

IntegrationIntroduction

You can integrate third-party systems with Product name - ev itsm.png in many ways. The method you select will depend on business requirements, architectural and security constraints as well as the characteristics specific to each third-party application or service.

This document describes an integration process that has already been implemented in a customer context. 

To find out more about this integration (e.g. scripts to be used), please contact the Logo - EasyVista.png Consulting & Professional Services team, the Logo - EasyVista.png Support team, or your service provider and integrator.
 

Integration Summary

Zapier is a middleware that enables the simple integration and connection of more than 750 web applications to make life easier for users (individuals, SMEs or major corporations) and application integrators, in particular by removing the need to write code, create software interfaces and study the APIs of supported web applications.

This tool uses a mechanism based on preset workflows.

  • An integration between 2 applications is called a zap and may be configured in just a few minutes. 
  • A zap is made up of a main trigger and one or more actions or searches defining other triggers.
     

example  When I receive an email in my Gmail inbox, it:

  • copies the attachment to my Dropbox account;
  • sends me a Slack alert telling me a new file is available in my Dropbox account;
  • sends me a text message.

 

You can perform 2 integrations between Service Manager and supported third-party services using Zapier.

  • Carry out actions in a third-party service from an Service Manager workflow or business rule.  Open url.png See Integration Process no. 1.

    example

    • Creation of an incident in Service Manager via a standard incident management workflow or business rule  ==>  Creation of a new incident in JIRA Software.
    • Validation of a change in SAP software, in a Service Manager change management workflow step  ==>  Creation of a new card in Trello with the change request number as its name.
  • Carry out actions in Service Manager from a third-party service.  Open url.png See Integration Process no. 2.

    example  Creation of a card in Trello to offer a new training in the RH catalog  ==>  Creation of a Analyze new training change request in Service Manager with the description of the Trello card.

     
Integration Data Feed (direction) Authentication Type Integration Connector Options

Service Manager

Up and Down arrow.png

Logo - Zapier.png

Depending on the third-party service used

(Zapier takeover authentication)

EV Integration connector icon - Workflow.png    Workflow

EV Integration connector icon - Business rule.png    Business rule

Webhooks icon.png    Webhooks (by Zapier)

Available versions
SaaS On Premise
Service Manager Check icon.png Check icon.png
Third-party product Check icon.png N/A

Step-by-step Integration Process

         Open url.png See Zapier documentation.

Prerequisites

  • You must have at least one Zapier account. If you don't, please use the form for creating a Zapier account.
  • You must be logged into the Zapier account you want to use to carry out a zap and a new integration with Service Manager.

Process no. 1: Service Manager to a third-party service

example

  • Creation of a zap: Integration between Service Manager and Trello.
  • Main trigger in Service Manager: Validation of a change in a workflow step.
  • Action carried out in Trello: Creation of a new Trello card describing the change requested.

Step 1: In Zapier, initialize the zap.

1. Click on Make a Zap.

2. Name the zap.

example  EVSM_CHANGE WKFW (NORMAL): Create a Trello card

 

Step 2: In Zapier, configure the trigger in Service Manager.

2.1: In Zapier, initialize the configuration.

1. Configure the trigger by following the steps on the Trigger / 1. Set up this step panel.
         Trigger - 1 Set up this step.png
 

  • Name the trigger via Edit icon.png Rename Step.

    example  Validation of New EVSM Change

     
  • Choose App step:
    • Click on the Webhooks Webhooks icon.png icon in the right window (Built-in apps category).
    • Or enter the word Webhooks into the search bar then click on Webhooks icon.png.
  • Choose Trigger step:
    • Select the Catch Hook option.
    • Click on Save + Continue.

2. Store the webhook URL, useful for the REST Zapier configuration in Service Manager.

  • Click on Continue.
  • Copy the URI provided by Zapier.

    example  https://hooks.zapier.com/hooks/catch/799810/mtmjbz/

             Zapier - Webhook copy.png

3. Finalize the trigger coniguration by running successively steps below 2.2 and 2.3.
 

2.2: In Service Manager, create a Zapier REST action.

Note: The REST Zapier action uses the webhook previously created in Zapier (step 2.1).

   Open url.png See the procedure How to configure a REST action type for a new service.

1. Go to the menu Administration > REST > Connexions.

2. Create a connection to the Zapier service.
         Create new connection.png

  • Connection Name: Zapier to the third-party service.
  • Authentication Method: None.
  • Service Name: Zapier service.
    The URL of the Zapier service will automatically appear.
  • {id} parameter: Copy and paste the code after catch of the URL provided by Zapier you stored in your text editor when initializing the trigger (step 2.1).

    example  You should keep only the text displayed in yellow below.

    https://hooks.zapier.com/hooks/catch/799810/mtmjbz/

3. Create a new resource for the Zapier service that allows an action creation in the third-party service.
         Create new resource.png

  • Label: Name of the resource.
  • Service Name : Zapier service.
  • Connection Name : Zapier to the third-party service.
  • Resource URI: ID of the new resource. Copy and paste the value at the end of the URL provided by Zapier you stored in your text editor when initializing the trigger (step 2.1).

    example  You should keep only the text displayed in yellow below.

    https://hooks.zapier.com/hooks/catch/799810/mtmjbz

4. Use the new resource related to the Zapier service in a process REST action.

  • Open the workflow or the business rule-related process you want.
    • Workflow: References > Other references > Workflow (Operation / Transition)
    • Business rule: Administration > Business Rules > Related Processes
  • Click and drag the new resource from the REST Actions category to the graphic editor of the process.
    A new step will be added to the process.
  • Double-click to define the properties of the new step.
             Create new process step.png
     

2.3: In Zapier, finalize the Service Manager trigger configuration.

Note: The Zapier webhook must be used at least once in a Service Manager process.

1. In Service Manager, execute the process created at the step 2.2.
The Zapier webhook will be initialized via the REST Zapier action execution.

2. In Zapier, click on OK, I did this (step Test this Step).
The Service Manager trigger will be configured in Zapier.
         Zapier - Activate zap.png

Step 3: In Zapier, configure the action to carry out in the third-party service.

1. Configure the action to carry out in the third-party service by following the steps on the Action / 2. Set up this step panel.
         Action - 1 Set up this step.png

  • Name the action to carry out via Edit icon.png Rename Step.

    example  Trello card creation (Normal Change)

  • Choose App step: Click on the third-party service icon you want to carry out the action.

    example  Trello icon.png Trello

  • Choose Action step:
    • Select the action to carry out.

      example  Create Card action

    • Click on Save + Continue.
  • Choose Account step:
    • Select an existing account or connect to a new one.
    • Click on Save + Continue.
       
  • Set Up Template step: Configure the options according to your needs.

    Note: To use values of Service Manager fields (e.g.: rfc_number, description) and assign them in JIRA, the Zapier webhook must be used at least once. For this to happen, execute the Zapier REST action via a Service Manager process.

    example  Example Trello - Process1 - Set Up Template.png

2. Test the action configuration (Test this Step step) via Create + Continue.
The Test Successful! message must be displayed.

Note: You may add a Send Email (via Gmail) action type to send an email to the account of your choosing.

 

Step 4: In Zapier, activate the zap.

1. Click on Finish.

2. Activate the new zap via Your Zap is on.

Process no. 2: A third-party service to Service Manager

example

  • Creation of a zap: Integration between Trello and Service Manager.
  • Main trigger in Trello: Creation of a new card.
  • Action carried out in Service Manager: Creation of a service request.

Step 1: In Zapier, initialize the zap.

1. Click on Make a Zap.

2. Name the zap.

example  EVSM - Creation of service request from creation of Trello card

 

Step 2: In Zapier, configure the trigger in the third-party service.

1. Configure the trigger by following the steps on the Trigger / 1. Set up this step panel.
         Trigger - 1 Set up this step.png
 

  • Name the trigger via Edit icon.png Rename Step.

    example  New Trello card

  • Choose App step: Click on the third-party service icon that triggers the event.

    example  Trello icon.png Trello

  • Choose Trigger step:
    • Select the trigger in the third-party service.

      example  Create Card action

    • Click on Save + Continue.
  • Choose Account step:
    • Select an existing account or connect to a new one.
    • Click on Save + Continue.
  • Set Up Options step: Configure the options according to your needs.

    example  Example Trello - Process2 - Set Up Options.png

     

Step 3: In Zapier, configure the action to carry out in Service Manager.

1. Configure the action to carry out in Service Manager by following the steps on the panel Action / 2. Set up this step.
         Action - 1 Set up this step.png

  • Name the action to carry out via Edit icon.png Rename Step.

    example  Create EVSM request

  • Choose App step:
    • Click on the Webhooks Webhooks icon.png icon in the right window (Built-in apps category).
    • Or enter the word Webhooks into the search bar then click on Webhooks icon.png.
  • Choose Action step:
    • Select the Custom Request option.
    • Click on Save + Continue.
  • Set Up Template step:
    • Configure the options allowing to carry out the action in Service Manager according to your needs.
    • Click on Save + Continue.

example  Create a service request in Service Manager (with the corresponding catalog code)

  • Data option: Request body in JSON format (for the Service Manager REST API call). Note: In the example, the urgency_id is not mandatory. By default, it is the level of urgency reported in the catalog that is applied.
  • Unflatten option: Value no.
  • Basic Auth option: Use a Service Manager platform account authorized to make REST requests (API REST parameter checked in its profile).
  • Headers option: content-type and application/json paired values.

         Example Service Manager - Process2 - Set Up Template 1.png
         Example Service Manager - Process2 - Set Up Template 2.png

2. Test the action configuration (Test this Step step) via Create + Continue
The Test Successful! message must be displayed if successful.

Note: You may add a Send Email (via Gmail) action type to send an email to the account of your choosing.

 

Step 4: In Zapier, activate the zap.

1. Click on Finish.

1. Activate the new zap via Your Zap is on.

Examples of integration with third-party services

JIRA Software

Bug tracking system.

Trello

SaaS mode project management tool.

Tags:
Last modified by Unknown User on 2020/06/19 12:47
Created by Administrator XWiki on 2017/04/07 10:29

Shortcuts

Recent changes
•  Service Manager
•  Service Apps
•  Self Help

Glossary

Powered by XWiki ©, EasyVista 2020