Page Comparison

The following documentation explains how to use an API call with Opsera’s new API endpoint to trigger a pipeline start with an Approval Gate step then approve the pipeline step via Microsoft Teams. The Approval Gate step must be set up with a Step Notification configured to a MS Teams tool. This way you can approve the pipeline start through MS Teams.

...

...

Pipeline Step Setup

Approval Gate Step Configuration

You must use an Approval Gate step for this step. This step must be the FIRST step in the pipeline workflow. Use the following instructions to set up an Approval Gate Step.

1. In pipeline workflow, create a new step.

2. In Step Setup, select Approval Gate from the Tool dropdown.

   Image RemovedImage Added

3. Click the ‘Save' button and exit Step Setup.

4. Select the gear icon to configure the Approval Gate step.

   Image RemovedImage Added

5. In the Step Configuration form, enable the Send Custom Message toggle. Provide a Custom Step Message and Point of Contact.
   

   Image Removed

   
   Note: The Custom Step Message will be overwritten by the API call Notification Message.
   

   Image Added

6. Click the ‘Save’ button and close out of the step.
   

Step Notification

...

in Approval Gate Step Configuration

1. Once the Approval Gate step has been configured, click the mail icon on the step to open the Pipeline Step Notification Configuration.

   

2. Select Microsoft Teams.

3. Enable the Teams Notification toggle.

4. Select Notification Level from dropdown.

5. Select the configured Teams Tool from the dropdown.

   

6. Click the ‘Save’ button and exit.

Retrieving Pipeline ID and Step ID for API Request

1. Your Pipeline ID can be found in various locations, such as in the URL of your pipeline or the Summary panel.

   

2. The Step ID from the Approval Gate Step can be found directly on the pipeline step.

   

...

Now that you have a Personal Access Token, Approval Gate Step, Pipeline ID and Step ID, you can make the API call.

API

...

Request

Use the following information for method, URL, endpoint and body. Verify that the user making the API call has RBAC to the specific pipeline.

{
    "pipelineId":"[insert pipeline id]",
    "stepId": "[insert step id]",
    "notificationMessage":"here is the custom message"
}

...

...

body of api call

...

teams screenshot

...

if user want a message displayed on the next line, use “\n” or enter to move to next line

...

...

Approve Pipeline Start in MS Teams

1. Once you receive the Pipeline Notification via MS Teams, verify the information and click the ‘Approve’ button.

   Image Added

2. Once you approve the Pipeline Notification, the pipeline will start.

   Image Added