Sending alerts to Webex directly from the Meraki Dashboard ?

xaviervalette
Here to help

Sending alerts to Webex directly from the Meraki Dashboard ?

Sending alerts to Webex directly from the Meraki Dashboard ?

 

Meraki Dashboard comes with built-in payloads for webhooks (Webex, Slack, Teams, …).

 

Those payloads are a ready to use solution for interacting with existing applications. But if you are using the given Webex payload (Network-wide > Alerts > Webhooks > Add or edit webhook templates)...

 

xaviervalette_0-1673802794358.png

 

 

{
 "markdown": "**{{alertType}}**\nAlert ID: {{alertId}}\nAlert level: {{alertLevel}}\nOccurred at: {{occurredAt}}\nOrganization name: [{{organizationName}}]({{organizationUrl}})\nOrganization ID: {{organizationId}}\nNetwork name: [{{networkName}}]({{networkUrl}})\nNetwork ID: {{networkId}}\nNetwork Tags: {{networkTags | join: ', '}}\nDevice name: {{deviceName}}\nDevice serial: [{{deviceSerial}}]({{deviceUrl}})\nDevice MAC: {{deviceMac}}\nDevice tags: {{deviceTags | join: ', '}}\nDevice model: {{deviceModel}}\n**Alert Data** {{ alertData | markdown_with_additional_formatting_for_webex }}\n"
}

 

 

 

...you will need to host a script listening for Meraki webhooks, and then posting a message to Webex API (via your Webex Bot).

 

xaviervalette_1-1673802794354.png

 

xaviervalette_2-1673802794834.png

 

 

This workflow is correct, however for the Custom app, you will need to deal with:

 

  • Scripting (Python, JavaScript, …)
  • Networking/Security (NAT rules if you are hosting the application behind your ISP router, firewall rules if you are using a cloud VM with public IP, …)
  • Getting computing resources (a Raspberry Pi at your place, a Cloud VM, Zapier, ...)
  • Billing (hosting, cloud services, …)

 

Setting up a self-hosted / cloud-hosted application can thus be time/money consuming.

 

Workaround

 

In this article, I am presenting a workaround, allowing you to post Webex messages directly from the Meraki Dashboard using a custom webhook payload:

 

xaviervalette_3-1673802794287.png

 

xaviervalette_4-1673802794829.png

 

👍Same result, but one less hop!

 

 

What are custom webhook payload templates ?

 

Custom payload templates allow you to define the structure of webhooks sent from Meraki Dashboard. By using it, you will be able to decide which data you want to send, and how those data are formatted.

 

The structure will be written in Liquid, both for the header and the body of the HTTP POST request.

 

 

Create a new webhook payload template

 

A new webhook payload template can be created from the Meraki Dashboard (Network-wide > Alerts > Webhooks > Add or edit webhook templates).

 

xaviervalette_5-1673802794050.png

 

 

 

Or via Meraki APIs: 

https://developer.cisco.com/meraki/api-latest/#!create-network-webhooks-payload-template 

 

 

Custom webhook payload template requirements

 

The custom webhook payload template needs to:

 

  1. Be sent to Webex API (https://webexapis.com/v1/messages)

  2. Authenticate to the Webex API with the bot token

  3. Include expected formated data

  4. (Optional) Provide an Adaptive Card for better display 

 

For the given requirements, I am going to use the Meraki Dashboard.

 

 

… Be sent to Webex API

Network-wide > Alerts > Webhooks

xaviervalette_6-1673802794259.png

 

 

 

 

 

… Authenticate to the Webex API with the bot token

Network-wide > Alerts > Webhooks > Add or edit webhook templates

 

xaviervalette_7-1673802794364.png

 

 

… Include expected formated data

Network-wide > Alerts > Webhooks > Add or edit webhook templates

 

xaviervalette_8-1673802794430.png

 

Then, do not forget to apply the custom webhook template to your alerts (Network-wide > Alerts):

 

xaviervalette_9-1673802794349.png

 

 

… (Optional) Provide an Adaptive Card for better display

Network-wide > Alerts > Webhooks > Add or edit webhook templates

 

In the Liquid Body, you can keep the markdown format of the native Webex payload template, or you can specify an Adaptive Card for better display.

An example of card is available on the following GitHub repo : https://github.com/xaviervalette/meraki-webex-custom-webhooks/blob/main/liquidBody.json

To create your own custom Adaptive Card, you can use the Button and Card Designer Tool of Webex.

 

xaviervalette_10-1673802794772.png

 

Here is the result! I hope it helps!

2 REPLIES 2
PhilipDAth
Kind of a big deal

That is much better.  No one in this space really wants to be hosting their own code.

Greenberet
Head in the Cloud

Just for completion.
You don't have to host something. Webex is also supporting an integration for incoming webhooks to post something into a room

 

https://apphub.webex.com/applications/incoming-webhooks-cisco-systems-38054-23307

I'm using this and the basic integrated template.

 

Get notified when there are additional replies to this discussion.
Welcome to the Meraki Community!
To start contributing, simply sign in with your Cisco account. If you don't yet have a Cisco account, you can sign up.