> For the complete documentation index, see [llms.txt](https://docs.wonderchat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wonderchat.io/integration-guides/zendesk.md).

# Zendesk

Connect Wonderchat with Zendesk to send support handovers straight to your help desk.

You can also customize the Zendesk ticket subject with placeholders and map collected visitor data to Zendesk ticket fields.

***

## Step 1: Open the integrations page

Go to **Settings** → **Integrations**.

<figure><img src="/files/fgqJsw2uMMQF5Bxtqwya" alt=""><figcaption><p>Open <strong>Settings</strong> and go to <strong>Integrations</strong>.</p></figcaption></figure>

## Step 2: Connect your Zendesk account

Under **Zendesk**, enter your subdomain and click **Connect**.

<figure><img src="/files/WjzaelVDuq9QYEXAeVir" alt=""><figcaption><p>Enter your Zendesk subdomain and click <strong>Connect</strong>.</p></figcaption></figure>

## Step 3: Authorize Zendesk

Approve the connection between Wonderchat and Zendesk.

<figure><img src="/files/Zwd1ohh4BnlyOqYAnWCl" alt=""><figcaption></figcaption></figure>

## Step 4: Confirm the connection

After the connection succeeds, Wonderchat shows a confirmation message.

<figure><img src="/files/QEJf4fPxAUJD6A8uayZb" alt=""><figcaption><p>Sample successful connection message.</p></figcaption></figure>

## Step 5: Configure Zendesk ticket creation

Go back to your dashboard and open **Edit Chatbot**.

<figure><img src="/files/7j7Nbo2yyDFIe0uY0bEl" alt=""><figcaption></figcaption></figure>

Open the **Tools** tab.

<figure><img src="/files/acvIGqh4mIEilHiAujpN" alt=""><figcaption></figcaption></figure>

Search for **Zendesk** and enable ticket creation.

<figure><img src="/files/VcUlWxj1mlOXM556kEi0" alt=""><figcaption></figcaption></figure>

Once enabled, Wonderchat can create Zendesk tickets when the selected trigger runs.

### Customize the Zendesk ticket subject

Use **Zendesk Ticket Subject** to control how new tickets are named.

You can insert collected fields as placeholders. Use the field picker or type `{{field name}}`.

Examples:

* `Support request from {{name}}`
* `Billing issue from {{email}}`
* `Enterprise lead from {{company}}`

When Wonderchat creates the ticket, each placeholder is replaced with the visitor's collected value.

<figure><img src="/files/BK5zXBuypjmoyNpiwbFA" alt=""><figcaption></figcaption></figure>

### Map collected visitor data to Zendesk fields

Use **Custom Field Mapping** to send collected visitor data into Zendesk custom ticket fields.

This is useful when you want values like name, email, phone number, or custom form answers to appear in specific Zendesk fields.

Keep these rules in mind:

* You can map any collected Wonderchat field to a matching Zendesk ticket field.
* Dropdown-type Zendesk fields expect the collected value to exactly match one of the field's option values.
* If your Zendesk fields are still loading, wait until the list finishes loading before adding mappings.

<figure><img src="/files/R3UElCB9DVZITi5sEKVi" alt=""><figcaption></figcaption></figure>

### Optional: Include the visitor's page URL

Enable **Include page URL in ticket** to add the page the visitor was on when the ticket was created.

## Step 6: Train your chatbot on Zendesk tickets and articles

Open **Edit Chatbot** → **Data Sources** → **Zendesk**.

<figure><img src="/files/kOTGc9QDpkPX6lu1RDuR" alt=""><figcaption></figcaption></figure>

Click **Sync** to pull in your Zendesk data.

<figure><img src="/files/nf3lxmUDZyO8Q8vpnI1q" alt=""><figcaption></figcaption></figure>

For the full training flow, see [How to Train Your Chatbot Using Zendesk Tickets & Knowledge Base](/setup-guides/training-your-chatbot/how-to-train-your-chatbot-using-zendesk-tickets-and-knowledge-base.md).

## Step 7: Test the integration

Go to **Dashboard** → **Actions** (⋮) → **View Chatbot**.

<figure><img src="/files/SzEazvlTxJgs1uIg07J5" alt=""><figcaption><p>Click <strong>View Chatbot</strong>.</p></figcaption></figure>

Submit a support request through the widget.

<figure><img src="/files/PXAUZHzFJcoHtDOrODi7" alt=""><figcaption><p>Submit a message through the chat widget.</p></figcaption></figure>

After the handover runs, you should see a new Zendesk ticket with the configured subject and any mapped field values.

<figure><img src="/files/2VWWPdIQ8sB6fngZehnp" alt=""><figcaption><p>Sample Zendesk ticket.</p></figcaption></figure>

***

Questions? Reach us at **<support@wonderchat.io>**.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.wonderchat.io/integration-guides/zendesk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.