> 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 a usuarios invitados externos
### Descripción
Este runbook invita a un usuario externo como usuario invitado en Microsoft Entra ID. Las propiedades opcionales del perfil, como nombre, apellido, nombre de la empresa, ubicación de uso, responsable y patrocinador, se pueden establecer después de que se acepte la invitación. Opcionalmente, el usuario invitado puede agregarse a un grupo especificado.
### Ubicación
Organización → General → Invitar a 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 | RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)
|
| Programable | no |
### Notas
Casos de uso comunes:
* Invitación básica para invitado: proporcione solo la dirección de correo electrónico y el nombre para mostrar; todos los parámetros de perfil y de grupo pueden dejarse en blanco
* Incorporación completa: proporcione todos los campos opcionales para establecer las propiedades del perfil, asignar un responsable/patrocinador y agregar 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 evita por completo la llamada PATCH
* La asignación de responsable y patrocinador y la pertenencia al grupo requieren cada una sus parámetros respectivos; todo se omite silenciosamente cuando no se proporciona
### Permisos
#### Permisos de aplicación
* **Tipo**: Microsoft Graph
* User.ReadWrite.All
* *Crea la invitación, aplica PATCH a las propiedades del perfil del invitado y establece el responsable 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 de redirección predeterminada de la invitación*
### Parámetros
#### Correo electrónico del usuario invitado
Dirección de correo electrónico del usuario invitado a invitar.
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | true |
| Valor predeterminado | |
| Tipo | Cadena |
#### Nombre para mostrar del usuario invitado
Nombre para mostrar del usuario invitado.
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
#### Id. del grupo
El ID de objeto del grupo al que agregar el usuario invitado. Si no se especifica, el usuario no se agregará a ningún grupo.
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
#### Nombre
Nombre de pila (nombre) del usuario invitado.
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
#### Apellido
Apellido (apellido) del usuario invitado.
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
#### Nombre de la empresa
Nombre de la empresa del usuario invitado.
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
#### Nombre del responsable
Responsable que se asignará al usuario invitado. Seleccione un usuario del directorio.
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
#### Nombre del patrocinador
Patrocinador que se asignará al usuario invitado. Seleccione un usuario del directorio.
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
#### Personalizar invitación
Habilítelo para personalizar el mensaje de invitación y la URL de redirección.
| Propiedad | Valor |
| -------------------- | -------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
#### Mensaje de invitación
Cuerpo del mensaje personalizado que se incluirá en el correo electrónico de invitación. Solo se usa cuando está habilitada la personalización de la invitación.
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
#### URL de redirección de la invitación
URL personalizada a la que se redirige al usuario después de aceptar la invitación. Solo se usa cuando está habilitada la personalización de la invitación.
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
#### Ubicación de uso
Código de país alfa-2 ISO 3166-1 para la ubicación de uso del usuario invitado (por ejemplo, "US", "DE").
| Propiedad | Valor |
| -------------------- | ------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
[Volver a la vista general de la 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 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://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/org/general/invite-external-guest-users.md?ask=&goal=
```
`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.