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.
- 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.
/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 |
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 }'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) :
{
"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.