Links

Meta Workplace

Connect your Meta Workplace Groups to PagerTree.
Company
Estimated Time
Vendor Docs
Open Source
Meta
5 minutes
view
v3.rb

What is Meta Workplace?

Workplace is the all-in-one business communication platform from Meta that securely combines chat, video, groups and your intranet with the work tools you already use.

How It Works

Posts and comments are sent to Workplace groups, making sure the right groups are notified of alerts.
  • When an alert in PagerTree is opened PagerTree will create a post to a group of your choice.
  • When an alert in PagerTree is acknowledged, rejected, resolved, dropped, handed off, or commented on PagerTree will comment on the post associated with the alert.

Integration Walkthrough

In this integration tutorial we will show you how to send alerts from PagerTree into a Meta Workplace group. The estimated time for this integration is 5 minutes. We assume that you already have a PagerTree and Meta Workplace account setup.

In Meta Workplace

Copy the Group

Open up a text editor app to more easily save the fields you will copy below.
  1. 1.
    Navigate to the group page. (If you have not yet created a group, create a group.)
  2. 2.
    In the URL bar, copy the Group ID into your text editor app.
    Workplace Dash
    In Workplace, copy the Group ID where you want PagerTree to post to.

Create the Workplace Integration

  1. 1.
    In the left-hand menu bar, navigate to Admin Panel -> Integrations.
  2. 2.
    Click the Create custom integration button.
    workplace custom integrations
    In Workplace, create a custom integration.
  3. 3.
    In the create custom integration form, name the integration and optionally give it a description.
    workplace create custom integrations
    Fill in the custom integration form.
  4. 4.
    Click Create.
  5. 5.
    On the integration details page, click the Create access token button.
    Workplace create access token
    Click the create access token.
  6. 6.
    On the new token created, click "Copy". Add this to your text editor app.
  7. 7.
    Click I understand and done.
  8. 8.
    Click the Permissions Tab and select the following:
    1. 1.
      Mention bot
    2. 2.
      Read group content
    3. 3.
      Manage group content
  9. 9.
    Click Save.
    Give the Worplace app the appropriate permissions.
    Give the Worplace app the appropriate permissions.

In PagerTree

  1. 1.
    Create the integration by clicking the Meta Workplace logo.
  2. 2.
    In the New integration form:
    1. 1.
      Name - Input a friendly name
    2. 2.
      Workplace Group ID - The Group ID you copied earlier
    3. 3.
      Workplace Integration Access Token - The access token you copied earlier.
  3. 3.
    Click Create.
    Pagertree Workplace integration
    In PagerTree, create the integration pasting the values you copied earlier.

You have successfully completed the Meta Workplace Integration. Now when an alert is created, acknowledged, commented on, etc. posts and comments will be sent to workplace.
An example Post in Workplace sent by PagerTree
An example Post in Workplace sent by PagerTree

Outgoing Rules

You can suppress outgoing messages by using the integration outgoing rules (ex: You only want a certain teams messages to a channel). Please see Outgoing Webhook - Outgoing Rules for full documentation on the functionality.
only_send_alerts_with_security_in_title.yml
rules:
- match:
"$not":
alert.title:
"$regex": "security"
"$options": "i"
actions:
- type: ignore
only_send_to_if_assigned_to_specific_team.yml
rules:
- match:
"$not":
alert.d_team_id:
"$in":
- "tem_abc123" # Devops Team
actions:
- type: ignore