How to Use Pager Duty for Zoom
In Zoom Chat, you will be able to manage incidents through the PagerDuty app integrated with Zoom. By using automation and notifications, it makes assembling response teams faster and easier, as well as with a single touch, from anywhere, easier, and faster. As part of the PagerDuty integration with Zoom, you will be able to organize on-demand Zoom meetings through a response playback or by clicking a button from within the PagerDuty interface.
The following topics are covered in this article:
- How to install and configure PagerDuty
- Install PagerDuty from the Zoom App Marketplace
- Configure the PagerDuty subscription
- Configure on Zoom
- Configure on PagerDuty
- How to use the PagerDuty Notifications chat app
- Use the chat commands
- How to remove the PagerDuty Notifications chat app
- Data security
Contents
Prerequisites for using PagerDuty
- An account with PagerDuty is required
How to install and configure PagerDuty
Install PagerDuty from the Zoom App Marketplace
- You will need to sign in with your Zoom account in order to access the Zoom App Marketplace.
- The app can be found by typing PagerDuty into the search box at the top of your screen, located at the top of your screen.
- Once you have found the PagerDuty app in the search results, click the link to download it.
- Add the item to your cart by clicking on the Add button.
- You will need to confirm the app’s permissions prior to clicking Authorize.
After the PagerDuty app has been installed on the Zoom desktop client, it will appear under the BOTS section of the Zoom account, which allows all users within the Zoom account to access PagerDuty.
Configure the PagerDuty subscription
Configure on Zoom
- When you are in a PagerDuty 1:1 chat, you can type the slash command link to access the app subscription configuration page.
- Please click the link below to open the PagerDuty Configuration page where you can link your accounts.
- Authentication can be configured in PagerDuty by generating a new API token.
- In the PagerDuty Configuration page, you will find the API key that you need to copy and paste there.
- Save the token by clicking on the Save Token button.
In order to generate an API key, you can visit this link for more information about how to do so. - You can choose from the drop-down menu which service you would like to use for new incidents.
- Save the service by clicking the Save Service button.
Configure on PagerDuty
PagerDuty needs to be configured with a webhook if the admin wants to receive notifications in Zoom chat from PagerDuty.
- Copy the URL from the PageDuty Configuration page and paste it into your browser.
- Make sure that you are logged into your PagerDuty account.
- You will be redirected to the Services page.
- On the list of services offered by PagerDuty, you can click the service you wish to configure notifications for, and then you will find the Integrations tab on the right.
- Scroll down to the section called Extensions and Add-Ons and click on the button that says Generic V2 Webhook.
- The Extensions page can be accessed by clicking the Add or manage extensions button at the top of the page.
- Select the Edit option from the services wheel icon after you have expanded the icon.
- Please paste the URL into the URL box provided at the bottom of this page.
- Save the changes by clicking the Save button.
Read it also –
How to use the PagerDuty Notifications chat app
Use the chat commands
Enter help in the chat box to display a list of commands that are available to you. The command should be entered only in 1:1 chats. It is recommended that you use the app slash name /pd before any command in a group channel. Example: /pd help.
- link: Connect your PagerDuty account to Zoom chat by typing the link and allowing it access to your account.
- Getting in touch: You can connect to a PagerDuty channel by typing the connect command in the channel’s search bar. The incident notifications will be sent to you here so that you can be aware of them.
- I have disconnected. You can use the disconnect keyword to turn off PagerDuty notifications for this channel in order to remove and turn it off.
- help: The help command on the PagerDuty Notifications chat app will provide you with a list of all the commands available within the app.
- incidents create [title]: In order to create an incident with the specified title, you need to type incidents create [title] into the command line.
- incidents: You can review your incidents by typing incidents into the search box.
- incidents [search term]: In order to search for incidents by title name, type incidents [search term].
- On your call: You can search for all the users who are on call by typing oncall.
- meet: All on-call users can initiate a Zoom meeting by typing meet in the search box.
- Note: The meet command creates a meeting, but when the message is sent to users that are currently on-call and to the user who issued the command, it only goes to the 1:1 channels of each user that is currently on-call as well as the user who issued the command. In the case of users creating instant meetings using the meet command, the message is independent from the actual meeting, and it persists even after the meeting has ended, been updated, or been deleted.
- teams: You can review your teams by selecting teams from the drop down menu.
How to remove the PagerDuty Notifications chat app
- You will need to sign in with your Zoom account in order to access the Zoom App Marketplace.
- You can find the Manage button at the top of the page in the top right hand corner.
- Select Added Apps from the navigation menu on the left side of the screen.
- To remove a PagerDuty app from your device, you need to click on the Remove button next to that app.
- Please confirm the dialog box by clicking the Remove button.
Data security
- Having access to your Zoom account is very important
- As part of this chat app, the chat app will be able to send chat messages on behalf of the chat app to a user or channel in an IM channel.
- Using this chat app, you will be able to view all user information (you will see your ID, first name, last name, email, user type, PMI, time zone, department, last login time, phone number, and meeting settings), account information (you will see your account id, owner, owner email as well as the number of licenses), and manage all user meetings (register for webinars, register for past meetings, see past meeting information, and view meeting settings).
- Access to your PagerDuty account
- The chat app has access to PagerDuty admin-level read/write data, allowing it to interact with admin-level data. Here is a link to the PagerDuty API reference document
- PagerDuty users who add API keys to their account will have read, write, update, and delete permissions available to them.
- Access to the following data: Service, user, incident, and oncall lists are some of the data accessed.
- DB table storing data such as: User ID for PagerDuty, API token for PagerDuty managed by an API
- In the user interface, the following data will be displayed: incident numbers / incident ID / incident titles / service names, a list of oncall users, and a team list.
- Is this chat app encrypted between Zoom and the app that handles the communications between them? In the event that it is, what is the algorithm and what are the key strengths of the algorithm?
- In this case, the connection between PagerDuty and Zoom is encrypted as follows:
- Protocol: TLS 1.2
- Cipher suite: ECDHE-ECDSA-AES128-GCM-SHA256
- Key length: 128 bits
- Perfect Forward secrecy: YES
- In this case, the connection between PagerDuty and Zoom is encrypted as follows:
- Are the access credentials for this chat app stored locally in the database of the app?
- It is stored in a database where users and administrators are able to access their PagerDuty tokens (both on an admin and user level).
