# Actito

Cette intégration connecte les scénarios Actito à Apple Wallet et Google Wallet via Wallet Crew.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-4f1763e9387ca1dd7a7bffecebe322a42f05af36%2Fillustration-connect-marketing-actito.png?alt=media" alt="Connect Actito to Apple &#x26; Google Wallet through The Wallet Crew"><figcaption></figcaption></figure>

Actito est l'endroit où vous segmentez, personnalisez et orchestrez les parcours clients. Wallet Crew transforme ces parcours en une carte Wallet qui reste visible et utile.

C'est plus qu« un canal de plus » à côté de l'e‑mail, du SMS et des push d'application. C'est une façon de mettre la bonne information dans la poche du client, exactement quand il le faut. Si vous cherchez comment connecter Apple Wallet et Google Wallet à Actito CRM, cette intégration est la réponse pratique.

Ceci devient essentiel pour la fidélité, l'adhésion, les cartes cadeaux et les offres.

{% hint style="info" %}
**Actito orchestre « qui/quand/quoi ».** Wallet Crew exécute tout côté wallet : **création de carte, mises à jour, notifications et animations**.
{% endhint %}

### Ce que vous débloquez

* **Un point de contact persistant.** La carte vit dans Apple Wallet ou Google Wallet.
* **Utilité en temps réel.** Mettez à jour la carte lorsque la situation du client change.
* **Moins de friction.** Aucune installation d'application requise pour délivrer de la valeur.
* **Meilleure orchestration.** Utilisez les scénarios Actito pour automatiser les moments wallet.
* **Ciblage renforcé.** Alimentez Actito avec les événements wallet pour un meilleur timing.

<details>

<summary><strong>Exemples concrets</strong></summary>

* **Fidélité retail**: après achat, mettez à jour les points et le niveau sur la carte. Puis notifiez lorsque une récompense est débloquée.
* **Adhésion**: quand le statut change (actif, en pause, renouvelé), actualisez la carte instantanément. N'utilisez une notification que pour les moments clés.
* **Offres**: ajoutez un nouveau coupon ou avantage à la carte. Notifiez proche de l'expiration pour favoriser la rédemption.
* **Événements**: poussez des changements de dernière minute (horaire, lieu, porte). Réduisez les absences avec des rappels le jour même.

</details>

Grâce à nos [connecteurs](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect) et **fournisseur de données multi‑cartes** architecture, vous pouvez orchestrer des scénarios wallet depuis Actito et bénéficier néanmoins d'autres fournisseurs de données de carte. Cela vous donne le meilleur des deux mondes. Wallet Crew peut afficher des informations de tous les systèmes ([Cegid](https://docs.thewalletcrew.io/fr/connecter/pos/cegid), [Secutix](https://docs.thewalletcrew.io/fr/connecter/ticketing/secutix), etc) sur la même carte et les fusionner, sans problèmes de synchronisation.

## Ce que fait cette intégration

Connectez Actito à Wallet Crew afin que vous puissiez :

1. **Mettre à jour les cartes depuis les scénarios Actito** (actions personnalisées Journey Builder).\
   Maintenez les points de fidélité, le niveau, les coupons, le solde ou les informations magasin à jour.
2. **Déclencher des notifications wallet (push/messages) pour une carte donnée** depuis les scénarios Actito.\
   Incitez au bon moment sans vous fier uniquement aux taux d'ouverture des e‑mails.
3. **Synchroniser les modifications de profil Actito dans Wallet Crew** (webhooks).\
   Maintenez le contenu de la carte aligné avec le consentement, les préférences et les données de profil.
4. **Synchroniser les événements Wallet Crew vers Actito** (webhooks).\
   Suivez des événements tels que la création de client et le statut d'installation de la carte.

## Utilisation

### Envoyer une notification push

Utilisez le `neostore envoyer un message` activité personnalisée à l'intérieur d'un scénario Actito.

Elle envoie un message wallet de type push à la carte du client. Sur Apple Wallet, il apparaît sur l'écran de verrouillage. Sur Google Wallet, il est affiché sur la carte.

Pour plus de détails sur les notifications wallet, voir [Notifications push](https://docs.thewalletcrew.io/fr/engager-et-animer/push-notification).

Utilisez‑le pour des moments sensibles au temps. Gardez‑le rare.

<details>

<summary><strong>Exemples concrets</strong></summary>

* **Fidélité retail**: « Vous avez débloqué une récompense. » Mettez à jour les points/niveau. Puis notifiez.
* **Expiration d'offre**: « Votre coupon expire ce soir. » Écrivez le coupon sur la carte. Puis notifiez.
* **Click & collect**: « Votre commande est prête. » Affichez les informations de retrait sur la carte. Puis notifiez.
* **Adhésion**: « Renouvellement dans 3 jours. » Mettez à jour l'expiration et le statut. Ne notifiez que si nécessaire.

</details>

### Nouvelle synchronisation de profil & mise à jour de profil

Lorsqu'un profil Actito est créé ou mis à jour, le connecteur actualise automatiquement la carte wallet du client.

Cela maintient la carte alignée avec les dernières données de profil, sans créer de branches « mettre à jour la carte » supplémentaires dans chaque scénario.

{% hint style="info" %}
C'est une fonctionnalité clé. Si la carte est connectée à plusieurs fournisseurs de données (Cegid, Comarch, …), un changement de profil dans Actito déclenche une actualisation qui réconcilie les données de **tous** les fournisseurs.
{% endhint %}

<details>

<summary><strong>Exemples concrets</strong></summary>

* **Hygiène des données**: le client corrige son nom ou son e‑mail dans votre centre de préférences. La carte se met à jour lors de la prochaine actualisation.
* **Préférence de magasin**: le client change son magasin préféré. La carte se met à jour pour afficher la bonne adresse du magasin et le lien vers la carte.
* **Fidélité multi‑système**: les modifications du profil Actito (segment, libellé de niveau, attributs personnalisés) actualisent la carte tandis que les points proviennent toujours de votre fournisseur de fidélité.

</details>

### Synchronisation du statut d'installation du wallet

Lorsqu'un client installe ou désinstalle une carte, le connecteur synchronise ce statut vers Actito.

Actito stocke cela dans la `neostore_wallets` table. Utilisez‑la comme signal déterministe pour la segmentation et le branchement des scénarios.

Vous pouvez aussi réagir aux événements d'installation/désinstallation pour déclencher des suivis ou des récompenses.

<details>

<summary><strong>Exemples concrets</strong></summary>

* **Branchement de scénario**: si la carte est installée, envoyez une notification wallet. Sinon, envoyez un e‑mail/SMS avec un lien « Ajouter au Wallet ».&#x20;
* **Rappel d'intégration**: si la carte n'est pas installée après 24 heures, envoyez un rappel.
* **Suppression**: arrêtez les messages « ajouter au wallet » une fois la carte installée.
* **Récompense à l'installation**: lorsque la carte est installée, accordez +10 points de fidélité ou débloquez un avantage de bienvenue.
* **Relance**: lorsqu'une carte est désinstallée, déclenchez un léger flux de réactivation avec un nouveau lien.

</details>

### Fournisseur de données de carte

Utilisez Actito comme source de données pour votre carte.

Cela permet à Wallet Crew d'afficher des attributs de profil Actito sur la carte, comme le prénom, le nom, le libellé de niveau, ou tout champ personnalisé que vous stockez dans Actito.

<details>

<summary><strong>Exemples concrets</strong></summary>

* **Fidélité**: affichez le libellé de niveau du client provenant de la segmentation Actito.
* **Adhésion**: affichez le nom et le statut du membre, synchronisés depuis le profil Actito.
* **Personnalisation**: montrez un magasin préféré, la langue, ou un champ « meilleure offre suivante » maintenu dans Actito.

</details>

<details>

<summary>Configuration avancée</summary>

Utilisez le `extensions.actito.profile.mapper` point de terminaison d'extensibilité pour contrôler quelles attributs Actito sont lus et comment ils sont mappés dans l'objet account de Wallet Crew.

Par défaut, le connecteur mappe `firstName` et `lastName`.

```javascript
/**
 * Mappage par défaut amélioré du profil Actito vers Wallet Crew
 *
 * @param {Object} data - Attributs provenant d'Actito
 * @param {Object} account - L'objet account de Wallet Crew à remplir (muté sur place)
 */
function mapFromActito(data, account) {
  // Exemple montrant le mappage par défaut
  if(data["firstName"]) {
    account["firstName"] = data["firstName"];
  }
  if(data["lastName"]) {
    account["lastName"] = data["lastName"];
  }
}

export default function (context) {
  context.register('extensions.actito.profile.mapper', {
    MapFromActitoProfiles: mapFromActito
  });
}
```

</details>

## Configuration

### La configuration Wallet Crew

{% stepper %}
{% step %}

#### Activer le connecteur

Demandez à l'équipe Wallet Crew d'activer le connecteur Actito pour votre environnement.
{% endstep %}

{% step %}
**Configurer les paramètres généraux**

Ouvrez les paramètres du connecteur Actito dans le back‑office Wallet Crew.

<p align="center"><a href="https://admin.thewalletcrew.io/tenant/~/integrations/actito" class="button secondary" data-icon="chevrons-right">Ouvrir la page des paramètres généraux d'Actito</a></p>

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FXh5OUl0zvWTbM1IcG8dx%2Fimage.png?alt=media&#x26;token=e66b7918-a3d6-4fc8-bc27-3f7f54b6e43a" alt="Actito x The Wallet Crew - configuration screen"><figcaption></figcaption></figure></div>

Remplissez le formulaire avec les informations suivantes :

<table><thead><tr><th width="256"></th><th></th></tr></thead><tbody><tr><td><code>Serveur</code></td><td>URL du serveur Actito</td></tr><tr><td><code>Clé API</code></td><td>Clé API Actito qui permet à Wallet Crew d'accéder à votre environnement Actito.</td></tr><tr><td><code>Entité</code></td><td>Le nom de votre environnement (nom de licence) au sein d'Actito</td></tr><tr><td><code>Nom de la table de profils</code></td><td>Nom de la table Actito où vous stockez les profils (informations client)</td></tr><tr><td><code>Identifiant externe Actito</code></td><td>Nom de la colonne qui contient l'identifiant client. Cette colonne permet à Wallet Crew de lier une carte à un client spécifique.</td></tr><tr><td><code>Identifiant externe de la carte</code></td><td>Nom de la clé d'identifiant externe au sein de Wallet Crew.</td></tr></tbody></table>

{% hint style="warning" %}
L'Identifiant externe Actito et l'Identifiant externe de la carte doivent se référer à la même valeur.

Exemple : si la carte est également connectée à Cegid, utilisez le Y2 Cegid `customerId`.\
Dans ce cas, définissez `Identifiant externe de la carte` à `y2.customerId`.
{% endhint %}

Obtenez ces valeurs depuis Actito (paramètres API) et votre modèle de données Actito (table + colonne identifiant).
{% endstep %}

{% step %}

#### Configurer le modèle de carte

Pour afficher les messages Actito sur la carte, vous devez ajouter un champ dans le modèle de la carte.

Lorsque vous envoyez un message, le connecteur le stocke dans `additionalData.actito_message`.

{% tabs %}
{% tab title="Apple Wallet" %}
Ajoutez un champ arrière avec les paramètres suivants :

<table><thead><tr><th width="170"></th><th></th></tr></thead><tbody><tr><td>Étiquette</td><td><code>Message</code></td></tr><tr><td>Valeur</td><td><code>{{ additionalData.actito_message }}</code></td></tr><tr><td>Changer le message</td><td><code>%@</code></td></tr></tbody></table>

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2F3GXyyk8hi2vO6e0dXuyG%2Fimage.png?alt=media&#x26;token=c05461e8-e18d-4770-80b9-8a131e4fd5c5" alt="Apple Wallet - Actito notification configuration"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Google Wallet" %}
Ajoutez un champ arrière avec les paramètres suivants :

<table><thead><tr><th width="154"></th><th></th></tr></thead><tbody><tr><td>En‑tête</td><td>Message</td></tr><tr><td>Valeur</td><td><code>{{ additionalData.actito_message }}</code></td></tr></tbody></table>

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FUPanwf6gZ9rakjWO7Ryf%2Fimage.png?alt=media&#x26;token=1de4abc6-2b43-4b3b-a022-bfde54d7874e" alt="Google Wallet - Actito notification configuration"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}
{% endstep %}
{% endstepper %}

Une fois la configuration terminée, le connecteur crée automatiquement les tables et actions personnalisées requises dans Actito.

## FAQ

<details>

<summary><strong>Que fait Actito vs que fait Wallet Crew ?</strong></summary>

Actito décide **qui**, **quand**, et **quoi** dans les scénarios.

Wallet Crew exécute la couche wallet : création de carte, mises à jour et notifications.

Les clients n'ont pas besoin d'une application. Ils ajoutent une carte à Apple Wallet ou Google Wallet.

</details>

<details>

<summary><strong>Que puis‑je automatiser depuis les scénarios Actito ?</strong></summary>

* Mettre à jour le contenu de la carte (points, niveau, solde, expiration, info magasin, champs personnalisés).
* Envoyer un message wallet avec `neostore envoyer un message`.
* Actualiser automatiquement les cartes lorsque les profils Actito changent.
* Brancher selon le statut d'installation en utilisant `neostore_wallets` (notifier vs e‑mail/SMS).

</details>

<details>

<summary><strong>Comment suivre qui a installé la carte ?</strong></summary>

Le statut d'installation/désinstallation est synchronisé dans Actito dans la `neostore_wallets` table.

Utilisez‑le pour la segmentation, la suppression et le branchement des scénarios.

</details>

<details>

<summary><strong>Qu'en est‑il du consentement et du RGPD ?</strong></summary>

Rendez les messages wallet conditionnels au consentement, en particulier pour le marketing.

Voir [Consents & conformité RGPD](https://docs.thewalletcrew.io/fr/engager-et-animer/push-notification/consents-and-gdpr-compliance).

</details>