> For the complete documentation index, see [llms.txt](https://ticketking.xyz/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ticketking.xyz/docs/pt-br/primeiros-passos/invite-ticket-king.md).

# Convide o Ticket King para o seu servidor

Adicione o Ticket King ao seu servidor Discord em menos de um minuto.

Este é o primeiro passo de todos. Assim que o Ticket King estiver no seu servidor, todas as outras páginas destes documentos passam a ser úteis.

## O link de convite

{% stepper %}
{% step %}

### Clique no link de convite

Clique aqui para convidar o Ticket King:

<a href="https://ticketking.xyz/invite?via=docs" class="button primary" data-icon="robot">Adicione o Ticket King ao seu servidor</a>

Isso abre o fluxo padrão do Discord de "Adicionar ao Servidor". Você será perguntado a qual servidor adicionar o bot e, em seguida, quais permissões conceder.

<figure><img src="https://2122257628-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrnuG1qjzbOoh0efVpoK8%2Fuploads%2Fgit-blob-c420596654a0ee66ce5d17a484e8b159db0942f2%2Finvite-flow.gif?alt=media" alt="Inviting Ticket King and authorizing it for a server"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Escolha o servidor

Escolha seu servidor no menu suspenso "Adicionar ao Servidor" do Discord. Apenas servidores nos quais você tenha Gerenciar servidor ou Administrador (ou seja o proprietário) aparecem na lista.

<figure><img src="https://2122257628-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrnuG1qjzbOoh0efVpoK8%2Fuploads%2Fgit-blob-fa5aa16db0eb250b080c4ee68d6057fecd45455c%2Finvite-step-pick-server.png?alt=media" alt="Discord&#x27;s Add to Server screen with the server dropdown open"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Revise e autorize as permissões

O Discord mostra as permissões que o Ticket King está solicitando. Revise-as e clique em **Autorizar**. O link de convite recomendado inclui Administrador por conveniência, e você pode substituí-lo pelas permissões específicas abaixo após convidar.

<figure><img src="https://2122257628-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrnuG1qjzbOoh0efVpoK8%2Fuploads%2Fgit-blob-13c7193529e58609a6dc28f288a740f1608eda0c%2Finvite-step-authorize.png?alt=media" alt="Discord&#x27;s permission screen for the invite with the Authorize button"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### O bot entra

Depois que você autorizar, o Discord o redireciona de volta para ticketking.xyz, o Ticket King entra no seu servidor e você cai diretamente no painel desse servidor, pronto para configurar. Veja [O que acontece no momento em que o bot entra](#what-happens-the-moment-the-bot-joins) abaixo para saber o que esperar em seguida.
{% endstep %}
{% endstepper %}

## Quem pode adicionar o bot

Para adicionar qualquer bot a um servidor do Discord, você precisa de uma função com **Gerenciar servidor** OU **Administrador** (ou ser o proprietário do servidor). Se o menu suspenso de servidores estiver vazio ou seu servidor não aparecer, é por isso.

## Quais permissões o Ticket King precisa e por quê

O link de convite recomendado inclui **Administrador**. Isso é por conveniência, para que todos os recursos funcionem imediatamente e você nunca precise correr atrás de uma permissão ausente. Se preferir, você pode remover Administrador depois de convidar e conceder as permissões específicas abaixo no lugar. O bot funciona de qualquer forma.

<details>

<summary>Veja a lista completa de permissões e por que cada uma é necessária</summary>

<table><thead><tr><th width="240">Permissão</th><th>Por que o Ticket King precisa disso</th></tr></thead><tbody><tr><td><strong>Administrador</strong></td><td>Incluído no convite recomendado por conveniência. Ele cobre todas as permissões abaixo em uma única concessão. Opcional. Você pode substituí-lo pelas permissões específicas desta tabela.</td></tr><tr><td><strong>Gerenciar canais</strong></td><td>Para criar o canal de ticket (ou thread) quando um membro abre um ticket e, para excluí-lo ao fechar, se você tiver configurado isso.</td></tr><tr><td><strong>Gerenciar funções</strong></td><td>Para dar ao criador do ticket e a quaisquer funções de suporte acesso ao novo canal de ticket. Sem isso, os membros podem abrir tickets, mas não podem vê-los.</td></tr><tr><td><strong>Gerenciar mensagens</strong></td><td>Para excluir a mensagem do painel se você movê-la ou reenviá-la, e para limpar as mensagens do bot ao fechar o ticket.</td></tr><tr><td><strong>Gerenciar threads</strong>, <strong>Criar threads públicas</strong> &#x26; <strong>Criar threads privadas</strong></td><td>Necessário se você usar tickets em threads ou threads da equipe. Gerenciar threads também permite que o bot as feche.</td></tr><tr><td><strong>Ver canal</strong></td><td>Para que o bot possa ver os canais aos quais você o direciona: canais de log, canais de painel e os tickets que ele cria.</td></tr><tr><td><strong>Enviar mensagens</strong> &#x26; <strong>Enviar mensagens em threads</strong></td><td>Para publicar a mensagem do painel, o embed de ticket aberto e quaisquer logs.</td></tr><tr><td><strong>Incorporar links</strong></td><td>As mensagens do Ticket King são quase totalmente embeds. Sem isso, seus painéis aparecem como texto simples.</td></tr><tr><td><strong>Anexar arquivos</strong></td><td>Para publicar transcrições em canais de log.</td></tr><tr><td><strong>Ler histórico de mensagens</strong></td><td>Para gerar transcrições. Sem isso, as transcrições ficam vazias.</td></tr><tr><td><strong>Adicionar reações</strong></td><td>Para alguns prompts interativos.</td></tr><tr><td><strong>Usar emojis externos</strong> &#x26; <strong>Usar figurinhas externas</strong></td><td>Para que botões, painéis e mensagens de ticket possam usar emojis e figurinhas de outros servidores.</td></tr><tr><td><strong>Usar comandos de aplicativo</strong></td><td>Para que os comandos de barra do Ticket King funcionem no seu servidor.</td></tr><tr><td><strong>Mencionar @everyone, @here e Todas as Funções</strong></td><td>Essa permissão cobre marcar qualquer função, inclusive funções que não estão definidas como mencionáveis. O Ticket King precisa dela para marcar sua equipe e as funções de suporte no início de um novo ticket. A maioria das funções da equipe não vem definida como mencionável por padrão, então o bot precisa dessa permissão para marcá-las.</td></tr></tbody></table>

</details>

{% hint style="info" %}
**Quer o detalhamento completo das permissões por recurso?** Veja [as permissões de que o Ticket King precisa no Discord](/docs/pt-br/referencia/discord-permissions.md) na seção de referência.
{% endhint %}

## O que acontece no momento em que o bot entra

Logo após autorizar o convite:

1. **O Ticket King aparece na sua lista de membros.** Ele recebe automaticamente uma função chamada "Ticket King", com as permissões que você concedeu. Não exclua essa função.
2. **O bot envia uma mensagem de saudação no seu canal do sistema** (se as mensagens de sistema do Discord estiverem ativadas). Ela inclui um link direto para o seu painel.
3. **Seu servidor aparece no seu painel** em [ticketking.xyz/dashboard](https://ticketking.xyz/dashboard) em poucos segundos.

## Problemas comuns

{% hint style="danger" %}
**A função do bot está abaixo da função da minha equipe de suporte.** O Ticket King só pode modificar funções *abaixo* da própria função na lista de funções. Se sua equipe de suporte tiver uma função acima do Ticket King, o bot não conseguirá adicioná-la aos canais de ticket.

**Como resolver:** Arraste a função "Ticket King" para cima da função da sua equipe de suporte em **Configurações do servidor → Funções**.
{% endhint %}

{% hint style="warning" %}
**O bot entrou, mas nunca publicou no canal do sistema.** Ou as mensagens de sistema do seu servidor estão desativadas, ou o canal não permite que o Ticket King envie mensagens. De qualquer forma, o bot está no servidor. Abra seu painel em [ticketking.xyz/dashboard](https://ticketking.xyz/dashboard) para continuar.
{% endhint %}


---

# 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://ticketking.xyz/docs/pt-br/primeiros-passos/invite-ticket-king.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.