Posting a message in Zoom

This documentation references external sources.

Nexthink does not control the accuracy of third-party documentation or external updates that can result in inconsistencies.

Report any errors or inconsistencies to Nexthink Support.

This page demonstrates how to post a message to the video conferencing platform Zoom using a webhook.

In Zoom

Complete the steps listed in the Using Zoom's Incoming Webhook Chatbot documentation from Zoom.
Select Manage your Workflow to copy the URL and token for future reference for future reference. That is, for the connector credential and webhook configuration in the Nexthink web interface:
- Endpoint URL example: https://integrations.zoom.us/chat/webhooks/incomingwebhook/dSUXXXXXXXXXXXXXXXXXXX
- Verification Token example: PRuXXXXXXXXXXXXXXXXXXXX

The URL and verification token examples above are just for illustration purposes.

In Nexthink

From the Nexthink web interface:

Configuring a connector credential for Zoom

From the connector credential configuration page, fill out the fields using the information from the connection you created in Zoom.

Choose the HTTPS option from the Protocol drop-down.
Paste the root https://integrations.zoom.us into the URL address field.
Choose the Bearer token option from the Authorization drop-down.
Type in Bearer in the Header prefix field.
Copy the verification token from the Zoom connection and paste it into the Token field.
Save the credential.

Configuring a webhook for Zoom

From the webhook configuration page, fill out the fields using the information from the connection you created in Zoom and the connector credential defined in Nexthink.

Fill in the NQL Condition following the Configuring webhook NQL conditions documentation. See the query below.
- After filling in the NQL Condition, the system lists the allowed placeholders for the Payload.

alert.alerts
| where monitor.tags contains "web-applications"
| where alert.context contains "*Salesforce*" or alert.context contains "*Microsoft*"
| list alert.monitor.name, alert.status, monitor.tags, alert.context, trigger_time, recovery_time, alert.monitor.thresholds, monitor.priority, alert.trigger_values, alert.trigger_reference_value, alert.recovery_values, alert.context, device_view_link, issue_view_link, device.name

Choose the connector credential you created for Zoom from the Credentials drop-down.
Select the POST from the Method drop-down.
Copy and paste into the Resources field, the URL endpoint from the Zoom connection without the URL address. For example: chat/webhooks/incomingwebhook/dSUXXXXXXXXXXXXXXXXXXX
Add the message you want to send in Payload.
- Refer to Using Zoom's Incoming Webhook Chatbot to confirm the payload formats supported by Zoom. For example, when adding the ?format=full query parameter, you can create complex messages like:

{
  "content": {
    "head": {
      "text": "This is an issue created by a Nexthink Alert",
      "sub_head": {
        "text": "Nexthink Alert {{alert.monitor.name}} has been triggered"
      }
    },
    "body": [
      {
        "type": "message",
        "text": "Alert for device {{device.device.name}}"
      }
    ]
  }
}

Refer to the Configuring webhook fields: Method, Resource, and Payload to learn more about allowed placeholders for payloads.

Sent test and verify the message appears in Zoom.