# Configurer les invitations

> Activer les invitations, la vérification des adresses, la notification de l'auteur, l'URL d'acceptation, la durée de validité et la limite par auteur.

Les réglages des invitations sont portés par l'application : ils s'appliquent à tous ses réseaux et à tous ses clients. Réglez-les une fois avant d'envoyer vos premières invitations.

## Avant de commencer

- Vous avez le droit `apps.update` (le profil client **Infra** le porte) ou le niveau Propriétaire.
- Votre application a une page qui reçoit le lien d'invitation, par exemple `https://mon-app.exemple.fr/invitation/{token}`. Voir [Intégrer l'acceptation d'une invitation](/v1.0/utilisateurs/integrer-l-acceptation-d-une-invitation).

## Régler les invitations dans la console

::::steps
### Ouvrir l'onglet

Dans le menu latéral, sous le nom de votre application, cliquez sur **Paramétrage**, puis ouvrez l'onglet **Invitations**.

Résultat : la carte **Configuration des Invitations** s'affiche.

### Activer les invitations

Cochez **Activer les invitations**. Tant que la case est décochée, toute nouvelle invitation est refusée.

Résultat : le message « Enregistré » confirme l'enregistrement, immédiat à chaque clic.

### Choisir les contrôles

- Cochez **Vérification email obligatoire** pour refuser les adresses invalides ou jetables avant l'envoi. Activée par défaut.
- Cochez **Notification à l'inviteur** pour prévenir l'auteur par e-mail quand une invitation est acceptée. Désactivée par défaut.

### Indiquer l'URL d'acceptation

Dans **URL d'acceptation des invitations**, saisissez l'adresse de votre page d'acceptation, avec le marqueur `{token}` à l'endroit du jeton, par exemple `https://mon-app.exemple.fr/invitation/{token}`. L'URL commence par `http://` ou `https://` et fait 500 caractères au plus. Cliquez sur l'icône d'enregistrement à droite du champ.

Sans marqueur `{token}`, la console vous avertit : le jeton sera ajouté en paramètre `?token=`.
::::

## Régler la durée de validité et la limite par auteur

La durée de validité des invitations et la limite par auteur se règlent par l'API publique, sur l'application.

::endpoint{method="PUT" path="/api/config/apps/{wid}"}

| Champ | Valeurs | Par défaut |
|---|---|---|
| `invitationExpiryDays` | de 1 à 365 jours | 10 |
| `invitationPerUserLimit` | de 1 à 10 000 invitations par auteur sur 30 jours, ou `null` pour ne pas limiter | `null` |

```bash
curl -X PUT "https://api.wakastart.app/api/config/apps/aB3dE9" \
  -H "Authorization: Bearer $WAKASTART_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "invitationExpiryDays": 7, "invitationPerUserLimit": 100 }'
```

```ts
await fetch("https://api.wakastart.app/api/config/apps/aB3dE9", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.WAKASTART_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ invitationExpiryDays: 7, invitationPerUserLimit: 100 }),
});
```

Réponse attendue (extrait) :

```json
{
  "wid": "aB3dE9",
  "invitationsEnabled": true,
  "invitationExpiryDays": 7,
  "invitationPerUserLimit": 100,
  "invitationVerifyEmail": true,
  "invitationNotifyInviter": false,
  "acceptInvitationUrl": "https://mon-app.exemple.fr/invitation/{token}"
}
```

Le droit `apps.update` est requis. Les invitations envoyées par une clé API technique ne sont pas comptées dans la limite par auteur.

:::tip
Pour envoyer les e-mails d'invitation depuis votre propre compte d'envoi, avec votre adresse d'expéditeur, configurez la carte **Compte d'envoi Brevo** du même onglet : voir [E-mails](/v1.0/emails).
:::

## Vérifier le résultat

Lisez l'application avec `GET /api/config/apps/aB3dE9` : les champs `invitationsEnabled`, `invitationVerifyEmail`, `invitationNotifyInviter`, `acceptInvitationUrl`, `invitationExpiryDays` et `invitationPerUserLimit` portent vos valeurs. Envoyez-vous ensuite une invitation de test : le lien de l'e-mail pointe vers votre page.

## Voir aussi

- [Cycle de vie d'une invitation](/v1.0/utilisateurs/cycle-de-vie-d-une-invitation)
- [Inviter un utilisateur](/v1.0/utilisateurs/inviter-un-utilisateur)
