Intégration avec Reskyt

Intégrez votre compte Connectif avec Reskyt pour pouvoir envoyer des notifications push natives via l'application.

Dans cet article, vous apprendrez comment intégrer votre compte Connectif avec Reskyt pour collecter l'activité du contact et un exemple de workflow dans lequel une notification push est envoyée à Reskyt.

Temps de mise en œuvre : 1 heure.
Difficulté : Intermédiaire
Quand l'utiliser ? : Pour envoyer des notifications push via l'application.

Ceci est un exemple parmi les nombreuses possibilités offertes par cette intégration. En suivant les principes de base expliqués dans cet article, vous pourrez créer davantage de stratégies d'envoi de push qui vous aideront à atteindre vos objectifs.

 

Pourquoi implémenter l'extension

1. Cas d'usage que vous pourrez créer après cette intégration

Voici quelques idées qui peuvent vous servir à mettre en place différentes stratégies dans l'application Reskyt après avoir activé l'extension Reskyt dans votre Boutique Connectif.

  • Récupérer les paniers abandonnés.
  • Réaliser des stratégies de remarketing via les push de Reskyt.
  • Envoyer un message de félicitations pour les anniversaires.
  • Envoyer une remise pour l'anniversaire du premier achat.

 

2. Que pourrez-vous faire avec Connectif dans Reskyt ?

Avec cette extension, depuis Connectif, vous pourrez créer des stratégies automatisées pour envoyer des notifications push via l'application Reskyt.

De plus, vous pourrez collecter l'activité du contact dans Reskyt.

 

3. Quelles données de Connectif pourrez-vous utiliser dans Reskyt ?

Par ailleurs, dans Reskyt, vous pourrez exploiter toutes les informations collectées dans la fiche du contact, ainsi que son activité en temps réel, pour personnaliser les notifications avec les données du contact Connectif.

 

Avant de commencer : ce que vous devez savoir

Pour pouvoir intégrer votre compte Connectif avec Reskyt et automatiser l'envoi de notifications push natives, vous aurez besoin de :

  • Demander à Reskyt l'activation de l'API et sa clé, afin de pouvoir l'utiliser.

De plus, vous devez prendre en compte certaines propriétés des notifications push mobiles envoyées via Reskyt :

  • Il n'est pas possible d'annuler l'abonnement d'un contact à ces notifications, car il n'existe pas de mécanisme qui notifie en cas d'erreur de livraison.
  • Les push mobiles ne disposent pas de statistiques ni d'analyses d'envoi, d'ouvertures ou de clics.
    • Le nombre de clics pourrait être récupéré via des options UTM dans le lien, mais ce n'est pas une donnée collectée par défaut.
  • Le contact aura au maximum un seul appareil, car un seul token peut être stocké dans le champ personnalisé.
  • Deux contacts ou plus peuvent avoir le même token Reskyt, car ils pourraient, par exemple, ouvrir plusieurs sessions sur le même appareil.

 

ÉTAPE 1 : Création du champ personnalisé qui stockera le token Reskyt

(Dans cette section, nous allons créer le champ personnalisé qui collectera le Token Reskyt, c’est-à-dire l’identifiant du contact dans l’App).

1. Rendez-vous dans "Contacts > Champs du Contact" et cliquez sur Ajouter un nouveau champ personnalisé.

Integración con Reskit - 1-min.png

 

2. Attribuez-lui le type Texte et cliquez sur Aller à l'éditeur.

Integración con Reskit - 2-min.png

 

3. Donnez-lui le Nom et l’ID "reskyt-token" et cliquez sur Enregistrer.

Pour que l'intégration fonctionne et que le token soit stocké dans Connectif, il est important que le champ personnalisé ait ce nom et cet ID.

Integración con Reskit - 3 (1)-min.png

 

ÉTAPE 2 : Création du workflow pour collecter le token du contact

(Dans cette section, nous allons créer le workflow qui collectera l'activité du contact lors de sa navigation dans l'app Reskyt et mettra à jour, dans Connectif, le champ personnalisé que vous avez créé à l’ÉTAPE 1. Cette activité sera collectée via un script inséré dans Reskyt en inline).

4. Rendez-vous dans Workflows et cliquez sur Créer un nouveau workflow.

Integración con Spoki 2023 - 6-min.png

 

5. Sélectionnez un nouveau workflow vierge.

6. Dans le "Nœud de Départ", sélectionnez Tous les contacts de ma liste.

7. Ajoutez le nœud déclencheur "À la visite d'une page" pour que le workflow s'active dès qu'un contact visite le site. Dans la configuration du nœud, dans l'onglet Limitations, supprimez toutes les limitations.

Integración con Reskit - 4-min.png

 

8. Ajoutez le nœud de type condition "Vérifier valeur" et ouvrez l'éditeur du nœud.

9. Dans la configuration du nœud "Vérifier valeur", sélectionnez l'opérateur User Agent, obtenu du nœud "À la visite d'une page" et glissez-le dans la colonne de gauche du panneau central.

Integración con Reskit - 5-min.png

 

10. Sélectionnez, dans la colonne de droite, la valeur Littérale et glissez-la dans la colonne de droite du panneau central. Ensuite, saisissez dans cette valeur le texte "rktwebview".

La valeur indiquée est celle que Reskyt assigne par défaut. Vous pouvez la modifier, mais si vous le faites, vous devrez indiquer dans ce champ la valeur que vous avez choisie à la place de "rktwebview".

Integración con Reskit - 6-min.png

 

11. Cliquez sur Mettre à jour.

De cette manière, Connectif vérifiera que, pendant la navigation, la page contient la valeur "rktwebview" dans le paramètre User Agent. Cette information est directement transmise par Reskyt pour indiquer qu’un contact navigue via son application.

12. Ajoutez le nœud de type action "Envoyer contenu web" pour insérer le script qui vérifiera l’activité du contact via Reskyt.

13. Ne modifiez pas la liaison de ce nœud avec le nœud "Vérifier valeur", afin que "Oui" apparaisse.

Integración con Reskit - 7-min.png

 

14. Cliquez sur (Modifier la configuration du nœud) du nœud “Envoyer contenu web” et Créer un nouveau contenu pour générer un nouveau contenu.

15. Lors de la création d’un nouveau contenu, sélectionnez le type Inline, donnez-lui un nom, par exemple "Script Reskyt", puis cliquez sur Créer un nouveau contenu.

16. Ajoutez un composant de type HTML et éditez-le en copiant et collant le code suivant :

<script>
(function connectifReskyt(global) {

  if (global.connectif &&

      global.connectif.managed &&

      global.connectif.managed.isInitialized()) {

    getReskytToken();

  } else {

    global.document.addEventListener(

      "connectif.managed.initialized",

      function onConnectifInitialized() {

        getReskytToken();

      }

    );

  }

  function getReskytToken() {

    var reskytToken = getCookie("token_md5");
   
     if (!reskytToken) {
    
        return;
    }

    var previousReskytToken = global.sessionStorage.getItem("cn_reskyt_token");

    if (reskytToken !== previousReskytToken) {

      global.connectif.managed.sendEvents([], {

        entityInfo: { "reskyt-token": reskytToken },

        onResponded: function onResponded() {

            global.sessionStorage.setItem("cn_reskyt_token", reskytToken);

        }

      });

    }

  }

  function getCookie(name) {

    var value = "; " + global.document.cookie;

    var parts = value.split("; " + name + "=");

    if (parts.length === 2) return parts.pop().split(";").shift();

  }

})(window);
</script>

Ce script récupère le token Reskyt depuis un cookie et le stocke dans le champ personnalisé "reskyt-token".

Integración con Reskit - 8-min.png

 

17. Cliquez sur Enregistrer pour sauvegarder les modifications et sur Retour au sélecteur pour revenir et terminer la configuration du nœud.

18. Une fois le contenu Inline que vous venez de créer sélectionné, cliquez sur Suivant.

Integración con Reskit - 9-min.png

 

19. Dans Configuration, ajoutez le sélecteur approprié pour afficher le contenu. Dans ce cas, il est recommandé d’inclure le contenu sur la page produit ou une autre page qui se rend à la fois sur le web et dans l’App.

Integración con Reskit - 10-min.png

 

20. Dans l’onglet Limitations, supprimez toutes les limitations du nœud. Enfin, cliquez sur Terminer pour sauvegarder la configuration du nœud.

21. Enregistrez et activez le Workflow.

 

ÉTAPE 3 : Création de l'événement d'envoi de données pour afficher les pushs dans Reskyt

(Dans cette section, nous allons créer l'événement qui enverra les informations de Connectif vers Reskyt afin de permettre l'affichage des notifications push dans l'App).

22. Accédez à Configuration de la boutique dans le menu latéral gauche.

23. Dans le sélecteur d'onglet, allez à "Intégrations > Intégrations personnalisées (webhooks)" et cliquez sur Créer une nouvelle intégration.

Integración con Spoki 2023 - 0-min.png

 

24. Remplissez le champ "Nom de l'intégration" pour identifier l'intégration et cliquez sur Mettre à jour.

25. Dans l'onglet Envoyer des données, cliquez sur Créer un nouvel événement d'envoi.

26. Dans cet écran, donnez un nom à l'événement.

27. Dans le champ URL du Webhook où envoyer le message, collez l'URL de l'API Reskyt pour envoyer des notifications push. Dans ce cas, l'URL est "https://push.api.reskyt.com/push/send".

Si vous avez besoin de plus d'informations sur l'API Reskyt, consultez leur documentation.

Integración con Reskit - 16-min.png

 

28. Cliquez sur Ajouter un nouvel en-tête et donnez-lui le Nom "x-api-key" et, dans la Valeur, saisissez la clé API Reskyt.

Vous devrez demander cette clé à Reskyt ainsi que l'activation de leur API pour pouvoir l'utiliser.

Integración con Reskit - 11-min.png

 

29. Cliquez sur Ajouter un nouveau champ pour créer chacun des champs personnalisés et complétez leurs informations :

  • Créez un champ avec le nom et l’ID "dateEnd" de type Texte.

Bien que l’ajout d’une date de fin ne soit pas obligatoire, c’est recommandé, par exemple, dans des stratégies où vous souhaitez envoyer une push informant d’une offre, afin qu’elle cesse d’être envoyée à la fin de l’offre.

  • Créez un champ avec le nom et l’ID "pictureUrl" de type Texte.
  • Créez un champ avec le nom et l’ID "title" de type Texte et marquez-le comme obligatoire.
  • Créez un champ avec le nom et l’ID "tokens" de type Texte et marquez-le comme obligatoire. Activez les options JSON et attribuez-lui le paramètre "/tokens/0".

Integración con Reskit - 15-min.png
 

  • Créez un champ avec le nom et l’ID "url" de type Texte.
  • Créez un champ avec le nom et l’ID "utmCampaign" de type Texte.
  • Créez un champ avec le nom et l’ID "heading" de type Texte et marquez-le comme obligatoire.

Integración con Reskit - 12-min.png

 

30. Cliquez sur Enregistrer.

 

ÉTAPE 4 : Création du workflow pour envoyer une notification push dans Reskyt

(Dans cette section, nous allons créer la stratégie qui enverra une notification push à l'app Reskyt).

Nous vous recommandons de créer un segment dynamique plus pour filtrer les contacts dont le champ personnalisé reskyt-token n’est pas vide. Ainsi, la stratégie sera activée uniquement pour les contacts Reskyt, évitant que Connectif recherche dans toute votre base de contacts.

31. Rendez-vous dans Workflows et cliquez sur Créer un nouveau workflow et sélectionnez un Nouveau workflow vierge.

Integración con Spoki 2023 - 6-min.png

 

32. Dans le "Nœud de Départ", sélectionnez le Segment Dynamique Plus que vous avez créé pour filtrer les contacts Reskyt.

34. Cherchez le nœud de type action que vous avez créé lors de votre intégration avec Reskyt (étape 3) et ajoutez-le à votre workflow.

Integración con Reskit - 13-min.png

 

35. Dans la configuration du nœud, glissez le champ "reskyt-token" des informations du contact et faites-le correspondre à la valeur "Tokens" de la colonne de droite. Les autres valeurs, associez-les à un champ Littéral pour donner la forme et l’information que contiendra votre push dans Reskyt.

Le champ dateEnd doit être au format Timestamp. Vous pouvez utiliser ce convertisseur pour obtenir le format de la date que vous souhaitez saisir. De plus, Reskyt fixe une limite de date à 2 mois après l’envoi.

Integración con Reskit - 14-min.png

 

36. Cliquez sur Mettre à jour pour enregistrer la configuration du nœud et activez votre workflow.

 

Succès !
L’intégration de votre compte Connectif avec Reskyt est prête.

 


Continuez à apprendre !

Pour exploiter tout le potentiel de votre compte Connectif, nous vous recommandons de continuer avec les articles suivants :