Inviter des personnes¶

Avec une invitation, vous ajoutez quelqu'un à votre organisation, avec les rôles, groupes et attributs que vous voulez lui donner tout de suite. Cette page s'adresse aux administrateurs : ceux qui ont les droits d'administrateur ou d'administrateur des personnes dans l'organisation. La façon dont la personne invitée accepte l'invitation figure dans Accepter une invitation.

Inviter quelqu'un¶

Choisissez l'adresse e-mail de la personne.
Choisissez les rôles, groupes et valeurs d'attribut que la personne reçoit. Vous ne pouvez donner que ce que vous avez vous-même ; sinon OS refuse l'invitation (pourquoi).
Envoyez l'invitation. La personne invitée reçoit un lien.

L'e-mail indique à la personne invitée la suite : choisir un mot de passe (pour une adresse sans compte), se connecter, ou se connecter avec son compte professionnel. Lequel, vous ne le voyez pas en tant qu'administrateur : une invitation a toujours le même aspect pour vous.

Le lien est valable jusqu'à l'expiration de l'invitation (sept jours par défaut). Seule la personne invitée peut l'utiliser, connectée avec exactement cette adresse. Un lien transféré ne donne accès à personne d'autre. À l'acceptation, OS vérifie de nouveau que vous pouvez encore donner les rôles, groupes et valeurs choisis ; si vous avez perdu ces droits entre-temps, l'invitation est invalide et vous invitez à nouveau.

Inviter beaucoup de personnes à la fois¶

Sur la page Membres, Importer des membres ouvre deux façons d'inviter beaucoup de personnes d'un coup. Chacune reçoit sa propre invitation par e-mail et saisit elle-même son nom en acceptant.

Coller une liste. Collez une adresse e-mail par ligne, brute ou après un nom comme un logiciel de messagerie les copie ("Jean Dupont" <jean@exemple.fr>) ; le nom n'est pas utilisé. Au-dessus, choisissez les groupes, les rôles et la portée que tous reçoivent. Une ligne sans adresse valide fait refuser toute la liste.
Fichier CSV. Un fichier avec une colonne e-mail et, au choix, groupes et rôles avec les noms tels qu'ils figurent sous Groupes et Rôles (plusieurs séparés par une virgule), pour que chacun reçoive les siens. Téléchargez le fichier d'exemple pour voir comment faire ; enregistrez d'abord un fichier Excel au format CSV. Le fichier reste dans votre navigateur et n'est pas envoyé à OS. Jusqu'à 500 personnes par fichier, 1 Mo au maximum. Les lignes qui posent problème (pas d'adresse valide, une adresse déjà sur une ligne précédente, un groupe ou un rôle qui n'existe pas) sont ignorées ; vous pouvez les télécharger avec la raison, les corriger et les importer à nouveau.

La page envoie les invitations par paquets de 25. Gardez-la ouverte jusqu'à la fin : si vous la fermez, l'envoi s'arrête, et les personnes déjà invitées gardent leur invitation. Vous voyez ensuite pour chaque personne si l'invitation est partie et, sinon, pourquoi : les mêmes raisons que pour une invitation, ci-dessous. Réessayez les échecs d'un bouton et téléchargez le résultat en CSV.

Voir et retirer les invitations en attente¶

Vous voyez les invitations qui n'ont pas encore été acceptées. Vous retirez une invitation en attente ; le lien ne fonctionne alors plus. Une invitation acceptée ne se retire pas : la personne est alors membre, et vous désactivez ou supprimez le membre.

Inviter à nouveau quelqu'un après une suppression crée une nouvelle adhésion qui part de rien.

Quand OS refuse¶

403 : vous donnez un rôle, un groupe ou une valeur que vous n'avez pas vous-même ; le message indique lequel.
409 : l'invitation ferait utiliser à votre organisation, ou à une organisation située en dessous, plus de 32 attributs et étiquettes, ou un rôle avec la portée descendants donnerait à une organisation en dessous plus de 500 règles dans les fonctions d'IA. Cela peut arriver à l'envoi et à l'acceptation. Donnez moins, donnez le rôle avec la portée organisation, ou demandez à votre opérateur.
422 : un rôle, un groupe ou un attribut qui n'existe pas, ou une valeur que l'attribut n'autorise pas.

Via l'API¶

POST /api/v1/organisations/{id}/invitations avec email et, au choix, roles (chacun {"role": ..., "reach": ...}, voir Gérer les rôles), groups (identifiants de groupes) et attributes (chacun {"attribute": ..., "value": ...}, voir Gérer les attributs).
POST /api/v1/organisations/{id}/invitations/batch avec invitations, une liste de 1 à 100 invitations de la même forme. La réponse donne un résultat par invitation, dans le même ordre : sent avec l'invitation, ou refused avec la raison ; un refus ne bloque pas les autres. Une ligne mal formée (une adresse de plus de 320 caractères, plus de 32 groupes ou rôles) fait refuser toute la requête avec 422 avant tout envoi. Après une 500, les lignes précédentes peuvent déjà être invitées ; les renvoyer répond 409, déjà invitée.
GET /api/v1/organisations/{id}/invitations affiche les invitations en attente.
DELETE /api/v1/organisations/{id}/invitations/{invitation_id} en retire une.