> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Using the Zendesk Action Templates

<Badge icon="arrow-left" color="gray">[Back to Actions Integrations](/ai-for-service/integrations/overview#actions)</Badge>

Use prebuilt Zendesk action templates to auto-create dialog tasks for managing tickets.

**To access templates:**

1. Go to **Automation AI** > **Use Cases** > **Dialogs** and click **Create a Dialog Task**.

2. Under **Integration**, select **Zendesk**.

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img2.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=a08bdd6913b87b6d5e064a1f46e0eebb" alt="Integration - Zendesk" width="943" height="908" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img2.png" />

3. If no integration is configured, click **Explore Integrations** to set one up. See [Actions Overview](/ai-for-service/integrations/overview#actions).

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img3.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=53f87dcdf32c00e28c2aed571d6a3c91" alt="Explore Integrations" width="892" height="906" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img3.png" />

***

## Supported Actions

| Task                      | Description                                                    | Method |
| ------------------------- | -------------------------------------------------------------- | ------ |
| Create a Ticket           | Creates a ticket in the Zendesk system.                        | POST   |
| Update a Ticket           | Updates a ticket in the Zendesk system. (Not yet supported.)   | PUT    |
| Delete a Ticket           | Deletes a ticket from the Zendesk system. (Not yet supported.) | DELETE |
| View All Tickets          | Retrieves all tickets from the Zendesk system.                 | GET    |
| View Ticket(s) by ID(s)   | Retrieves tickets using multiple IDs.                          | GET    |
| Search Ticket by Keywords | Searches tickets using keywords.                               | GET    |

***

### Create a Ticket

1. Install the template from [Zendesk Action Templates](/ai-for-service/integrations/actions/configuring-the-zendesk-action#step-2-install-the-zendesk-action-templates).

2. The *Create a Ticket* dialog task is added with the following components:

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img4.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=2927d70f65fc16e178d8bcc87770c696" alt="Create a Ticket dialog task is added" width="1423" height="904" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img4.png" />

   * **createTicket** - User intent to create a ticket.

   * **subject**, **body**, **priority** - Entity nodes for ticket details.

   * **createTicketService** - Bot action service to create a ticket. Click **Edit Request**:

     <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img5.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=9d73a1d0aee4c5516b56b56a428aa402" alt="Create a Ticket - Edit request" width="1908" height="904" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img5.png" />

     **Sample Request:**

     ```json  theme={null}
     {
       "ticket": {
         "subject": "POST request from postman",
         "comment": {
           "body": "Ticket Created!!"
         }
       }
     }
     ```

     Click **+Add Response**:

     **Sample Response:** (truncated)

     ```json  theme={null}
     {
       "ticket": {
         "url": "https://abc2152.zendesk.com/api/v2/tickets/29.json",
         "id": 29,
         "subject": "POST request from postman",
         "description": "Ticket Created!!",
         "priority": null,
         "status": "open",
         "created_at": "2022-08-29T11:39:53Z"
       }
     }
     ```

   * **createTicketScript** - Bot action script to create a ticket.

   * **createTicketMessage** - Message node to display responses.

3. Click **Train**, then **Talk to Bot** to test:

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img6.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=41943a4ee939f1ed547ade09ac1ab1f9" alt="VA prompt to Create a Ticket" width="592" height="838" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img6.png" />

4. Click **View Ticket** to see ticket details in Zendesk:

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img7.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=03e4b0cbaf891c339ceadece0c4ccf4e" alt="View the ticket details in the Zendesk instance" width="596" height="834" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img7.png" />

***

### Update a Ticket

This action template is not yet supported by the Zendesk Integration.

***

### View All Tickets

1. Install the template from [Zendesk Action Templates](/ai-for-service/integrations/actions/configuring-the-zendesk-action#step-2-install-the-zendesk-action-templates).

2. The *View All Tickets* dialog task is added with the following components:

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img8.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=190db58d521c6f4c1f7a5b1189716d3c" alt="View All Tickets dialog task is added" width="1397" height="907" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img8.png" />

   * **listAllTickets** - User intent to view all tickets.

   * **listAllTicketsService** - Bot action service to fetch all tickets. Click **+Add Response**:

     <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img9.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=aedfb79aa812b1da27254716ffb2c3f5" alt="View All Tickets - Add Response" width="1919" height="901" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img9.png" />

     **Sample Response:** (truncated)

     ```json  theme={null}
     {
       "tickets": [
         {
           "url": "https://abc2152.zendesk.com/api/v2/tickets/7.json",
           "id": 7,
           "subject": "POST request from postman",
           "priority": "high",
           "status": "closed",
           "created_at": "2022-08-25T07:31:22Z"
         }
       ],
       "count": 49
     }
     ```

   * **listAllTicketsMessage** - Message node to display responses.

3. Click **Train**, then **Talk to Bot** to test:

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img10.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=11374cc16235d8ce057ac5015e3a417f" alt="VA prompt to View All Tickets" width="598" height="832" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img10.png" />

***

### View Ticket(s) by ID(s)

1. Install the template from [Zendesk Action Templates](/ai-for-service/integrations/actions/configuring-the-zendesk-action#step-2-install-the-zendesk-action-templates).

2. The *View Ticket(s) by ID(s)* dialog task is added with the following components:

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img11.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=b3aaae58df573e0a45785a04688149a7" alt="View Ticket(s) by ID(s) dialog task is added" width="1419" height="904" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img11.png" />

   * **viewTicketbyId** - User intent to find a ticket by ID.

   * **multipleticketIds** - Entity node for entering multiple ticket IDs.

   * **viewTicketbyIdsService** - Bot action service to find tickets by ID. Click **+Add Response**:

     <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img12.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=300a4f6a9e3d00d545ae2e6ca1fc1de8" alt="View Ticket(s) by ID(s) - Add response" width="1918" height="820" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img12.png" />

     **Sample Response:** (truncated)

     ```json  theme={null}
     {
       "tickets": [
         {
           "id": 33,
           "subject": "POST request from postman",
           "priority": "urgent",
           "status": "open"
         },
         {
           "id": 34,
           "subject": "POST request from postman",
           "priority": "urgent",
           "status": "open"
         }
       ],
       "count": 2
     }
     ```

   * **viewTicketsbyIdsScript** - Bot action script to view tickets with IDs.

   * **updateTicketMessage** - Message node to display responses.

3. Click **Train**, then **Talk to Bot** to test:

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img13.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=ac61956cc375f5ad0b3d8c0f54d8e6e4" alt="VA prompt to find Ticket(s) by ID(s)" width="586" height="831" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img13.png" />

***

### Search Ticket with Keywords

1. Install the template from [Zendesk Action Templates](/ai-for-service/integrations/actions/configuring-the-zendesk-action#step-2-install-the-zendesk-action-templates).

2. The *Search Ticket with Keywords* dialog task is added with the following components:

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img14.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=ce65b4c6934020610a4bcd0fd53e792b" alt="Search Ticket with Keywords dialog task is added" width="1432" height="904" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img14.png" />

   * **searchTickets** - User intent to search tickets.

   * **searchKeywords** - Entity node for search keywords.

   * **searchTicketService** - Bot action service to search tickets by keyword. Click **+Add Response**:

     <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img15.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=c41f8b41a2a576b21a7b74685bbf0279" alt="Search Ticket with Keywords - Add response" width="1919" height="716" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img15.png" />

     **Sample Response:** (truncated)

     ```json  theme={null}
     {
       "results": [
         {
           "id": 31,
           "subject": "POST request from postman",
           "status": "open",
           "result_type": "ticket"
         }
       ],
       "count": 12
     }
     ```

   * **searchTicketScript** - Bot action service to search tickets by field.

   * **searchTicketMessage** - Message node to display responses.

3. Click **Train**, then **Talk to Bot** to test:

   <img src="https://mintcdn.com/koreai/6kNZlFFL7-veA_Xn/ai-for-service/integrations/actions/images/zendesk-tem-img16.png?fit=max&auto=format&n=6kNZlFFL7-veA_Xn&q=85&s=ca835ecae81030d5bf3a9e98bec559fc" alt="VA prompt to Search Ticket with Keywords" width="594" height="838" data-path="ai-for-service/integrations/actions/images/zendesk-tem-img16.png" />

***

### Delete a Ticket

This action template is not yet supported by the Zendesk Integration.


Built with [Mintlify](https://mintlify.com).