Manage webhook recipients-Account Center(Account)-阿里云帮助中心

Configure webhook recipients to ensure you receive and handle messages promptly and accurately in all scenarios, especially high-risk ones. This configuration improves your organization's security response and operational efficiency.

Note

The platform supports webhooks from DingTalk, WeCom, Lark, and Slack. It also supports custom webhook URLs.

If your chatbot uses keyword filtering, add the keywords Alibaba Cloud and Alibaba to its allowlist. This ensures that you can receive webhook messages from Alibaba Cloud.

Webhook chatbot overview

A webhook chatbot is a special type of chatbot provided by chat collaboration platforms such as DingTalk and Lark. It uses a webhook URL to enable external systems to automatically send messages to group chats. Message Center uses webhook chatbots to push notifications to your chat groups.

Obtain a webhook URL

After you add a custom chatbot in your chat collaboration platform, the system generates a webhook URL. For example, in DingTalk, the webhook URL is in the following format:

https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxxxxxxxx

Copy this URL. You need to enter this webhook URL when you add a chatbot in Message Center.

Procedure

Log on to Message Center. In the left navigation pane, choose Chatbot Recipient Management.
On the Webhook Management page, click Webhook Management in the upper-right corner. Then click Add Webhook in the upper-right corner. Enter the required information and click OK.

In the Add Webhook dialog box, configure the following settings:
- Chatbot Platform: Select from the drop-down list (Custom, DingTalk, etc.).
- Chatbot Name: 2-12 characters, including Chinese characters, letters, and digits.
- Webhook URL
- Data Format: Format A (typical for DingTalk), Format B (typical for Lark), Format C (typical for Slack). A JSON example is displayed below each format.
- Signature String: Up to 64 characters. Supports auto-generation.
- Chatbot Verification: Enter a verification code to complete verification.
On the Webhook Management page, you can Modify or Delete webhooks in the Action column.
Note
- Contacts can be set as message recipients.
- Add and obtain chatbot webhook information in your IM software. DingTalk, WeCom, Lark, and Slack are supported.
- If keyword filtering is configured in the chatbot security settings, add the keywords Alibaba Cloud and Alibaba.
After you configure the chatbot, return to the Chatbot Recipient Management page. For the message type that you want to configure, click Modify in the Action column. On the Modify Message Receiving Configurations page, you can configure the following:
- Set an upper limit on the number of messages received per day for this message type.
- Assign one or more webhooks to the message type.
  
  You can also set custom receiving rules. Use keyword-based blocklists and allowlists to filter the messages that are delivered.
  
  In the Edit Receiving Rules dialog box, Custom Receiving Rules provides three options:
  - None: No filtering rules are applied.
  - Blocklist Keywords: You will not receive messages that contain any blocklist keyword.
  - Allowlist Keywords: You will not receive messages that do not contain any allowlist keyword.
  In the Keywords text box, enter keywords separated by line breaks. Keyword matching is case-insensitive (for example, "ecs" matches "ECS").
In the Action column, click Revision history to view recent changes for the message type. The history includes the modification time, the user who made the change, and the change details.
After you complete the setup, your chatbot starts receiving the specified notifications.