> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-ai-for-work-dev.mintlify.site/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-ai-for-work-dev/gG9C_8BzEkmrf96g/ai-for-service/integrations/actions/images/zendesk-tem-img2.png?fit=max&auto=format&n=gG9C_8BzEkmrf96g&q=85&s=44ee3fac3f046bf8a0d33cb3a6c70add" 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-ai-for-work-dev/gG9C_8BzEkmrf96g/ai-for-service/integrations/actions/images/zendesk-tem-img3.png?fit=max&auto=format&n=gG9C_8BzEkmrf96g&q=85&s=49462a459d6e69c6db6b00dc4de5b9a6" 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-ai-for-work-dev/gG9C_8BzEkmrf96g/ai-for-service/integrations/actions/images/zendesk-tem-img4.png?fit=max&auto=format&n=gG9C_8BzEkmrf96g&q=85&s=ef4b3cc1fb29896da72b9f697f31cd45" 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-ai-for-work-dev/gG9C_8BzEkmrf96g/ai-for-service/integrations/actions/images/zendesk-tem-img5.png?fit=max&auto=format&n=gG9C_8BzEkmrf96g&q=85&s=724505d7bce1fdebed8f6cf9bbca97da" 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-ai-for-work-dev/gG9C_8BzEkmrf96g/ai-for-service/integrations/actions/images/zendesk-tem-img6.png?fit=max&auto=format&n=gG9C_8BzEkmrf96g&q=85&s=e348201f4813ac897e18e6ad04f4be91" 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-ai-for-work-dev/gG9C_8BzEkmrf96g/ai-for-service/integrations/actions/images/zendesk-tem-img7.png?fit=max&auto=format&n=gG9C_8BzEkmrf96g&q=85&s=e7eb7ed264103898ea6e5335b09f5819" 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 isn't 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-ai-for-work-dev/gG9C_8BzEkmrf96g/ai-for-service/integrations/actions/images/zendesk-tem-img8.png?fit=max&auto=format&n=gG9C_8BzEkmrf96g&q=85&s=41de3a12324b082ac433d2400ac728c7" 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-ai-for-work-dev/gG9C_8BzEkmrf96g/ai-for-service/integrations/actions/images/zendesk-tem-img9.png?fit=max&auto=format&n=gG9C_8BzEkmrf96g&q=85&s=b70838623522461cc9af926b6f3227ba" 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-ai-for-work-dev/hPMflewERfbZ7qP1/ai-for-service/integrations/actions/images/zendesk-tem-img10.png?fit=max&auto=format&n=hPMflewERfbZ7qP1&q=85&s=386603648e3620f71eafdd7d660ce15e" 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-ai-for-work-dev/hPMflewERfbZ7qP1/ai-for-service/integrations/actions/images/zendesk-tem-img11.png?fit=max&auto=format&n=hPMflewERfbZ7qP1&q=85&s=2e6c5f5819ad40423b2e9b9a91eae727" 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-ai-for-work-dev/hPMflewERfbZ7qP1/ai-for-service/integrations/actions/images/zendesk-tem-img12.png?fit=max&auto=format&n=hPMflewERfbZ7qP1&q=85&s=764092405a67a96b98f08616cc6f971c" 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-ai-for-work-dev/hPMflewERfbZ7qP1/ai-for-service/integrations/actions/images/zendesk-tem-img13.png?fit=max&auto=format&n=hPMflewERfbZ7qP1&q=85&s=b6a584e1acb0935f2fa5612644f148d3" 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-ai-for-work-dev/hPMflewERfbZ7qP1/ai-for-service/integrations/actions/images/zendesk-tem-img14.png?fit=max&auto=format&n=hPMflewERfbZ7qP1&q=85&s=aa46cb6997105aece6454f8f39b2ac75" 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-ai-for-work-dev/gG9C_8BzEkmrf96g/ai-for-service/integrations/actions/images/zendesk-tem-img15.png?fit=max&auto=format&n=gG9C_8BzEkmrf96g&q=85&s=03e2d8151f49ec0f544729ae8fec4ad3" 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-ai-for-work-dev/gG9C_8BzEkmrf96g/ai-for-service/integrations/actions/images/zendesk-tem-img16.png?fit=max&auto=format&n=gG9C_8BzEkmrf96g&q=85&s=452ed68b38f7f354923fb53e8a637d49" 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 isn't yet supported by the Zendesk Integration.
