> 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/es/automatizacion/runbooks/runbook-references/org/general/invite-external-guest-users.md).

# Invitar usuarios invitados externos

Invitar a una persona externa como usuario invitado

### Descripción

Envía una invitación de invitado de Microsoft Entra ID a una dirección de correo externa. Opcionalmente, el invitado se agrega a un grupo, y detalles del perfil como nombre, empresa, ubicación de uso, administrador y patrocinador se establecen de inmediato en la cuenta del invitado. El correo de invitación y la página de destino se pueden personalizar.

### Casos de uso comunes

* Invitación básica de invitado: proporcione solo la dirección de correo y el nombre para mostrar; todos los parámetros de perfil y grupo pueden dejarse en blanco.
* Incorporación completa: proporcione todos los campos opcionales para establecer propiedades del perfil, asignar un administrador y un patrocinador, y agregar al invitado a un grupo en una sola ejecución.

### Interacciones de parámetros

* Las propiedades del perfil (`givenName`, `surname`, `companyName`, `usageLocation`) se aplican solo cuando no están vacías; omitirlas omite por completo la llamada de actualización.
* La asignación de administrador, la asignación de patrocinador y la pertenencia al grupo requieren cada una sus parámetros respectivos; todas se omiten silenciosamente cuando no se proporcionan.

### Ubicación

Organización → General → Invitar usuarios invitados externos

**Nombre completo del runbook**

rjgit-org\_general\_Invite-external-guest-users

### Detalles

| Propiedad          | Valor                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------- |
| Versión            | 2.0.3                                                                                    |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Programable        | no                                                                                       |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * User.ReadWrite.All
    * *Crea la invitación, aplica mediante parche las propiedades del perfil del invitado y establece el administrador y el patrocinador*
  * Group.ReadWrite.All
    * *Verifica el grupo de destino y agrega al invitado mediante /groups/{id}/members/$ref*
  * Organization.Read.All
    * *Lee el id del Tenant para construir la URL predeterminada de redirección de la invitación*

### Parámetros

#### InvitedUserEmail

Dirección de correo de la persona a invitar.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Requerido            | verdadero |
| Valor predeterminado |           |
| Tipo                 | Cadena    |

#### InvitedUserDisplayName

Nombre que se muestra para el invitado en el directorio.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### GroupId

Grupo al que se agrega el invitado. Preestablecido en la personalización del runbook; vacío significa ninguno.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### GivenName

Nombre de pila del invitado.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### Surname

Apellido del invitado.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### CompanyName

Empresa para la que trabaja el invitado.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### ManagerName

Usuario que se convierte en el administrador del invitado.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### SponsorName

Usuario registrado como patrocinador del invitado.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### CustomizeInvitation

Muestra campos para un mensaje de invitación propio y una URL de redirección.

| Propiedad            | Valor    |
| -------------------- | -------- |
| Requerido            | falso    |
| Valor predeterminado | Falso    |
| Tipo                 | Booleano |

#### InvitationMessage

Texto incluido en el correo de invitación.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### InviteRedirectUrl

Página a la que llega el invitado después de aceptar, por ejemplo un sitio de SharePoint.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### UsageLocation

Código de país de dos letras, por ejemplo US o DE, necesario antes de que se puedan asignar licencias.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | falso  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

[Volver a la vista general de referencia del runbook](/es/automatizacion/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/es/automatizacion/runbooks/runbook-references/org/general/invite-external-guest-users.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.