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

# Zendesk

> Connect Zendesk to PlayerZero for AI-assisted customer support.

Zendesk is a customer service platform designed to improve customer relationships.

## What You Can Do

Once connected, PlayerZero AI agents can:

* **Read tickets and comments** — Access full ticket history, customer messages, and agent responses for context
* **Create and update tickets** — Generate support tickets from debug sessions or update existing ones with findings
* **Delete tickets** — Remove tickets that are no longer needed
* **Add comments** — Post public replies or internal notes with investigation results and technical details
* **Search tickets** — Find related tickets and known issues when investigating problems
* **Manage tags** — Set or remove tags on tickets for categorization and routing
* **Search and retrieve users** — Find users by name or email and access user details
* **Browse organizations** — Retrieve organization details and list all organizations
* **Discover metadata** — List available ticket fields and support groups for routing decisions

## Use Cases

* **Support triage** - AI agents analyze incoming tickets and suggest priority, tags, or assignment based on code analysis
* **Debug-to-ticket workflow** - Convert investigation findings into detailed Zendesk tickets for customer communication
* **Known issue detection** - When investigating, agents search for similar past tickets to identify patterns

## Scopes & Permissions

<Info>
  PlayerZero requests only the permissions needed for AI agents to assist with support workflows. We follow the principle of least privilege—each permission directly enables a specific capability.
</Info>

| Scope   | Why It's Needed                                                                                                                                                                            |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `read`  | **Context gathering** — Allows AI agents to read ticket history, customer messages, and organization data when investigating issues or searching for related past tickets                  |
| `write` | **Ticket management** — Enables agents to create tickets from debug sessions, post internal notes with findings, and update ticket status when you ask them to document or escalate issues |

## Setup

<Note>
  Setup starts in PlayerZero—no pre-configuration in Zendesk is required.
</Note>

1. In PlayerZero, navigate to **Settings → Context → Ticketing**
2. Find **Zendesk** and click **Connect**
3. You'll be redirected to Zendesk to log in and authorize PlayerZero
4. After authorization, select which PlayerZero projects should have access to this integration