# /createticket

## CreateTicket Command

### Overview

The `/createticket` command allows you to create a new support ticket (channel) on behalf of a specified user, optionally specifying a type and a reason for clarity.

### Usage

```
/createticket <user:@user> [type] [reason]
```

* **user** *(required user mention)*: The user for whom you’re creating the ticket.
* **type** *(optional text)*: A label or category for the ticket.
* **reason** *(optional text)*: A short explanation of why you’re creating this ticket.

### Description

* **User-Focused**: Lets staff create a ticket directly for a user, helpful if the user doesn’t know how or can’t create one themselves.
* **Categorization**: Adding a type or reason helps organize tickets (e.g., “billing,” “technical,” etc.).

### When to Use It

* If a user is not sure how to open a ticket themselves.
* When staff need a dedicated channel to address a user’s concern and want to initiate the conversation.

### Permissions

* Typically requires staff permissions (to represent that staff can open tickets for users).
* The bot needs `Manage Channels` to create new channels.

### Examples

```
/createticket user:@JohnDoe
```

Creates a new ticket channel for John Doe without any type or reason specified.

```
/createticket user:@JohnDoe type:"billing" reason:"User requested billing support"
```

Opens a ticket labeled “billing” and logs the reason for clarity.


---

# 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.ticketking.xyz/bot-commands/createticket.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.
