# Zammad Inbound Integration

[Zammad](https://zammad.com/en) is an open-source helpdesk and customer support platform designed to help businesses manage communications and interactions with their customers.

## In ilert: Create a Zammad alert source <a href="#in-ilert" id="in-ilert"></a>

1. Go to **Alert sources** --> **Alert sources** and click on **Create new alert source**

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjX0cS4q7woTXKajZmc1W%2FScreenshot%202023-08-28%20at%2010.21.10.png?alt=media&#x26;token=8ef3666b-84eb-4b51-abee-f07303313941" alt=""><figcaption></figcaption></figure>
2. Search for **Zammad** in the search field, click on the Zammad tile and click on **Next**.&#x20;

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FlXzQlJpaTFSR49AZk0xA%2FScreenshot%202023-08-28%20at%2010.24.23.png?alt=media&#x26;token=cffeacb4-57b9-47d4-827d-b0f6b1afd914" alt=""><figcaption></figcaption></figure>
3. Give your alert source a name, optionally assign teams and click **Next**.
4. Select an **escalation policy** by creating a new one or assigning an existing one.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FNnuZqONaIhbOf6fn4OkZ%2FScreenshot%202023-08-28%20at%2011.37.47.png?alt=media&#x26;token=8a74f7b5-5bd2-4eea-97fa-1c1dbb041333" alt=""><figcaption></figcaption></figure>
5. Select you [Alert grouping](https://docs.ilert.com/alerting/configure-alerting/alert-sources#alert-grouping) preference and click **Continue setup**. You may click **Do not group alerts** for now and change it later.&#x20;

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FueugN4JgHn1c90ggFA6u%2FScreenshot%202023-08-28%20at%2011.38.24.png?alt=media&#x26;token=b8009daf-3ca8-4264-a6fa-e42ef7333205" alt=""><figcaption></figcaption></figure>
6. The next page show additional settings such as customer alert templates or notification prioritiy. Click on **Finish setup** for now.
7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fi3TIOBvNYBQfDtNpmm0A%2FScreenshot%202023-08-28%20at%2011.47.34.png?alt=media&#x26;token=6cae965a-e448-4443-8c20-37cf501c43b2" alt=""><figcaption></figcaption></figure>

## In Zammad: Create ticket triggers <a href="#in-topdesk" id="in-topdesk"></a>

1. Go to Zammad and then to **Trigger**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MSwOK4GNegEcD2BT40N%2F-MSwPg5NFezBl2yYQfLI%2FScreenshot_07_02_21__13_13.png?alt=media\&token=08ea516e-ca48-4ef6-ab1e-1a28e868be96)

2. Click on **New Trigger.** On the modal window, in the **Conditions for effected objects** section choose the condition **State is new,** name the trigger e.g. **ilert Trigger - New Ticket** , in the **Execute changes on object** section choose **Webhook** and paste the **Webhook URL** that you generated in ilert then click on **Submit**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MSwOK4GNegEcD2BT40N%2F-MSwQ_ihQvkZQkw-2t1A%2FScreenshot_07_02_21__13_18.png?alt=media\&token=203f9d01-fbcc-48ea-9b62-d26242b10604)

3. Click on **New Trigger.** On the modal window, in the **Conditions for effected objects** section choose the condition **State is open,** name the trigger e.g. **ilert Trigger - Open Ticket** , in the **Execute changes on object** section choose **Webhook** and paste the **Webhook URL** that you have generated in ilert and then click on **Submit**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MSwOK4GNegEcD2BT40N%2F-MSwRvOToAA-oZyxuJFH%2FScreenshot_07_02_21__13_24.png?alt=media\&token=93589787-d07e-4aa3-8adc-1e4be4822bfa)

4. Click on **New Trigger.** On the modal window, in the **Conditions for effected objects** section choose the condition **Owner has changed,** name the trigger e.g. **ilert Trigger - Owner changed** , in the **Execute changes on object** section choose **Webhook** and paste the **Webhook URL** that you have generated in ilert and then click on **Submit**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MSwOK4GNegEcD2BT40N%2F-MSwSLh3go4z4Xso0lEv%2FScreenshot_07_02_21__13_26.png?alt=media\&token=3cb193bd-c600-441f-9889-f02969d91d49)

5. Click on **New Trigger.** On the modal window, in the **Conditions for effected objects** section choose the condition **State has changed,** name the trigger e.g. **ilert Trigger - Ticket changed** , in the **Execute changes on object** section choose **Webhook** and paste the **Webhook URL** that you have generated in ilert and then click on **Submit**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MSwOK4GNegEcD2BT40N%2F-MSwSd_TVR9Jj67zQ0Tj%2FScreenshot_07_02_21__13_27.png?alt=media\&token=f67dd94d-6372-4e58-a47a-9bb116d2915a)

Your Zammad triggers are now in place and will trigger appropriate ilert alert actions of your created alert source.

## Mapping of Zammand Ticket Priority to Alert Priority

The Zammad ticket priority is mapped to the ilert alert priority according to the following table:

| Zammand ticket priority | ilert alert priority |
| ----------------------- | -------------------- |
| **High (id: 3)**        | High                 |
| Any other               | Low                  |

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

### **Will alerts in ilert be resolved automatically?**

Yes

### **Can I connect Zammad with multiple alert sources from ilert?**

Yes, simply create more action sequences in Zammad.

### Will Zammad comments be synced to ilert?

Yes, Zammad comments will automatically be attached to ilert alerts.

## Related articles

{% content-ref url="../outbound-integrations/zammad" %}
[zammad](https://docs.ilert.com/integrations/outbound-integrations/zammad)
{% endcontent-ref %}
