# DingTalk Integration

[DingTalk](https://www.dingtalk.com) is an intelligent working platform created by Alibaba Group to support tens of millions of enterprises to achieve higher working efficiency with the new digitalized working method.

## In DingTalk: Add an ilert Robot to a group <a href="#in-dingtalk" id="in-dingtalk"></a>

{% hint style="info" %}
**Admin permission required**

To set up the integration, you must have admin rights in ilert.
{% endhint %}

1. Go to DingTalk, select the group in which you want to publish ilert Alerts and click the **Context Menu** **->** **Group Assistant**

![](/files/-MahqczMAHKLCoVGfE2B)

2. Than click on the **Add Robot** button

![](/files/-MahrNXwlqU5IlFsWae-)

3. On the modal window click on the **Custom** tile

![](/files/-MahsEps6fZaqae5eCKE)

4. On the next modal window click on the **Add** button

![](/files/-MahtM0Wbj-JK4TVynki)

5. On the next modal window, name the robot e.g. ilert, in the **Security Settings** section enable the **Additional Signature** option, check the **Terms of Service** and click on the **Finished** button

![](/files/-MahuyF90n0Ay5v2Mps-)

6. On the next modal window click on the **Finished** button

![](/files/-Mahvu6Y5d1ZVfXdtLgf)

7. On the next modal window click on context menu **"..."** button next to the ilert robot

![](/files/-Mai-KFaZUgBoKsbzM6V)

8. On the next modal window copy the **webhook URL** and the **Additional Signature**, you will need it from step 3 in ilert.

![](/files/-Mai-lugfSMuypPLWa0P)

## In ilert: Create the DingTalk Connector and link it to the alert source <a href="#in-ilert" id="in-ilert"></a>

1. **\*\*Click the gear icon and then click on the** Connectors\*\* link

![](/files/-MVvVEyvN3fXUo2aqmBu)

2. Click the **Create Connector** button

![](/files/-MVvVeIIkyW0rkE7P-0L)

3. On the next page, choose **DingTalk** as type, name the connector and click on the **Save** button.

![](/files/-Mai8dlA_5T76kKwuz5O)

4. Go to **Services -> Alert sources** and open the alert source whose alerts you want to post to DingTalk. Click on the **Alert actions** tab and then on the **Add new alert action** button

![](/files/-MVvZL8p_k8wOgN-enwu)

5. On the next page choose **DingTalk** as the type, choose the connector created in step 3, name it\*\*,\*\* choose **alert events** to publish and click on the **Save** button.

![](/files/-Mai9Hej4JEN3DuvnmSA)

6. Finished! You can now test the connection by clicking on the button **Test this connection**. Thereafter, a test message will be posted on the DingTalk group.

![](/files/-MaiA83zdnKGx3C5jnYI)

## FAQ <a href="#faq" id="faq"></a>

**Can I link multiple DingTalk Accounts to an ilert account?**

Yes.

**Are updates to an alert published on the DingTalk group?**

Yes, the following updates to an alert are currently being released:

* **Escalations** : An alert is assigned to another user through an automatic escalation.
* **Manual Assignments** : An alert is manually assigned to someone.
* **Actions** : An alert is accepted or resolved.

**Can I choose which updates to an alert will be published in DingTalk?**

Yes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ilert.com/integrations/outbound-integrations/dingtalk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
