Page Comparison

...

Prerequisites: To make an external API request to start a pipeline and approve through MS Teams, you must have a configured MS Teams tool. You must also generate a Personal Access Token with Scope = API Access. For instructions on generating a Personal Access Token, view the https://opsera.atlassian.net/l/c/fSKfvcec documentation.

...

Pipeline Step Setup

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.
   
   Note: The Custom Step Message will be overwritten by the API call Notification Message.
   

   

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

...

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