Invitar a personas¶

Con una invitación añades a alguien a tu organización, con los roles, grupos y atributos que quieres darle desde el primer momento. Esta página es para administradores: quienes tienen los derechos de administrador o de administrador de personas en la organización. Cómo acepta la invitación la persona invitada está en Aceptar una invitación.

Invitar a alguien¶

1. Elige el correo electrónico de la persona.
2. Elige los roles, grupos y valores de atributos que recibirá la persona. Solo puedes dar lo que tú mismo tienes; de lo contrario OS rechaza la invitación (por qué).
3. Envía la invitación. La persona invitada recibe un enlace.

El correo indica a la persona invitada qué viene después: elegir una contraseña (para una dirección sin cuenta), iniciar sesión o iniciar sesión con la cuenta de empresa. Cuál es, tú como administrador no lo ves: una invitación siempre tiene el mismo aspecto para ti.

El enlace es válido hasta que caduca la invitación (por defecto, siete días). Solo puede usarlo la persona invitada, con la sesión iniciada con exactamente esa dirección. Un enlace reenviado no da acceso a otra persona. Al aceptar, OS comprueba de nuevo si aún puedes dar los roles, grupos y valores elegidos; si entretanto pierdes esos derechos, la invitación no es válida y vuelves a invitar.

Invitar a muchas personas a la vez¶

En la página Miembros, Importar miembros abre dos formas de invitar a muchas personas de una vez. Cada una recibe su propia invitación por correo y escribe su nombre al aceptar.

• Pegar una lista. Pegue una dirección de correo por línea, simple o tras un nombre como la copia un programa de correo ("John Doe" <john@ejemplo.es>); el nombre no se usa. Encima, elija los grupos, roles y el alcance que reciben todos. Una línea sin dirección válida rechaza toda la lista.
• Archivo CSV. Un archivo con una columna correo y, opcionalmente, grupos y roles con los nombres como aparecen en Grupos y Roles (varios separados por coma), para que cada persona reciba los suyos. Descargue el archivo de ejemplo para ver cómo; guarde primero un archivo de Excel como CSV. El archivo se queda en su navegador y no se envía a OS. Hasta 500 personas por archivo, 1 MB como máximo. Las líneas con un problema (sin dirección válida, una dirección que ya está en una línea anterior, un grupo o rol que no existe) se omiten; puede descargarlas con el motivo, corregirlas e importarlas de nuevo.

La página envía las invitaciones en grupos de 25. Manténgala abierta hasta que termine: si la cierra, el envío se detiene, y quien ya tiene una invitación la conserva. Después ve para cada persona si la invitación salió y, si no, por qué: los mismos motivos que para una invitación, más abajo. Reintente las fallidas con un botón y descargue el resultado como CSV.

Ver y retirar las invitaciones pendientes¶

Ves las invitaciones que aún no se han aceptado. Una invitación pendiente se retira; el enlace deja entonces de funcionar. Una invitación aceptada no se retira: entonces la persona ya es miembro, y desactivas o eliminas al miembro.

Volver a invitar a alguien tras una eliminación crea una membresía nueva que empieza de cero.

Si OS rechaza¶

• 403: das un rol, grupo o valor que tú mismo no tienes; el mensaje dice cuál.
• 409: la invitación haría que tu organización, o una de las de debajo, usara más de 32 atributos y etiquetas, o un rol con alcance descendants daría a una organización inferior más de 500 reglas en las funciones de IA. Puede ocurrir al enviar y al aceptar. Da menos, da el rol con alcance organisation, o pregunta a tu operador.
• 422: un rol, grupo o atributo que no existe, o un valor que el atributo no permite.

Mediante la API¶

• POST /api/v1/organisations/{id}/invitations con email y, opcionalmente, roles (cada uno {"role": ..., "reach": ...}, consulta Administrar roles), groups (ids de grupos) y attributes (cada uno {"attribute": ..., "value": ...}, consulta Administrar atributos).
• POST /api/v1/organisations/{id}/invitations/batch con invitations, una lista de 1 a 100 invitaciones de la misma forma. La respuesta da un resultado por invitación, en el mismo orden: sent con la invitación, o refused con el motivo; una rechazada no detiene las demás. Una fila mal formada (una dirección de más de 320 caracteres, más de 32 grupos o roles) rechaza toda la petición con 422 antes de enviar nada. Tras un 500, las filas anteriores pueden estar ya invitadas; enviarlas de nuevo responde 409, ya invitada.
• GET /api/v1/organisations/{id}/invitations muestra las invitaciones pendientes.
• DELETE /api/v1/organisations/{id}/invitations/{invitation_id} retira una.