> For the complete documentation index, see [llms.txt](https://docs.ilert.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ilert.com/integrations/outbound-integrations/dingtalk.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
