# Setup Zendesk email and ticket automation
DeepConverse for Zendesk email and ticket automation allows you to build an AI and Automation layer to respond and handle tickets efficiently. The automation engine does the work of understanding the tickets and responding accordingly with macros, email templates and responses from knowledge articles.
### Pre-requisties
Before configuring Zendesk we need to ensure that there are some steps completed in the DeepConverse dashboard.
1. Establish **OAuth connection** with your Zendesk instance
2. Create **bot** and **workflows** (these are the actions you want the bot to handle)
3. Configure **connection** to use for the bot
### Execution Flow
At a high level this is the flow that gets executed
1. Customer **creates a ticket** in Zendesk
2. When the ticket is created a Zendesk **trigger** will get fired and **notify** DeepConverse with the relevant ticket information.
3. DeepConverse will make **predictions** and choose the **workflow to execute**
4. Workflow will **update the ticket** and if needed **add a reply** in the ticket as a comment.
### Zendesk Setup and Configuration
#### Create a Webhook in Zendesk
You will need to add a webhook to inform DeepConverse of changes to tickets in Zendesk. The steps to do this in Zendesk are here -
[Creating webhooks to interact with third-party systems](https://support.zendesk.com/hc/en-us/articles/4408839108378-Creating-webhooks-to-interact-with-third-party-systems)
You can find the webhook url from the DeepConverse channels page.
 
#### Create a trigger in Zendesk
For DeepConverse to handle tickets we will need to add a trigger which will inform DeepConverse when tickets are created.
1. Navigate to **Zendesk Admin Center** > **Objects and Rules** > **Triggers**
2. Click **Add Trigger**
3. Fill out the trigger with the information below.
**Name**: DeepConverse Automation
**Conditions**
Meet ALL of the following conditions
* `Tags` contains none of `dc-automation-triggered`
* `Ticket` is `Updated`
Meet ANY of the following conditions
* `Channel` is `Email` (Add any other channels that you would like the trigger to run for)
Actions
* Notify active webhook: DeepConverse Automation\
JSON Body:
```
{
"agent": {
"name": "{{ticket.assignee.name}}",
"email": "{{ticket.assignee.email}}"
},
"requester": {
"name": "{{ticket.requester.name}}",
"email": "{{ticket.requester.email}}"
},
"payload": {
"id": "{{ticket.id}}",
"source": "{{ticket.via}}",
"title": "{{ticket.title}}",
"description": "{{ticket.description}}",
"status": "{{ticket.status}}",
"message": "{{ticket.latest_comment}}",
"tags": "{{ticket.tags}}",
"updated_stamp": "{{ticket.updated_at_with_timestamp}}",
"brand": "{{ticket.brand.name}}",
... custom fields
"marketplace": "{{ticket.ticket_field_8792255150861}}"
}
}
```
* Add tags: `dc-automation-triggered`
Once the trigger has been Saved go back to the triggers screen.
#### Ordering of Triggers
To ensure that DeepConverse gets all the information needed for executing the Automation we will need to have the DeepConverse Automation trigger placed after some of the business rule triggers have been applied.
Follow the instructions here to reorder the trigger: [Reordering and sorting triggers](https://support.zendesk.com/hc/en-us/articles/4408894209562-Reordering-and-sorting-triggers#:~:text=To%20reorder%20triggers%20using%20drag,triggers%20you%20want%20to%20move.)
### Tags that are used by DeepConverse
| **Tag** | **Description** |
| ---------------------------- | ----------------------------------------------------------------------- |
| dc-automation-triggered | Marks that the ticket went through the DeepConverse automation webhook. |
| dc-auto-reply | Marks that the ticket has an auto reply comment to the customer. |
| dc-automation-ticket-updated | Marks that certain fields in the ticket were updated by the automation |
| dc-email-positive-feedback | Marks positive feedback given by the customer to the auto reply email |
| dc-email-negative-feedback | Marks negative feedback given by the customer to the auto reply email |
---
# 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.deepconverse.com/product-docs/ticket-automation/setup-zendesk-email-and-ticket-automation.md?ask=
```
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.