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. Navigate to the group page. (If you have not yet created a group, create a group.)

2. In the URL bar, copy the Group ID into your text editor app.

   

   In Workplace, copy the Group ID where you want PagerTree to post to.

Create the Workplace Integration

1. In the left-hand menu bar, navigate to Admin Panel -> Integrations.

2. Click the Create custom integration button.

   

   In Workplace, create a custom integration.
3. In the create custom integration form, name the integration and optionally give it a description.

   

   Fill in the custom integration form.
4. Click Create.

5. On the integration details page, click the Create access token button.

   

   Click the create access token.
6. On the new token created, click "Copy". Add this to your text editor app.

7. Click I understand and done.

8. Click the Permissions Tab and select the following:

   1. Mention bot

   2. Read group content

   3. Manage group content

9. Click Save.

   

   Give the Worplace app the appropriate permissions.

In PagerTree

1. Create the integration by clicking the Meta Workplace logo.
2. In the New integration form:

   1. Name - Input a friendly name

   2. Workplace Group ID - The Group ID you copied earlier

   3. Workplace Integration Access Token - The access token you copied earlier.

3. Click Create.

   

   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

---

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