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

# Freshdesk

## What you can do

* Train your agent on your Freshdesk Help Center, canned responses, and past tickets
* Automatically reply to tickets or draft responses for your team
* Tag, assign, close, and update tickets
* Search and read ticket history

## Connecting Freshdesk

### OAuth (recommended)

Connect your full Freshdesk account for tickets, canned responses, and all actions.

1. Go to **Integrations > Freshdesk**
2. Select **OAuth**
3. Click **Connect** and authorize eesel AI

### Quick Start

Enter your Freshdesk Help Center URL to start training immediately. No authentication needed — but you won't have access to tickets, canned responses, or actions.

1. Go to **Integrations > Freshdesk**
2. Select **Quick Start**
3. Enter your help center URL
4. Click **Connect**

## Training your agent

| Source               | Description                                | Requires             |
| -------------------- | ------------------------------------------ | -------------------- |
| **Help Center**      | Published support articles                 | Quick Start or OAuth |
| **Canned Responses** | Your team's pre-written response templates | OAuth                |
| **Tickets**          | Past resolved tickets                      | OAuth                |

## Triggers

{% hint style="warning" %}
**Freshdesk Sprout plan users:** Triggers are not supported on the Freshdesk Sprout (free) tier. Freshdesk Sprout does not support webhooks, which eesel AI requires to listen for ticket events. You'll need to upgrade to a paid Freshdesk plan (Blossom or above) to use triggers.
{% endhint %}

| Trigger                | Description                                      | Best for                  |
| ---------------------- | ------------------------------------------------ | ------------------------- |
| **@eesel Mentioned**   | Fires when @eesel is mentioned in internal notes | On-demand AI Copilot      |
| **New Ticket Created** | Fires when a new ticket comes in                 | Full automation or triage |
| **Ticket Updated**     | Fires when a ticket is updated                   | Follow-up handling        |

## Actions

### Responding

| Action                  | Description                                    |
| ----------------------- | ---------------------------------------------- |
| **Leave Public Reply**  | Send a customer-visible reply (HITL available) |
| **Leave Draft Reply**   | Create a draft for your team to review         |
| **Leave Internal Note** | Add a note only your team can see              |

### Ticket management

| Action              | Description                                     |
| ------------------- | ----------------------------------------------- |
| **Tag Ticket**      | Add tags for categorization                     |
| **Create Ticket**   | Create a new ticket                             |
| **Assign Ticket**   | Assign to a specific agent                      |
| **Assign to Group** | Route to a team queue                           |
| **Close Ticket**    | Mark as resolved                                |
| **Update Ticket**   | Change custom fields, priority, status, or tags |
| **Update Status**   | Change ticket status specifically               |

### Information lookup

| Action             | Description                                |
| ------------------ | ------------------------------------------ |
| **Read Ticket**    | Read full ticket with conversation history |
| **Search Tickets** | Search using Freshdesk query syntax        |
| **List Tickets**   | List tickets with filters                  |

## Tips and best practices

**Import canned responses.** If your team already has well-crafted canned responses, training your agent on them ensures consistent, approved messaging.

**Use "New Ticket Created" for triage.** This trigger fires before any agent interacts with the ticket — ideal for auto-categorization and routing.

**Filter past tickets by date.** When training on past tickets, focus on recent ones (last 6-12 months) for the most relevant training data.

## Troubleshooting

**OAuth connection failing?**

* Ensure you have admin permissions in Freshdesk
* Check that third-party app access is enabled in your Freshdesk settings

**Agent not responding to tickets?**

* Verify the trigger is enabled in Settings > Triggers
* Check that webhooks are configured correctly in Freshdesk


---

# 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:

```
GET https://docs.eesel.ai/integrations/freshdesk.md?ask=<question>
```

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.