Sibmail est un plugin dédié à l’interaction transactionnelle entre Biodiv et Brevo. Autrement dit, ce plugin permet d’intercepter des événements se produisant sur le site Biodiv pour déclencher des événements au sein de Brevo. La réaction que Brevo aura à la réception de l’événement dépendra de la manière dont vous aurez paramétré Brevo.
Gestion des utilisateurs SPIP
Sibmail permet d’intercepter la création et la modification d’un utilisateur SPIP. Cette fonction est particulièrement utile pour maintenir à jour des listes de contacts dans Brevo. Si elle activée, cette fonction va transmettre à Brevo :
- l’email de l’utilsateur
- le pseudo qu’il a donné pour l’identifier sous SPIP
- le profil SPIP de l’utilisateur (visiteur, rédacteur, administrateur, webmestre)
- des références de listes de contacts dans lesquelles Brevo devra inscrire cette personne
Brevo va alors créer (ou mettre à jour) les données d’un contact, et lier ce contact à une ou plusieurs listes. Voir le paramétrage du plugin pour plus d’informations.
Envoi d’événements
Sibmail propose une fonction qui envoie à Brevo un événement portant les informations suivantes :
- email de l’utilisateur auquel associer l’événement
- nom et identifiant de l’événement
- des informations à mettre à jour dans le contact identifié par l’email (optionnel)
- des détails sur l’événement (optionnel)
L’intérêt de cette fonction est d’être appelée par Biodiv quand des événements particuliers se produisent : Biodiv détecte la présence ou non du plugin Sibmail et son activation ; il appelle alors la fonction d’envoi d’événement vers Brevo dans les cas suivants :
| circonstances Biodiv | événement Brevo | identifiant | détails du contact | détails de l’événement | |
|---|---|---|---|---|---|
| création d’une observation | creerObservation | id_observation | observateur | pseudo et statut SPIP | attributs de l’observation |
| commentaire sur une observation | commenter | id_observation | intervenant [1] | pseudo SPIP | auteur du commentaire, référence de l’observation |
| lien avec une observation | lierObservation | id_observation + id_objet_lié | observateur | pseudo SPIP | opérateur, nb de liens [2] |
Notes:
[1] Un événement est envoyé à l’auteur et à chaque intervenant de la conversation
[2] L’opérateur est celui qui a créé le lien. Le nombre de liens est compté entre l’objet lié et les observations quelles qu’elles soient. Aucun événement n’est envoyé à l’observateur s’il est aussi l’opérateur.
