> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-references/user/mail/set-room-mailbox-configuration.md).

# Definir configuração da caixa de correio da sala

Configurar as regras de reserva e os delegados de reserva desta caixa de correio da sala

### Descrição

Define as regras de reserva desta caixa de correio de sala: quem pode reservá-la diretamente, quem precisa da aprovação de um delegado de reservas e como os pedidos são processados. Também define reuniões recorrentes, conflitos, a janela de reserva, a duração máxima da reunião e a capacidade. Todas as regras de reserva são escritas como mostrado. O grupo de reserva, os delegados de reserva e a capacidade só mudam quando é fornecido um valor.

### Modos de reserva

"Quem pode reservar a sala" e os campos apresentados com "Restricted" decidem o que acontece a um pedido de reunião:

* **Todos** - cada utilizador reserva a sala diretamente; o pedido é aceite quando a sala está livre.
* **Restrito com um grupo de reservas** - os membros do "Grupo de reservas" reservam diretamente. Os pedidos de todos os restantes são recusados.
* **Restrito com "Permitir que todos os outros peçam a sala?"** - os pedidos de utilizadores fora do grupo de reservas vão para os delegados de reservas, que os aprovam ou recusam. Deixe o "Grupo de reservas" vazio quando os delegados de reservas decidirem todos os pedidos. Isto é o mesmo que a opção "Selecionar delegados que podem aceitar ou recusar pedidos de reserva" no centro de administração do Exchange.

Os delegados de reservas recebem pedidos apenas com o processamento de pedidos "Auto accept". Com "Auto update", o Exchange marca os pedidos como provisórios e não envia nada aos delegados. O runbook avisa sobre ambos os casos e sobre uma execução que desativa uma aprovação de delegado existente.

### Delegados de reservas

* Um delegado de reservas aprova ou recusa pedidos da sala na sua própria caixa de correio. Não precisa de acesso total à caixa de correio da sala; o Exchange concede-lhe Enviar em nome por si só. Conceda acesso total com o runbook "Delegate Full Access" apenas quando alguém tiver de trabalhar na própria caixa de correio da sala.
* "Alteração do delegado de reservas" decide o que acontece com os utilizadores selecionados em "Delegados de reservas": Add mantém os delegados atuais e adiciona os selecionados, Replace torna os utilizadores selecionados os únicos delegados, Remove retira-os da lista. Sem utilizadores selecionados, os delegados permanecem como estão.
* Os utilizadores sem caixa de correio são ignorados com um aviso. Os delegados atuais cujo nome não resolve para exatamente um destinatário são mantidos inalterados.
* O runbook "Listar a configuração da caixa de correio de sala" mostra os delegados de reservas atuais, o grupo de reservas e as definições de pedidos de uma sala.

### Observações e limitações

* Cada execução escreve todas as regras de reserva como mostradas na caixa de diálogo. Assim, executar o runbook apenas para alterar a capacidade também repõe "Quem pode reservar a sala" para a opção selecionada.
* Um "Grupo de reservas" vazio mantém o grupo atual; o runbook não o pode limpar.
* As predefinições em todo o Tenant para as regras de reserva podem ser definidas como definições RealmJoin: `RoomMailbox.AllBookInPolicy`, `RoomMailbox.AllRequestInPolicy`, `RoomMailbox.AllowRecurringMeetings`, `RoomMailbox.AutomateProcessing`, `RoomMailbox.BookingWindowInDays`, `RoomMailbox.MaximumDurationInMinutes` e `RoomMailbox.AllowConflicts`. Um campo com uma definição é apresentado como só de leitura na caixa de diálogo. Consulte [Configurações](https://docs.realmjoin.com/automation/runbooks/runbook-customization#settings) no Guia de Personalização do Runbook.

### Localização

Utilizador → Correio → Definir configuração da caixa de correio de sala

**Nome completo do runbook**

rjgit-user\_mail\_set-room-mailbox-configuration

### Detalhes

| Propriedade         | Valor                                                                                                                           |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Versão              | 1.1.0                                                                                                                           |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| Agendável           | não                                                                                                                             |

### Permissões

#### Permissões de aplicativo

* **Tipo**Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *Lê a caixa de correio da sala, o seu processamento de calendário e os delegados de reservas (Get-EXOMailbox, Get-CalendarProcessing, Get-Recipient) e altera-os com Set-CalendarProcessing e Set-Place na sessão do Exchange Online apenas para a aplicação*
* **Tipo**: Microsoft Graph
  * Group.Read.All *(opcional — funcionalidade: grupo de política de reserva)*
    * *Valida o BookInPolicyGroup através de /groups/{id}*

#### Funções RBAC

* Administrador do Exchange
  * *Necessário para que a sessão do Exchange Online apenas para a aplicação altere as definições da caixa de correio de sala*

### Parâmetros

#### Nome de usuário

Nome principal de utilizador da caixa de correio da sala sobre a qual o runbook atua. Definido pelo portal a partir do utilizador selecionado.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | verdadeiro                                              |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### AllBookInPolicy

Todos permite que todos os utilizadores reservem a sala diretamente. Restrito permite que apenas o "Grupo de reservas" reserve diretamente; todos os outros são recusados ou, com "Permitir que todos os outros peçam a sala?", precisam da aprovação de um delegado de reservas.

| Propriedade                | Valor                     |
| -------------------------- | ------------------------- |
| Obrigatório                | falso                     |
| Valor padrão               | Verdadeiro                |
| Tipo                       | Booleano                  |
| Nome de exibição no portal | Quem pode reservar a sala |

**Opções do portal**

| Opção do portal | Valor      |
| --------------- | ---------- |
| Todos           | verdadeiro |
| Restrito        | falso      |

#### BookInPolicyGroup

Grupo de segurança com correio eletrónico cujos membros reservam a sala diretamente. Deixe vazio para manter o grupo atual, por exemplo quando apenas os delegados de reservas decidem.

| Propriedade  | Valor |
| ------------ | ----- |
| Obrigatório  | falso |
| Valor padrão |       |
| Tipo         | Texto |

#### AllRequestInPolicy

Os pedidos de utilizadores fora do "Grupo de reservas" vão para os delegados de reservas, que os aprovam ou recusam. Desative para recusar estes pedidos.

| Propriedade                | Valor                                      |
| -------------------------- | ------------------------------------------ |
| Obrigatório                | falso                                      |
| Valor padrão               | Falso                                      |
| Tipo                       | Booleano                                   |
| Nome de exibição no portal | Permitir que todos os outros peçam a sala? |

#### AllowRecurringMeetings

Desative para recusar pedidos de reuniões recorrentes; as reuniões únicas continuam a ser aceites.

| Propriedade                | Valor                          |
| -------------------------- | ------------------------------ |
| Obrigatório                | falso                          |
| Valor padrão               | Verdadeiro                     |
| Tipo                       | Booleano                       |
| Nome de exibição no portal | Permitir reuniões recorrentes? |

#### AutomateProcessing

Aceitação automática reserva a sala automaticamente ou envia o pedido aos delegados de reservas. Atualização automática apenas marca os pedidos como provisórios, e os delegados de reservas não recebem pedidos. Nenhum deixa os pedidos inalterados.

| Propriedade                | Valor                    |
| -------------------------- | ------------------------ |
| Obrigatório                | falso                    |
| Valor padrão               | AutoAccept               |
| Tipo                       | Texto                    |
| Nome de exibição no portal | Processamento de pedidos |

**Opções do portal**

| Opção do portal        | Valor      |
| ---------------------- | ---------- |
| Aceitação automática   | AutoAccept |
| Atualização automática | AutoUpdate |
| Nenhum                 | Nenhum     |

#### BookingWindowInDays

Os pedidos com antecedência superior a este número de dias são recusados.

| Propriedade                | Valor                    |
| -------------------------- | ------------------------ |
| Obrigatório                | falso                    |
| Valor padrão               | 180                      |
| Tipo                       | Int32                    |
| Nome de exibição no portal | Janela de reserva (dias) |

#### MaximumDurationInMinutes

A reunião mais longa que a sala aceita, em minutos.

| Propriedade                | Valor                    |
| -------------------------- | ------------------------ |
| Obrigatório                | falso                    |
| Valor padrão               | 1440                     |
| Tipo                       | Int32                    |
| Nome de exibição no portal | Duração máxima (minutos) |

#### AllowConflicts

Permite reservas sobrepostas em vez de as recusar.

| Propriedade                | Valor                          |
| -------------------------- | ------------------------------ |
| Obrigatório                | falso                          |
| Valor padrão               | Falso                          |
| Tipo                       | Booleano                       |
| Nome de exibição no portal | Permitir reservas em conflito? |

#### Capacidade

Número de lugares. Deixe em 0 para manter o valor atual.

| Propriedade                | Valor      |
| -------------------------- | ---------- |
| Obrigatório                | falso      |
| Valor padrão               | 0          |
| Tipo                       | Int32      |
| Nome de exibição no portal | Capacidade |

#### ResourceDelegates

Utilizadores que aprovam ou recusam os pedidos de reserva que precisam de aprovação. Não obtêm acesso à própria caixa de correio. Deixe vazio para manter os delegados de reservas atuais.

| Propriedade  | Valor     |
| ------------ | --------- |
| Obrigatório  | falso     |
| Valor padrão |           |
| Tipo         | String\[] |

#### DelegateAction

Adicionar coloca os utilizadores selecionados junto aos delegados de reservas atuais, Substituir torna-os os únicos delegados de reservas, Remover retira-os da lista.

| Propriedade                | Valor                             |
| -------------------------- | --------------------------------- |
| Obrigatório                | falso                             |
| Valor padrão               | Adicionar                         |
| Tipo                       | Texto                             |
| Nome de exibição no portal | Alteração do delegado de reservas |

**Opções do portal**

| Opção do portal                | Valor     |
| ------------------------------ | --------- |
| Adicionar aos delegados atuais | Adicionar |
| Substituir os delegados atuais | Substitua |
| Remover dos delegados atuais   | Remover   |

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-references.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-references/user/mail/set-room-mailbox-configuration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
