> 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/personalizacao-e-identidade-visual/custom-welcome-embeds.md).

# Embeds e mensagens de boas-vindas personalizados

Quando um membro abre um ticket, o Ticket King publica um **embed de abertura** como a primeira mensagem no novo canal. Você pode personalizar o que esse embed diz. Tanto o embed quanto a mensagem acima dele são **gratuito**.

## Dois lugares para configurá-lo

Você define a mensagem de abertura por opção de ticket, ou define um padrão para todo o painel que cada opção do painel herda.

| Camada                     | Campo                                                                                                                                               |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Padrão por painel**      | Padrões do painel, **Mensagem padrão do embed do ticket** (máx. 2048 caracteres) e **Conteúdo padrão da mensagem do ticket** (máx. 1024 caracteres) |
| **Substituição por opção** | Editor por opção, aba Mensagens, **Conteúdo personalizado do embed** (máx. 2048) e **Mensagem personalizada do ticket** (máx. 1024)                 |

Não existe uma configuração separada de embed de boas-vindas para todo o servidor. Se você não definir nenhum, o Ticket King publica a saudação localizada integrada.

## Mensagem do embed vs. conteúdo da mensagem

Dois campos separados controlam duas coisas separadas:

### Conteúdo personalizado do embed

Vai **dentro do embed** (o texto do corpo). Até **2048 caracteres**. Suporta texto rico, variáveis e emojis.

É isso que você normalmente vai personalizar. "Obrigado por abrir um ticket! Descreva seu problema em detalhes."

### Mensagem personalizada do ticket

Vai **acima do embed** como uma mensagem simples do Discord. Até **1024 caracteres**. Muitas vezes é usado para `@menção` pings, por exemplo, pingando o cargo de suporte com uma breve mensagem no topo do ticket.

Você pode usar ambos, apenas um ou nenhum.

## Variáveis

Ambos os campos suportam variáveis que são substituídas no momento em que o ticket é aberto:

| Variável          | Resolve para                                                                  |
| ----------------- | ----------------------------------------------------------------------------- |
| `{TICKET_NUMBER}` | O número do ticket                                                            |
| `{TYPE}`          | O rótulo da opção do painel                                                   |
| `{USER}`          | Menção ao autor do ticket                                                     |
| `{USER_ID}`       | O ID do Discord do autor do ticket                                            |
| `{USER_NAME}`     | O nome de exibição do autor do ticket                                         |
| `{GUILD_NAME}`    | O nome do seu servidor                                                        |
| `{CREATED_AT}`    | Carimbo de data e hora da criação do ticket                                   |
| `{STEAM_ID}`      | ID da Steam (somente quando o Steam Linking estiver ativado, o que é Premium) |

## Respostas do formulário no embed de boas-vindas

Quando a opção do painel tem um formulário (perguntas da opção), as respostas do membro são **adicionadas à descrição do embed** automaticamente. Você não precisa adicionar nenhuma variável para elas. As respostas aparecem no embed abaixo de qualquer Conteúdo do Embed que você tenha definido.

→ [O que são as perguntas da opção](/docs/pt-br/formularios/what-option-questions-are.md)

## Grátis em todos os planos

Ambos **Conteúdo personalizado do embed** e **Mensagem personalizada do ticket** são grátis para todo servidor, sem necessidade de Premium. Você pode configurá-los por opção e como um padrão para todo o painel.

## Melhores práticas

* **Mantenha curto.** Os membros estão prestes a falar com a equipe. Não esconda o próximo passo em um paredão de texto.
* **Defina expectativas.** "Um membro da equipe falará com você em breve" é bom. "Tenha seu número de pedido em mãos" é melhor.
* **Use perguntas de formulário para informações obrigatórias** em vez de perguntar no embed de boas-vindas.
* **Coloque os links da FAQ no painel, não no embed de boas-vindas.** Se você quiser que os membros leiam a FAQ primeiro, adicione um botão de link ao próprio painel.

## Relacionado

{% content-ref url="/pages/d8ffc7a86f2c6426bde04397e6a0e13402726fc6" %}
[O que são perguntas de opção](/docs/pt-br/formularios/what-option-questions-are.md)
{% endcontent-ref %}

{% content-ref url="/pages/8498fc70bd160d6d2ce1ad114af243e8d4336c69" %}
[Padrões para todo o painel](/docs/pt-br/paineis/panel-wide-defaults.md)
{% endcontent-ref %}

{% content-ref url="/pages/547509e9677fe19d613b65675bef85d8ef0ce6eb" %}
[Configurações por opção](/docs/pt-br/paineis/per-option-settings.md)
{% endcontent-ref %}


---

# 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/personalizacao-e-identidade-visual/custom-welcome-embeds.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.
