> For the complete documentation index, see [llms.txt](https://docs.dydu.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dydu.ai/developpeurs/reference-api/gestion-des-utilisateurs-du-bms.md).

# Gestion des utilisateurs du BMS

Cette API permet de créer un compte utilisateur du BMS ou de modifier un compte existant. Elle ne fait pas partie de l'interface Swagger.

## Créer ou modifier un utilisateur

* **Adresse** : `https://<serveur>/servlet/accounts/update`, en remplaçant `<serveur>` par l'adresse de votre plateforme.
* **Méthode** : `GET` ou `POST`, avec les paramètres dans l'adresse ou dans le formulaire.
* **Authentification** : en-tête `Authorization` (voir [Authentification](https://docs.dydu.ai/developpeurs/reference-api/authentification)). Le compte utilisé doit être administrateur de chaque bot cité dans `rights` et `competencies`.

Si le login existe déjà, le compte correspondant est modifié. Sinon, un nouveau compte est créé.

<table><thead><tr><th width="150">Paramètre</th><th width="100">Obligatoire</th><th>Description</th></tr></thead><tbody><tr><td><code>login</code></td><td>Oui</td><td>Login du compte à créer ou à modifier. Un login est unique.</td></tr><tr><td><code>accountId</code></td><td>Non</td><td>Identifiant du compte. À renseigner uniquement pour modifier un compte existant.</td></tr><tr><td><code>firstName</code></td><td>Non</td><td>Prénom de l'utilisateur.</td></tr><tr><td><code>lastName</code></td><td>Non</td><td>Nom de l'utilisateur.</td></tr><tr><td><code>email</code></td><td>Non</td><td>Adresse mail de l'utilisateur.</td></tr><tr><td><code>password</code></td><td>Non</td><td>Mot de passe de l'utilisateur. Il doit respecter la politique de mot de passe de la plateforme : 16 caractères minimum, dont une majuscule, une minuscule, un chiffre et un caractère spécial.</td></tr><tr><td><code>language</code></td><td>Non</td><td>Langue de l'interface du BMS : « fr » ou « en » (les noms « French » et « English » sont aussi acceptés).</td></tr><tr><td><code>rights</code></td><td>Non</td><td>Droits de l'utilisateur par bot, au format JSON. Voir <a href="#droits-et-competences">Droits et compétences</a>.</td></tr><tr><td><code>competencies</code></td><td>Non</td><td>Compétences livechat de l'utilisateur par bot et par langue, au format JSON. Voir <a href="#droits-et-competences">Droits et compétences</a>.</td></tr></tbody></table>

### Droits et compétences

Les paramètres `rights` et `competencies` sont des objets JSON :

* la clé `type` indique comment appliquer les changements :
* `default` : ajoute les droits ou compétences indiqués, sans retirer les autres ;
* `merge` : remplace les droits ou compétences de l'utilisateur, et retire ceux qui ne sont pas indiqués ;
* chaque autre clé est l'identifiant d'un bot.

Pour `rights`, la valeur est le nom des groupes de droits, séparés par des virgules :

```
{
  "type": "default",
  "9fbd59f2-bf91-4aab-bee1-a36c2a3ebece": "Groupe1,Groupe2",
  "6ae11dd2-c322-4177-aab0-9c6754cf1bcd": "Writer"
}
```

Pour `competencies`, la valeur indique les compétences par langue, séparées par des virgules :

```
{
  "type": "default",
  "9fbd59f2-bf91-4aab-bee1-a36c2a3ebece": { "fr": "Competence1,Competence2", "en": "Competency1" }
}
```

Les droits et compétences disponibles dépendent du bot.

### Exemple

```
curl -X POST "https://<serveur>/servlet/accounts/update" \
  -H "Authorization: Basic ZGVtb0BkeWR1LmFpOk15UGFzc3dvcmQ=" \
  --data-urlencode "login=jean.dupont@exemple.fr" \
  --data-urlencode "firstName=Jean" \
  --data-urlencode "lastName=Dupont" \
  --data-urlencode "language=fr" \
  --data-urlencode 'rights={"type":"default","9fbd59f2-bf91-4aab-bee1-a36c2a3ebece":"Writer"}'
```

Réponse :

```
{"status":"success","updatedAccount":{...}}
```

En cas d'erreur, l'API renvoie le code 400, ou 401 avec le message « Invalid authentication » si l'authentification est refusée.
