Run using DingTalk Notification

This tutorial will show you how to integrate Monika with DingTalk to get your Monika notifications

Setup DingTalk Robot

Setting up DingTalk could be very difficult if you can’t read Chinese. So, we will guide you on how to do it with pictures so that you can understand it more straightforwardly.

First, you need to open https://open.dingtalk.com/document/group/assign-a-webhook-url-to-an-internal-chatbot to access the documentation. Then, you need to click the highlighted URL below:

Assuming you already have a DingTalk account, you will be redirected to the page in the image below. If you haven’t, you will be redirected to create an account.

After that, go to the second menu on the navbar, and select the first sub-menu like so:

You will be redirected to another page. Select the last menu on the sidebar, and click the blue button to create a robot.

After that, you will be prompted to fill out a form to create a robot. Fill out the form with the application name, description, and icon. Once that’s done, click the blue button again.

If the bot has been successfully created, it should redirect you to the robot details page.

But your newly created robot has not been activated yet, so let’s activate the robot by selecting the last menu on the sidebar, then select the first sub-menu of it, and click the right blue button. Once that’s done, the red indicator should turn green.

Use DingTalk Robot in the Desktop App

Now that we have successfully created the robot, we can use it in the desktop app. So, download the desktop app and authenticate with your credentials. Then, create a new group for the robot to be added.

Then, click the group and open the settings inside the group and click the Group Assistant menu.

From there, you can add your previously created robot. Click the robot name you have just created.

A popup will appear showing your robot data. Scroll down to the webhook URL and copy the webhook URL to another place. Then, copy only the access token in the webhook URL. The access token format should be like this:

 https://oapi.dingtalk.com/robot/send?access\_token=<your\_access\_token>

Save it to somewhere safe as we are going to need it later.

Additionally, you can secure your robot by allowing keywords. Scroll down to Security Settings and check the Custom Keywords checkbox. From there, you can define the keywords allowlist yourself.

We are finally done with the DingTalk setup, all that’s left is to set up Monika with the DingTalk webhook URL.

Integrating Monika with DingTalk

Now that we have our access token from DingTalk, it’s time to create a Monika configuration called monika.yml

1 notifications:
2   - id: dingtalk-notif
3     type: dingtalk
4     data:
5       access_token: <your_access_token>
6 probes:
7   - id: '1'
8     name: Hyperjump
9     description: Landing page
10     interval: 1
11     requests:
12       - method: GET
13         url: 'http://localhost:3000/api/demo/status'
14     alerts:
15       - query: response.status != 200
16         message: Status not 2xx

Let me explain the configuration a little bit:

• Monika will use DingTalk as their notification channel, using the access token from the previous step
• Monika will probe http://localhost:3000/api/demo/status every one second
• Monika will alert you if the response status code is not 200

Once that’s done, run the monika.yml with the configuration above.

Congratulations! You have successfully integrated Monika with DingTalk!