Documentation

Courrier / Brevo (e-mails de l’association)

Chaque association configure son propre envoi SMTP (Brevo recommandé) depuis Compte → Courrier / Brevo.

Sans configuration activée, les e-mails métier de l’association ne partent pas (messagerie, cotisations, billets, convocations, votes, accès portail / Relais, etc.).

La configuration serveur `mail.config.local.php` reste réservée à la plateforme (mot de passe oublié, codes 2FA).

Prérequis côté Brevo

1. Compte Brevo (ex-Sendinblue).
2. Domaine ou adresse expéditeur vérifiés (Brevo → Senders, domains & dedicated IPs).
3. Clé SMTP : Brevo → SMTP & API → générer une clé SMTP (identifiant + mot de passe).

Valeurs SMTP habituelles :

Configuration dans asso-services

1. Menu latéral → Compte → Courrier / Brevo (administrateur d’association).
2. Cochez Activer l’envoi SMTP.
3. Renseignez l’adresse from (doit être autorisée dans Brevo) et le nom affiché.
4. Saisissez hôte, port, identifiant et clé SMTP.
5. Enregistrer, puis Tester l’envoi (un message part vers votre adresse de compte).

Astuce : laissez le mot de passe vide à l’enregistrement pour conserver la clé déjà enregistrée.

SMS (codes du portail bénéficiaires)

Optionnel et indépendant de l’e-mail. Sans SMS configuré, le portail ne propose pas l’envoi d’un code par SMS.

Via Brevo

1. Dans Brevo, générez une clé API (SMTP & API) — ce n’est pas la clé SMTP.
2. Déclarez un nom d’expéditeur SMS (France : 3 à 11 lettres ou chiffres, sans espace).
3. Dans Courrier / Brevo : cochez Activer l’envoi de SMS via Brevo, saisissez l’expéditeur et la clé API, Enregistrer.

Via milserv (si autorisé par la plateforme)

Un administrateur plateforme doit d’abord autoriser l’association (Gestion des associations → SMS milserv). Ensuite, dans Courrier / Brevo :

1. Cochez Activer l’envoi de SMS via milserv.
2. Saisissez l’URL d’envoi (endpoint POST, ex. `https://…/smsone/api/send.php`) et la clé API milserv (`mls…`, copiée depuis milserv → Applications).
3. Choisissez le mode prioritaire (Brevo ou milserv).

L’envoi utilise l’en-tête `X-Api-Key` (en plus de `Authorization`), car Apache n’envoie souvent pas `Authorization` à PHP : une clé pourtant correcte était alors refusée. Une liste d’IP vide côté milserv autorise toutes les adresses.

Si les deux modes sont paramétrés, l’application tente d’abord le mode prioritaire, puis l’autre en cas d’échec. Un mode non paramétré n’est jamais utilisé. Si les deux échouent, un message d’erreur s’affiche.

Tester l’envoi SMS : indiquez un numéro de test (ex. `06 12 34 56 78`).

Le code est envoyé au téléphone de la fiche bénéficiaire.

En cas d’échec

• Vérifiez que l’adresse from est bien validée dans Brevo.
• Contrôlez identifiant / clé SMTP (pas la clé API).
• Pour le SMS : l’e-mail Brevo ne suffit pas. Il faut acheter des crédits SMS (Brevo → compte → Mon offre → crédits SMS). Sans cela, le test indique que l’option SMS n’est pas trouvée sur l’organisation.
• Le message d’erreur métier indique en général : Compte → Courrier / Brevo.