How to receive LabCollector notifications using Slack? - LabCollector

Search Knowledge Base by Keyword

How to receive LabCollector notifications using Slack?

You are here:
← All Topics
SUMMARY:

On LabCollector, notifications and alerts can be seen directly on the homepage with the Alerts icon. But another solution is now possible for labs using or wishing to use Slack as a means of communication. Slack can now be integrated within LabCollector to receive notifications from LabCollector and broadcast them to all users on a specific channel.

1. Slack Configuration

2. Integration of Slack in LabCollector

3. Receiving Slack notifications

1. Slack Configuration

  • To set up Slack in LabCollector you must first have a Slack account.
  • Then go to https://slack.com/signin#/signin to :
    • 1. Log in to your account 
    • 2. Create a new Slack account


  • Once connected, go to https://api.slack.com/
  • In order to get a specific channel dedicated to LabCollector notifications and to privatize the channel, it is necessary to create a Slack Application:

    • 1. On the home page, click on
    • 2. Then,
    • 3. A page opens to add the App name and the Slack Workspace you want to use

  • Once created, your new app will appear on your dashboard.
  • Clicking on your app will take you to the Slack App configuration page.
  • Some features are required and must be enabled to work properly with LabCollector, follow these steps:

    • 1. Make sure you choose the Workspace (if you have more than one) on which you want to make the changes
    • 2. Incoming Webhooks: Webhooks are a simple way to post messages from external sources in Slack. They use normal HTTP requests with a JSON payload, which includes the message and some other optional details. On this page, make sure the button is green and set to ON.

    • 3. Specific permissions for the created application are needed to allow Slack to work properly with LabCollector: 

      • Go to Basic Information 
      • Click on Add features and functionality 
      • Click on Permissions 
      • On the picture below you can see the permissions to add and the explanations related to each permission:

Bot Token Scopes: 

channels:history

channels:read

incoming-webhook

 

User Token Scopes:

channels:history

channels:read

emoji:read (optional)

users:read

 

 

    2. Integration of Slack in LabCollector

    • To receive Slack notifications from LabCollector, you need to activate your Slack account on LabCollector.
    • GO TO ADMIN -> SETUP -> INTEGRATIONS
    • 4 fields must be filled in to allow the connection between Slack and LabCollector
      • 1. Webhook URL
      • 2. Slack on the Labcollector homepage
      • 3. App Token
      • 4. Conversation ID

    • Webhook URL: On your account, the Webhook URL is created directly by Slack. Copy the link and paste it in the dedicated field.

     

    • Slack on the LabCollector Homepage: You can choose to display a Slack window on the LabCollector homepage
    • App Token: This token is unique and contains all the permissions granted by the user (retrieve channel history, channel users…). 

    Note
    To use this request, your application must have the channels:read permission (see section 1).

     

      • 1: Go to the tab Tester
      • 2: Paste the App Token (see above)
      • 3: Launch the test
      • You will then see a page like this one below, the Conversation ID is at the top of this page.

      • Once all the information has been added to LabCollector, perform a test using the Test button . The test allows you to send a message on Slack in the dedicated channel

     

    3. Receiving Slack notifications

    • You can see Slack notifications directly in the dedicated channel on your computer’s Slack app.
    • Messages received and sent in this channel are also visible directly within LabCollector on the Slack window on the home page (if YES).

    1: Channel dedicated to LabCollector
    2: Application created for LabCollector
    3: Direct message in Slack visible in LabCollector and in the dedicated channel
    4: LabCollector notifications/alerts

    • Notifications that can be visible in Slack: 

    Reagents & Supplies Module

    • Validity alerts status
      • Some articles have reached expiring validity
      • Waiting list contains records to be validated by admin
    • Quantities alerts status
      • Some articles have reached minimum quantity

    Orders Management

    • Waiting status
      • Order list contains articles to be ordered

    Equipment module

    • Maintenance alerts status
      • Equipment maintenance needed
      • Equipment maintenance contracts ending

    Related topics: