Duro Slack Integration

Objective: To walk Duronauts through the process of setting up the Duro-Slack integration. 

Difficulty: Easy

In this article:

1. Overview
2. How to enable the Duro-Slack integration
   • Prismatic setup: part one
   • Slack setup
   • Prismatic setup: part two
   • Duro setup
3. How your domain interacts with the integration

The Duro-Slack integration simplifies tracking and communication by sending notifications of Change Order and component status updates directly to your Slack application. Duronauts also have the option to customize webhooks, helping you stay informed and up to speed at all times. Please note that only administrators of your company are authorized to install the integration for your company.

---

Overview

The Duro-Slack integration allows you to monitor Change Order progress and access them quickly and conveniently. Specific approvers and notifiers will be instantly alerted in Slack when Change Orders are submitted, approved, rejected, or closed. The Change Order is hyperlinked within the Slack notification, transporting you directly to the Change Order in Duro to read all pertinent information soon after modifications are made to a product or component. 

Development, manufacturing, engineering, and procurement teams alike benefit from having all notifications centralized in a single location as items get pushed to production. With this integration, the need for alternating between applications to communicate Change Order advancements is minimized.

Duro-Slack webhooks can be customized to include or exclude notifications for Change Order submissions, approvals, and rejections. Notifications on Change Order closures are always sent. Duro-Slack webhooks can also be customized to include or exclude notifications on component actions including component creation, updates, or deletions. For more information on webhooks, please visit our article on Webhooks.

How to enable the Duro-Slack integration

Enabling your Duro-Slack integration is a short process that will improve the rest of your Duro experience. Follow the instructions below to set up.

Prismatic setup: part one

1. Contact a Duro support specialist to obtain your login credentials for Prismatic.
2. Create your account and set your password.
3. Login to Prismatic.
4. Click on Instances in the left navigation.
5. Click on the Slack tile.
6. Click on the green Reconfigure button in the upper right corner.
   
   
   
   
   
7. In the Initial Configuration window, open the dropdown menu for Trigger details. This will reveal the Flow 1 URL. Copy this into a notepad or document to use later in this tutorial during the Duro setup. 
8. Click Next.
9. In the Slack Connection window, enter your Duro API Key. This is obtained from Duro.*
   • Login into your Duro account.
   • Click on your avatar and select Account Settings.
   • In the Settings menu, select the Integrations tab.
   • Click on the Get API Key button below the Integrations table.
   • This will present the key. Highlight and copy the key. 

10. Click Next. 
11. Click the Connect button within the Slack Connection box. 
12. This will initiate the Slack setup portion of this tutorial.

Note: Please refer to the Quick Start Guide to using Duro's GraphQL API for more information on obtaining your API key.

Slack setup

It's important to take note that if Slack is not currently installed on your device, the setup instructions for integrating Duro with Slack may differ. We encourage you to visit Slack's website to obtain the most recent and accurate installation instructions for their software before proceeding with our integration process.

1. In the upper right-hand corner of the Slack setup page, select your company’s workspace if it’s not already shown.
2. Read the viewing and action permission settings for the Duro-Slack integration:
   • What will Duro be able to view?
   • What will Duro be able to do?
3. Click on the Allow button to authorize the installation of the integration.

Prismatic setup: part two

1. Return to the web browser with Prismatic. 
2. In the Slack Connection window, click Next.
3. In the Slack Configuration window, select the desired channel name or ID Variable from the dropdown.
   
   
   
   
4. Then, click Next.
5. In the Duro Config window, enter your base URL. This is the main URL you use to access the Duro web application.
6. Then, click Finish.

 Your Slack integration is now enabled. 

Duro setup

1. Login to your Duro application. 
2. Click on your Avatar and select Account Settings.
3. Click on the Webhooks option. 
4. Click on the New button to open the New Webhook module. 
5. Enter the link copied in Step 7 of Prismatic setup: part one into the field titled Webhook URL.
6. Enter a description into the coordinating field. This can be anything that you may find helpful, and there are no description requirements.
7. Select the event types you would like to be notified of:
   1. Change Order Events:
      1. Change Order Submitted
      2. Change Order Approved
      3. Change Order Rejected
   2. Component Events:
      1. Component Created
      2. Component Updated
      3. Component Deleted
8. Select the mode: Live or Sandbox.
9. Optional: Check the box for “Include all Components and Products Data.”
10. Click SAVE. 

Your Duro-Slack integration is now enabled. 

How your domain interacts with the integration

This setup process is designed for the standard MFG domain built-in with Duro. If you have a custom domain, please submit a ticket and our support team will guide you through the process of installing and configuring the integration for you.