Connectez votre compte Connectif avec Qapla pour synchroniser l'état de suivi des commandes de vos contacts et personnaliser la page de tracking de Qapla avec le Contenu Web de Connectif.
Dans cet article, vous apprendrez comment réaliser l'intégration avec Qapla pour synchroniser les informations de suivi des commandes. Une fois réalisée, vous pourrez utiliser les données de Connectif pour personnaliser la page de suivi avec contenu web de Connectif, ainsi qu'envoyer des emails depuis Connectif avec les informations de suivi. Les deux stratégies sont disponibles à la fin de cet article.
Temps d'implémentation: 30 min.
Difficulté: Facile.
Quand l'utiliser?: Pour collecter les données de Qapla et insérer du contenu depuis Connectif.
ÉTAPE 1: Création du canal Connectif dans Qapla
1. Connectez-vous à votre compte Qapla.
2. Allez dans Canaux et cliquez sur Créer un nouveau canal.
3. Donnez le Nom "Connectif" et, dans Données du canal , remplissez-les avec les informations suivantes, comme indiqué sur l'image :
- Dans Adresse, saisissez "www.connectif.ai".
- Dans Code, saisissez "Connectif".
4. Cliquez sur Ajouter.
ÉTAPE 2: Insertion du snippet de Connectif dans la page de tracking de Qapla pour collecter son activité
5. Connectez-vous à votre compte Connectif et allez dans Configuration de la boutique dans le menu latéral gauche.
6. Dans le sélecteur d'onglets, allez à "Canaux > Web" et copiez le script de la section Script d'intégration client.
7. Retournez dans Qapla, accédez aux canaux et cliquez sur Configurer le canal Connectif que vous avez créé à l' étape 1.
8. Dans "Marketing > Page de suivi", collez le script que vous venez de copier dans la section Script dans la balise HEAD.
9. Cliquez sur Enregistrer.
ÉTAPE 3: Création de l'intégration personnalisée dans Connectif
10. Connectez-vous à votre compte Connectif et allez dans Configuration de la boutique dans le menu latéral gauche.
11. Dans le sélecteur d'onglets, allez à "Intégrations > Intégrations personnalisées (webhooks)" et cliquez sur Créer une nouvelle intégration.
12. Définissez le champ "Nom de l'intégration" pour identifier l'intégration.
13. (Optionnel) Personnalisez la couleur, ajoutez une description ou catégorisez l'intégration.
14. Cliquez sur Mettre à jour.
ÉTAPE 4: Création de l'événement de réception
(Dans cette section, nous expliquons comment créer et configurer l'événement qui recevra les informations sur l'état de transport de la commande depuis Qapla).
15. Dans l'onglet Recevoir des données, cliquez sur Créer un nouvel événement de réception.
16. Donnez un nom et l'alias "order-status-change". Cliquez sur Enregistrer.
17. 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 "courierStatus" et l'ID "courierStatus" de type Texte.
- Créez un champ avec le nom "customerEmail" et l'ID "customerEmail" de type Email et cochez les options "Requis" et "Clé primaire".
- Créez un champ avec le nom "customerName" et l'ID "customerName" de type Texte et cochez l'option "Requis".
- Créez un champ avec le nom "language" et l'ID "language" de type Texte.
- Créez un champ avec le nom "qaplaStatus" et l'ID "qaplaStatus" de type Texte et cochez l'option "Requis".
- Créez un champ avec le nom "qaplaStatusID" et l'ID "qaplaStatusID" de type Texte.
- Créez un champ avec le nom "reference" et l'ID "reference" de type Texte et cochez l'option "Requis".
- Créez un champ avec le nom "trackingNumber" et l'ID "trackingNumber" de type Texte et cochez l'option "Requis".
- Créez un champ avec le nom "trackingUrl" et l'ID "trackingUrl" de type Texte et cochez l'option "Requis".
18. Cliquez sur Enregistrer pour sauvegarder les modifications.
ÉTAPE 5: Connexion de l'événement Connectif dans Qapla pour synchroniser les informations
19. Sur la page de l'événement de réception que vous venez de créer, copiez l' URL de l'Endpoint.
20. Retournez dans Qapla et, dans la configuration du canal Connectif, allez à "Marketing > Recommandations" et cliquez sur Connectif.
21. Sur cet écran, assurez-vous que la fonction de suivi des commandes est activée et collez, dans URL du Webhook, l'URL que vous venez de copier depuis Connectif, comme illustré dans l'image.
22. Cliquez sur Mettre à jour.
5.1. Création et connexion de l'API de consultation dans Qapla
Si vous envoyez les e-mails de changement de statut de commande via Connectif, cette étape n'est pas obligatoire, bien qu'elle soit recommandée.
23. Dans votre compte Connectif, accédez à Paramètres du magasin dans le menu latéral gauche.
24. Dans le sélecteur d'onglets, allez à "API et IP d'accès > Clés API" et cliquez sur Créer une nouvelle clé API.
25. Dans Permissions, cochez dans la section Contacts l'option Lecture.
26. Cliquez sur Enregistrer.
27. Copiez l' ID de la clé qui a été générée pour votre clé API.
28. Retournez dans Qapla et, dans "Marketing > Recommandations" , sélectionnez Connectif.
29. Sur cet écran, collez dans Clé API la clé que vous venez de copier.
30. Cliquez sur Mettre à jour.
Annexe : aperçu du changement de statut de commande dans Connectif
Une fois cette intégration réalisée, lorsque l'état de la commande d'un contact change, cela sera reflété dans l' Activité de sa Fiche de Contact.
Les statuts par lesquels passe une commande sont reflétés dans le champ qaplaStatus et le champ qaplaStatusId de l'intégration (étape 4), correspondant aux codes et valeurs dans Qapla :
| ID | Code | Italian Name | Spanish Name | Italian Abbreviation | Spanish Abbreviation |
|---|---|---|---|---|---|
| 0 | WAITING TO COMPUTE | Attesa Elaborazione | Esperando elaboración | Attesa Elab. | |
| 1 | PENDING | In sospeso | Pendiente | ||
| 2 | INFO RECEIVED | Attesa ritiro | Pendiente de retirar | Pendiente | |
| 3 | IN TRANSIT | In transito | En tránsito | ||
| 4 | OUT FOR DELIVERY | In consegna | En reparto | ||
| 5 | FAILED ATTEMPT | Tentativo di consegna fallito | Intento de entrega fallido | Consegna fallita | Entrega Fallida |
| 6 | EXCEPTION | Exception | Problème | Problèmes | |
| 8 | DELAY | Retard | Retardé | ||
| 10 | PICKUP POINT | Point de retrait | Point de collecte | ||
| 20 | DEPARTED | Expédié | Envoyé | ||
| 50 | PROCESSING | En traitement | En cours | ||
| 95 | RETURNED | Retourné | Renvoyé | ||
| 99 | DELIVERED | Livré | Distribué |
Success!
Your Connectif account integration with Qapla is complete.
Keep Learning!
To make the most of your Connectif account, we recommend continuing with the following articles:
- Qapla: Customizing the shipment tracking page, to get an example of a customization strategy in Qapla with Connectif content.
- Qapla: Order shipping status update email, to communicate shipping updates for a purchase order from Qapla.
- Custom integration for receiving data to learn how to use information that is not recorded by default on the platform.
-
API Integrations , to manage events such as purchase registrations or contact sign-ups.