|
| 1 | +--- |
| 2 | +title: "Wecom Alert Integration" |
| 3 | +description: "Generate a unique Wecom robot address in Flashduty, and synchronize the occurrence and recovery of alerts through Wecom" |
| 4 | +date: "2025-05-19T10:00:00+08:00" |
| 5 | +url: "https://docs.flashcat.cloud/en/flashduty/Wecom-alert-integration-guide" |
| 6 | +--- |
| 7 | + |
| 8 | +Generate a unique Wecom robot address in Flashduty, and synchronize the occurrence and recovery of alerts through Wecom. |
| 9 | + |
| 10 | +<div class="hide"> |
| 11 | + |
| 12 | +## Operation Steps |
| 13 | +--- |
| 14 | + |
| 15 | +### Create Wecom Alert Integration |
| 16 | + |
| 17 | +You can obtain a Wecom alert integration address through either of these two methods: |
| 18 | + |
| 19 | +#### Using Dedicated Integration |
| 20 | + |
| 21 | +Choose this method when you don't need to route alert events to different channels. It's simpler and recommended. |
| 22 | + |
| 23 | +<details> |
| 24 | + <summary>Expand</summary> |
| 25 | + |
| 26 | + 1. Go to the Flashduty console, select **Channel**, and enter a specific channel's details page |
| 27 | + 2. Select the **Integration** tab, click **Add Integration** to enter the integration page |
| 28 | + 3. Choose **Wecom Alert** integration and click **Save** to generate a card |
| 29 | + 4. Click the generated card to view the **Wecom Alert Integration URL**, copy it for later use, and you're done |
| 30 | + |
| 31 | +</details> |
| 32 | + |
| 33 | +#### Using Shared Integration |
| 34 | + |
| 35 | +Choose this method when you need to route alerts to different channels based on the alert event's payload information. |
| 36 | + |
| 37 | +<details> |
| 38 | + <summary>Expand</summary> |
| 39 | + |
| 40 | + 1. Go to the Flashduty console, select **Integration Center => Alert Events** to enter the integration selection page |
| 41 | + 2. Select **Wecom Alert** integration: |
| 42 | + - **Integration Name**: Define a name for the current integration |
| 43 | + - **Message Type**: Select Wecom alert message type, currently only Text and Markdown are supported |
| 44 | + - **Push Mode**: Choose when to trigger or recover alerts for Wecom notifications |
| 45 | + 3. Copy the **Wecom Alert Integration URL** for later use |
| 46 | + 4. Configure the default route and select the corresponding channel (after integration creation, you can go to `Routes` to configure more routing rules) |
| 47 | + 5. Done |
| 48 | + |
| 49 | +</details> |
| 50 | +</div> |
| 51 | + |
| 52 | +### Customize Wecom Alert Integration |
| 53 | + |
| 54 | +#### Wecom Alert Integration URL |
| 55 | + |
| 56 | +The system will generate a unique Wecom alert integration URL for you. This URL is compatible with Wecom robot message protocol. When platforms only support Wecom robot channels, you can use this URL to receive corresponding messages. |
| 57 | + |
| 58 | +#### Push Mode |
| 59 | + |
| 60 | +By default, the system always creates new alerts for each message, but you can switch to these modes: |
| 61 | + |
| 62 | +**Trigger or Close Alert Based on Rules**: In this mode, when receiving a new message, the system matches messages according to your rules and triggers new alerts or closes existing alerts based on the matching results. |
| 63 | + |
| 64 | + - You need to fill in at least one **trigger** rule |
| 65 | + - You must set up regex extraction rules for Alert Key. The system uses this field to find historical alerts for updates or closure. **If regex extraction fails, the system will use the message title to generate an Alert Key** to ensure alerts won't be lost due to configuration errors |
| 66 | + - You can choose whether to discard messages when none of the rules match |
| 67 | + |
| 68 | + Configuration example: |
| 69 | + |
| 70 | + - Receive all messages, close the alert when the message content contains **RESOLVED**, otherwise trigger a new alert |
| 71 | + - Extract Alert Key from messages using the rule **/(.*)/**. |
| 72 | + |
| 73 | + |
| 74 | +### Notes |
| 75 | +- Wecom alert integration URL only supports Text and Markdown message types; other message types cannot be received |
| 76 | +- Flashduty will generate a default alert title: "Wecom robot Alert , If you need to change the title, you can customize it using the [alert pipeline](https://docs.flashcat.cloud/en/flashduty/alert-pipelines)" |
| 77 | + |
| 78 | +## Severity Mapping |
| 79 | +--- |
| 80 | + |
| 81 | +Currently, all alerts pushed to Flashduty through the Wecom integration are set to Warning severity. However, you can customize the severity using the [alert pipeline](https://docs.flashcat.cloud/en/flashduty/alert-pipelines). |
0 commit comments