> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/fr/marketing-automation/actito.md).

# Actito

Connectez Actito à Apple Wallet et Google Wallet avec The Wallet Crew pour envoyer des messages Wallet, actualiser les cartes et synchroniser l'état d'installation depuis Actito.

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

<figure><img src="https://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-0da1691a19b8b70b2a68bcfd8f8cd2bd4eaf70ea%2Factito-connect-illustration-en.png?alt=media" alt="Connect Actito to Apple &#x26; Google Wallet through The Wallet Crew"><figcaption><p>Actito décide qui, quand et quoi. The Wallet Crew gère la couche Wallet.</p></figcaption></figure>

<details>

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

* **Fidélité retail**: après l'achat, mettez à jour les points et le niveau sur la Carte. Puis notifiez lorsqu'une récompense se débloque.
* **Adhésion**: lorsque le statut change (actif, en pause, renouvelé), actualisez immédiatement la Carte. N'utilisez une notification que pour les moments clés.
* **Offres**: ajoutez un nouveau coupon ou avantage à la Carte. Notifiez à l'approche de l'expiration pour encourager l'utilisation.
* **table Events**: diffusez les changements de dernière minute (horaires, lieu, informations de porte). Réduisez les absences avec des rappels le jour même.

</details>

## Ce que fait cette intégration

Connectez Actito à The Wallet Crew pour :

1. **Actualiser les Cartes lorsque les profils Actito changent** (webhooks).\
   Gardez le contenu Wallet aligné sur le consentement, les préférences et les données de profil.
2. **Envoyer des messages Wallet pour une Carte donnée** depuis les scénarios Actito (action personnalisée).\
   Intervenez au bon moment sans vous fier uniquement aux taux d'ouverture des e-mails.
3. **Synchroniser les événements The Wallet Crew vers Actito** (webhooks).\
   Suivez des événements comme la création de client et le statut d'installation Wallet.

## Utilisation

Le préfixe `neostore` dans le nom de l'action personnalisée et des tables ci-dessous correspond à l'ancien nom de la plateforme et est conservé dans les identifiants techniques.

### Envoyer une notification push

Utilisez le **Neostore envoyer un message** action personnalisée dans un scénario Actito. Elle a deux entrées :

* **Type de Carte Neostore**: le modèle de Carte à cibler, sélectionné dans la `neostore_passTypes` table.
* **Message**: le texte à envoyer.

Un troisième paramètre, **Clé**, est fixé à `message` et ne peut pas être modifié. Le connecteur écrit le message dans `additionalData.actito_message` sur chaque Carte de ce modèle détenue par le profil.

Elle envoie un message Wallet de type push à la Carte du client. Sur Apple Wallet, il apparaît sur l'écran verrouillé. Sur Google Wallet, il s'affiche sur la Carte.

Pour plus de détails sur les notifications Wallet, voir [Notifications push](/guides-animation/fr/engage-and-animate/automatisation/push-notifications.md) (guide Engage).

Utilisez-la pour les moments sensibles au temps et limitez son usage. Par exemple, notifiez lorsqu'une récompense se débloque, lorsqu'un coupon expire ce soir, ou lorsqu'une commande est prête à être retirée.

### Synchronisation des nouveaux profils et des mises à jour de profil

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

Aucune configuration manuelle des webhooks n'est nécessaire. Chaque fois que les paramètres du connecteur sont enregistrés, The Wallet Crew enregistre des webhooks sur la table des profils Actito pour la création et la mise à jour des profils, et crée la clé API qu'ils utilisent. Cela maintient la Carte alignée sur les dernières données de profil, sans créer de branches supplémentaires « mettre à jour la Carte » 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 rapproche les données provenant de **tous** les fournisseurs.
{% endhint %}

### Synchronisation du statut d'installation 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-le comme signal déterministe pour la segmentation et le branchement des scénarios.

Le connecteur crée la `neostore_wallets` table dans Actito lorsqu'il écrit le premier statut d'installation, si la table n'existe pas encore. L'action personnalisée et sa `neostore_passTypes` table sont créées lorsque les paramètres du connecteur sont enregistrés.

Les événements d'installation et de désinstallation peuvent aussi déclencher des relances ou des récompenses.

Une utilisation typique consiste à faire bifurquer un scénario selon le statut d'installation. Si la Carte est installée, envoyez une notification Wallet. Sinon, envoyez un e-mail ou un SMS avec un lien Ajouter à Wallet. Arrêtez les messages Ajouter à Wallet une fois la Carte installée.

### Fournisseur de données de Carte

Utilisez Actito comme source de données pour la Carte.

Cela permet à The Wallet Crew d'afficher les attributs du profil Actito sur la Carte, comme le prénom, le nom, le libellé du niveau ou tout champ personnalisé stocké dans Actito.

<details>

<summary><strong>Configuration avancée</strong></summary>

Ce hook est documenté dans les guides Développeurs (Extensions, Actito). Dans la console d'administration, c'est le **Mappeur de profil** script sur l' **Avancé** onglet du connecteur Actito.

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

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

```javascript
/**
 * Mappage par défaut amélioré du profil Actito vers The Wallet Crew
 *
 * @param {Object} data - Attributs provenant d'Actito
 * @param {Object} account - L'objet de compte The Wallet Crew à renseigner (modifié 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

### Configuration de The Wallet Crew

{% stepper %}
{% step %}

#### Activer le connecteur

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

{% step %}

#### Configurer les paramètres généraux

Ouvrez les paramètres du connecteur Actito dans la console d'administration (**Données et intégrations → Connecteurs → Automatisation marketing → Actito**).

<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://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2FYZroWTqkvmI8OTIqvtZM%2Fintegrate-actito-actito-x-wallet-crew-screen.png?alt=media&amp;token=fa889399-d6c6-4381-9475-7f78deb9a085" alt="Actito x The Wallet Crew - configuration screen"><figcaption><p>Vérifiez que les champs serveur, entité et identifiant correspondent à l'environnement Actito et au modèle de données.</p></figcaption></figure></div>

Renseignez le formulaire avec les informations suivantes :

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

{% hint style="warning" %}
Le **Identifiant externe Actito** et **Identifiant externe de la Carte** doit faire référence à la même valeur.

Exemple : si la Carte porte aussi un `customerId` identifiant externe, définissez **Identifiant externe de la Carte** à `customerId`. Une clé a généralement la forme `<system>.<name>`, par exemple `y2.customerId` lorsque la Carte est aussi connectée à Cegid Retail Y2.
{% endhint %}

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

{% step %}

#### Configurer le modèle Wallet

Pour afficher les messages Actito sur la Carte, ajoutez un champ dans le modèle de Carte.

Lorsqu'un message est envoyé, 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>Libellé</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> (affiche la nouvelle valeur dans la notification de l'écran verrouillé)</td></tr></tbody></table>

<figure><img src="https://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fy4iypebXFz1k6dourbem%2Fintegrate-actito-apple-wallet-actito-notification.png?alt=media&amp;token=4df7d484-1bee-44aa-b94e-fae4fe642689" alt="Apple Wallet - Actito notification configuration"><figcaption><p>Confirmez que la valeur du champ arrière et le message de changement correspondent à la clé du message Actito.</p></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://1459665471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2F9HYle3KRuzkXRN01BpES%2Fintegrate-actito-google-wallet-actito-notification.png?alt=media&amp;token=21c39635-7666-4359-a645-4ceecde86534" alt="Google Wallet - Actito notification configuration"><figcaption><p>Confirmez que l'en-tête et la valeur correspondent à la clé du message Actito côté Google Wallet.</p></figcaption></figure>
{% endtab %}
{% endtabs %}
{% endstep %}
{% endstepper %}

## Dépannage

| Symptôme                                               | Cause probable                                                                                        | Ce qu'il faut vérifier                                                                                                                                                               |
| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Aucun message n'apparaît sur la Carte                  | Le modèle de Carte ne contient aucun champ de lecture `additionalData.actito_message`                 | Vérifiez la valeur du champ arrière dans le modèle de Carte (voir ci-dessus).                                                                                                        |
| L'action personnalisée est absente dans Actito         | Paramètres non enregistrés, ou la clé API n'a pas les droits nécessaires                              | Enregistrez à nouveau les paramètres du connecteur et vérifiez les droits de la clé API Actito.                                                                                      |
| Le `neostore_wallets` la table est absente dans Actito | Aucune Carte n'a encore été installée ou désinstallée, ou la clé API n'a pas les droits nécessaires   | Installez une Carte de test, puis vérifiez les droits de la clé API Actito.                                                                                                          |
| Un changement de profil ne rafraîchit pas la Carte     | Les identifiants Actito et de Carte n'ont pas la même valeur, ou les webhooks ne sont pas enregistrés | Comparez **Identifiant externe Actito** et **Identifiant externe de la Carte**. Puis enregistrez à nouveau les paramètres et vérifiez que la clé API Actito peut gérer les webhooks. |

## FAQ

<details>

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

Rendez les messages Wallet conditionnels au consentement, surtout pour le marketing.

Voir [Consentements et conformité RGPD](/guides-animation/fr/engage-and-animate/automatisation/push-notifications/consents-and-gdpr-compliance.md).

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/connectors/fr/marketing-automation/actito.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
