# Tokens especiais de alocação de pessoas

Os tokens especiais podem ser retornados por campos de formulário, regras de negócio ou integrações, e identificam um usuário ou conjunto de usuários e a serem definidos como responsáveis por uma tarefa.

| Token                                                                  | Descrição                         | Exemplo de uso                  |
| ---------------------------------------------------------------------- | --------------------------------- | ------------------------------- |
| **{PositionTeam.\[código padrão da função].\[código padrão do time]}** | Todas as pessoas do time e função | {PositionTeam.\[diretor].\[rh]} |
| **{Position.\[código padrão da função]}**                              | Todas as pessoas da função        | {Position.\[diretor]}           |
| **{Team.\[código padrão do time]}**                                    | Todas as pessoas do time          | {Team.\[rh]}                    |
| **{Group.\[código padrão do grupo]}**                                  | Todas as pessoas do grupo         | {Group.\[admin]}                |

{% hint style="warning" %}
Para realizar esta configuração, substitua o código do time, função ou grupo por seu código original / integração, disponível no módulo "Acesso" de Administração.
{% endhint %}

Um exemplo: vamos utilizar um campo com valor pré-definido para acionar um time como responsável por uma tarefa. Para inserir o token do RH do contexto, é preciso buscar qual o seu código:

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

E então inseri-lo como valor pré-definido em um campo, ou onde desejar utilizar este token.

<figure><img src="/files/5Is0jzkv3jE2tg0kGuLc" alt=""><figcaption></figcaption></figure>

Agora basta indicar este campo, do valor pré-definido, como o campo que retornará o responsável pela tarefa desejada.

{% hint style="danger" %}
ATENÇÃO: ao copiar um token diretamente do manual, a informação é copiada exatamente com os mesmos estilos e configurações do conteúdo copiado. Como, para destacar os tokens, utilizamos o negrito, ao colar esta informação em um editor de texto HTML (como o "Corpo da mensagem" do **Evento de mensagem**), a informação é inserida com o mesmo conteúdo (html) copiado.\
Assim, utilizar **CTRL + C > CTRL + V** deixará o token não funcional.

Por isso temos 2 alternativas:

1. Utilizar o atalho **Ctrl + Shift + V** ao colar os tokens no campo "Corpo da mensagem" ou editores HTML, garantindo que apenas o texto sem formatação seja inserido.
2. Utilizar o **seletor de tokens** disponível no canto superior direito aos campos nos quais os tokens estão disponíveis, facilitando a inserção correta dos tokens.
   {% endhint %}

### Tokens legados (são suportados para fins de compatibilidade, mas não devem ser utilizados para novas configurações)

<table><thead><tr><th width="242">Token</th><th width="306">Descrição</th><th>Exemplo de uso</th></tr></thead><tbody><tr><td>SH1</td><td>Superior imediato do solicitante</td><td>SH1</td></tr><tr><td>AP[id do time];[id da função]</td><td>Todas as pessoas do time e função</td><td>AP345;245</td></tr></tbody></table>


---

# 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://kb.stoque.com.br/zeev/outras-configuracoes-avancadas/dicionario-de-tokens-de-variaveis/tokens-especiais-de-alocacao-de-pessoas.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.
