# Zendesk

#### Overview

This guide walks you through connecting your Zendesk account to klink.cloud. Once connected, all of your Zendesk tickets appear directly in the klink.cloud Inbox, and you can configure an AI Agent to automatically respond to incoming Zendesk conversations.

#### What You'll Need

* Admin access to your Zendesk account
* Access to your klink.cloud workspace (app.klink.cloud)
* Permission to create workflows in klink.cloud

***

### Part 1 — Generate a Zendesk API Token

**Step 1: Open the API Token settings in Zendesk**

1. Log in to your Zendesk account as an administrator.
2. Go to **Admin Center** > **Apps and integrations** > **APIs** > **API Configuration > Enable APIs**

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

**Step 2: Create the API Token**

1. Make sure **Token Access** is enabled.
2. Click **Add API token** (or the plus icon).
3. Optionally add a description, for example "klink.cloud integration", so you can identify it later.

<figure><img src="/files/4HA913p9FpPal87InzUd" alt=""><figcaption></figcaption></figure>

**Step 3: Copy the API Token**

1. Copy the generated token and store it somewhere safe.
2. Click **Save** to finalize the token.

> **Important:** The full token is only shown once at creation. If you lose it, you will need to generate a new one. You will also need your Zendesk subdomain (the part before `.zendesk.com` in your URL) and your admin email address to complete the connection.

***

### Part 2 — Connect Zendesk in klink.cloud

**Step 4: Open the integration settings**

1. Go to **app.klink.cloud** and log in.
2. Navigate to **Message & Integration**.

**Step 5: Connect Zendesk**

1. Select **Connect Zendesk**.
2. Enter your Zendesk subdomain, admin email, and paste the API Token you copied in Part 1.
3. Save the connection.

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

Once the connection is successful, your Zendesk tickets will start syncing into klink.cloud.

**Step 6: View Zendesk tickets in the Inbox**

After setup, open the **Inbox** in klink.cloud. All of your Zendesk tickets will appear there alongside your other channels, giving you a single unified view to manage every conversation.

***

### Part 3 — Enable the AI Agent

To have the AI Agent automatically handle incoming Zendesk conversations, create a workflow that routes new Zendesk chats to the AI Agent.

**Step 7: Create the workflow**

Set up a workflow with the following logic:

| Component | Configuration                  |
| --------- | ------------------------------ |
| Trigger   | When a new chat room is opened |
| Condition | Channel is Zendesk             |
| Action    | Assign to AI Agent             |

In plain terms: When a new chat room is opened, and the channel is Zendesk, assign the conversation to the AI Agent.

**Step 8: Save and activate**

1. Save the workflow.
2. Make sure the workflow is active.

New Zendesk conversations will now be automatically routed to the AI Agent, which will reply on your behalf.

#### Summary

1. Generate an API Token in Zendesk Admin Center.
2. Connect Zendesk in klink.cloud under Message & Integration.
3. View all Zendesk tickets in the klink.cloud Inbox.
4. Create a workflow to assign new Zendesk chats to the AI Agent.


---

# 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.klink.cloud/getting-started/setup-channels/zendesk.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.