Cartes membres (contacts Secutix)

Utilisez le connecteur Secutix pour créer et mettre à jour des contacts Secutix, puis livrez une carte membre vers Apple Wallet et Google Wallet.

Le connecteur Secutix ne se limite pas aux billets d’événement. Il peut aussi synchroniser les contacts Secutix. Cela débloque un flux « carte de membre dans Wallet ». La carte représente le contact et reste synchronisée.

Ce que vous pouvez créer

Vous pouvez émettre une carte Wallet qui se comporte comme une carte d’adhésion :

• Une carte par membre (un contact Secutix).
• Code-barres / code QR pour l’identification sur site.
• Mises à jour automatiques lorsque les données du contact changent.
• Retour d’information facultatif sur l’installation/la désinstallation renvoyé à Secutix.

Secutix reste la source de vérité pour le profil du membre. Wallet Crew émet et distribue la carte.

Cas d’usage réels

Modèles qui fonctionnent bien en production :

• Renouvellement de l’adhésion sur site: scanner un code QR, mettre à jour le contact, actualiser la carte.
• Inscription en libre-service: les membres s’inscrivent depuis une page d’atterrissage de campagne.
• Inscription assistée par le personnel: les équipes du front-office utilisent un formulaire au lieu de l’interface Secutix.
• Collecte du consentement: stocker les critères d’adhésion volontaire dans Secutix pendant l’inscription.
• Messagerie segmentée: utiliser l’état d’installation pour cibler uniquement les membres installés.

Créer et mettre à jour des contacts à partir d’un formulaire d’inscription

Utiliser un Wallet Crew formulaire d’inscription pour :

• Créer un nouveau contact Secutix.
• Mettre à jour un contact Secutix existant.
• Livrer immédiatement la carte de membre à Apple Wallet / Google Wallet.

Cela fonctionne bien lorsque vous ne souhaitez pas exposer l’interface Secutix au personnel. Cela convient aussi aux flux d’inscription en libre-service.

Point d’entrée par code QR

Affichez un code QR qui ouvre le formulaire d’inscription sur un téléphone. C’est idéal pour l’acquisition sur site. Pensez au foyer, au guichet de billetterie ou aux stands partenaires.

Correspondance : compte Wallet Crew ↔ contact Secutix

Lorsque la synchronisation des contacts est activée, Wallet Crew associe les champs du compte à les champs du contact Secutix. Personnalisez la correspondance lorsque vous devez lire/écrire des critères Secutix spécifiques. C’est courant pour les consentements, les indicateurs de segmentation ou les champs hérités.

Ajoutez votre script de correspondance personnalisé dans la configuration Secutix onglet Avancé onglet.

Écran de configuration Secutix

Hook avancé de correspondance des contacts

Enregistrez extensions.secutix.contact.mapper.

• MapToSecutix(account, request) s’exécute avant lors de l’appel à Secutix.
• MapToNeostore(response, account) s’exécute après la réponse de Secutix.

/**
 * Applique une correspondance avancée des données de compte neostore vers une demande de contact Secutix.
 * La correspondance standard est déjà appliquée à l’objet request avant l’appel de cette fonction.
 *
 * @param {Object} account - Données provenant de neostore.
 * @param {Object} request - Demande envoyée à Secutix avec la correspondance par défaut déjà renseignée.
 */
function mapToSecutix(account, request){
  request.ExternalContactCriterionData = [{ CriterionIdCode : 'OPT_CO', Values : [account["consents_email"] ? 'true' : 'false'] }];
}

/**
 * Applique une correspondance avancée d’une réponse de contact Secutix vers un compte neostore.
 * La correspondance standard est déjà appliquée à l’objet account avant l’appel de cette fonction.
 *
 * @param {Object} response - Réponse reçue de Secutix.
 * @param {Object} account - Données envoyées à neostore avec la correspondance par défaut déjà renseignée.
 */
function mapToNeostore(response, account){
  response.ContactCriteria = response.ContactCriteria || [];
  account["consents_email"] = !!response.ContactCriteria.find(c => c.CriterionIdCode === 'OPT_CO' && c.Values != null && c.Values[0] === 'true');
}

export default function(context) {
  context.register('extensions.secutix.contact.mapper', {
    MapToSecutix : mapToSecutix,
    MapToNeostore: mapToNeostore
  });
}

Mise à jour de l’état d’installation sur le contact

Ce hook vous permet de conserver les signaux d’installation/désinstallation de la carte dans les critères de contact Secutix. Utilisez-le pour piloter la segmentation ou les rapports opérationnels dans Secutix.

Implémentez extensions.secutix.contact.passUpdater:

/**
 * Déclenché lorsque l’état d’installation d’une carte de membre change.
 *
 * @param {Object} request - Demande Secutix SaveIndividualContactRequest.
 * @param {boolean} isInstalled - `true` si la carte est installée, sinon `false`.
 * @param {number} device - Appareil sur lequel l’état d’installation a changé (0 = Apple, 2 = Google).
 * @returns {Promise<void>} Aucune valeur de retour ; modifie la requête sur place.
 */
async function onPassInstallationStatusChanged(request, isInstalled, device){
  request.ExternalContactCriterionData = [
    {
      CriterionIdCode : 'W_' + (device == 0 ? "APPLE" : "GOOGLE"),
      Values : [isInstalled ? 'Installé' : 'Désinstallé']
    }
  ];
}

export default function(context) {
  context.register('extensions.secutix.contact.passUpdater', {
    OnPassInstallationStatusChanged: onPassInstallationStatusChanged
  });
}