Skip to content

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.

GuideAdministratorDeveloper
Required access
Droit apps.update (profil Infra) ou Propriétaire
Duration
5 min

This page has not been translated yet and is shown in French.

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.

Régler les invitations dans la console

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.

PUT/api/config/apps/{wid}
ChampValeursPar défaut
invitationExpiryDaysde 1 à 365 jours10
invitationPerUserLimitde 1 à 10 000 invitations par auteur sur 30 jours, ou null pour ne pas limiternull
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 }'
TypeScript
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.

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