Avec Connectif, vous pouvez enregistrer les achats que vos clients effectuent dans vos magasins physiques afin de les consigner dans leur fiche contact et disposer d’un historique unifié entre leurs actions en ligne et hors ligne. Ainsi, vous pourrez utiliser ces informations pour personnaliser vos stratégies en utilisant l’historique complet des achats de chaque client, quel que soit le canal où ils ont été réalisés.
Dans cet article, vous apprendrez comment intégrer les achats en magasin physique via l’API de Connectif afin qu’ils soient enregistrés dans la fiche de chaque contact.
Pour utiliser l’intégration via API, vous aurez besoin d’un expert ayant des connaissances en programmation. Si vous avez besoin de plus d’informations, consultez la documentation de l’API de Connectif.
Avant de commencer
Pour pouvoir réaliser cette intégration, vous devez avoir couvert les aspects suivants :
- Email comme clé primaire : le contact doit exister dans votre base de Contacts Connectif, avec un email associé comme clé primaire. Bien que l’API accepte d’autres identifiants (comme le numéro de sécurité sociale ou le téléphone), les utiliser comme identifiant principal provoquerait la création de contacts en double.
- Catalogue et produits synchronisés : tous les produits inclus dans l’achat hors ligne doivent exister dans votre catalogue Connectif. Si un article est vendu exclusivement en magasin physique et ne fait pas partie du site web, vous devez le créer dans Connectif avec le statut Arrêté pour pouvoir l’associer à la vente hors ligne.
- Informations sur les produits : il est recommandé d’envoyer les informations complètes des produits inclus dans l’achat, en particulier l’attribut categories. Cela vous permettra de créer des segments de produits et d’utiliser ces informations dans vos stratégies automatisées.
- Structure stricte de la requête : la requête ne peut inclure que les attributs acceptés par le modèle de l’API. Il n’est pas possible d’envoyer des champs personnalisés ou des attributs supplémentaires dans le JSON.
Apprenez comment fonctionne l’API de Connectif dans cet article.
ÉTAPE 1. Préparation des contacts dans Connectif
(Cette section explique comment préparer vos contacts dans Connectif pour qu’ils puissent être correctement liés à l’achat hors ligne).
Vous pouvez ajouter les contacts à Connectif via une importation de fichier ou via l’API.
Lors de l’enregistrement d’un achat hors ligne via l’API, Connectif associera les informations envoyées aux contacts et produits existants. L’API ne les créera pas pendant le processus, vous devez donc vérifier au préalable qu’ils existent dans Connectif.
1. Vérifiez que le contact existe déjà dans Connectif avec son email enregistré. S’il n’existe pas, créez-le au préalable pour pouvoir lier l’activité correctement.
2. Dans la barre de recherche, saisissez l’email du contact pour vérifier son existence. Si le contact n’existe pas, vous devrez le créer pour pouvoir associer l’achat à son historique.
Apprenez comment importer des contacts dans cet article.
ÉTAPE 2. Préparation des produits dans Connectif
(Cette section explique comment préparer vos produits dans Connectif pour qu’ils puissent être correctement liés à l’achat hors ligne).
Vous pouvez ajouter les produits à Connectif via une importation de fichier ou via l’API.
3. Accédez à "E-commerce > Catalogue" et cliquez sur le bouton d’options .
4. Si un des articles associés à l’achat hors ligne n’existe pas dans Connectif, créez-le avant d’importer l’achat, pour cela :
-
Cliquez sur Créer un produit.
-
Complétez, au minimum, les champs obligatoires du produit (nom, ID, URL de détail et prix).
- Si le produit est vendu uniquement en magasin physique, attribuez-lui le statut Arrêté, pour que l’achat hors ligne puisse être enregistré mais que le produit ne soit pas affiché dans la boutique en ligne.
L’URL de détail est obligatoire, même si le produit n’existe pas sur le web ou est marqué comme Arrêté. Dans ces cas, incluez une URL utilisant le même domaine enregistré dans votre boutique Connectif pour éviter les erreurs de validation. Par exemple, si le domaine de votre boutique est https://www.mondomaine.com, vous pouvez utiliser comme URL de détail : https://www.mondomaine.com/produits/SKU-12345.
ÉTAPE 3. Création de la clé API
5. Accédez à la Configuration de la boutique dans le menu latéral gauche de Connectif.
6. Dans le sélecteur d’onglets, allez à "API et accès IP" et cliquez sur Clés API.
7. Cliquez sur le bouton Créer une nouvelle clé API.
8. Dans la section Achats du panneau de création, activez les permissions pour Lire, Écrire et Supprimer en masse.
Si vous allez également gérer les contacts et produits via l’API, activez les permissions correspondantes dans les sections Contacts et Produits.
9. Enregistrez la clé API et copiez-la pour l’utiliser ultérieurement dans votre script d’automatisation.
ÉTAPE 4. Enregistrement de l’achat via l’API
(Cette section explique comment préparer l’envoi des informations de l’achat à Connectif via l’API).
Pour enregistrer un achat hors ligne, vous devez effectuer une requête HTTP POST qui enverra les informations de l’achat à Connectif au format JSON.
10. Créez le script d’automatisation depuis votre système et incluez-y la clé API générée à l’étape précédente.
11. Configurez dans le script une requête HTTP POST pour enregistrer l’achat dans Connectif : https://api.connectif.cloud/purchases/
Dans la requête, indiquez :
- La clé API pour authentifier l’appel.
- Le type de contenu application/json.
- Les informations de l’achat dans le corps de la requête.
12. Créez les informations de l’achat à envoyer et vérifiez qu’elles respectent les conditions suivantes :
- Incluez les attributs obligatoires de l’achat : cartId, products, purchaseDate, purchaseId, totalPrice et totalQuantity.
- Identifiez le contact via contactEmail.
- Pour chaque produit inclus dans products, complétez les attributs obligatoires : name, price, productDetailUrl, productId, quantity et unitPrice.
- Pour enregistrer l’achat comme provenant d’un magasin physique, configurez sourceType avec la valeur point-of-sale et indiquez le magasin ou la succursale dans sourceName.
- Assurez-vous que purchaseId est l’identifiant unique de l’achat.
Apprenez comment élaborer la structure complète de la requête dans la documentation de l’API.
Exemple
Une fois créée, la requête aura un aspect similaire à celui-ci :
const apiKey = "VOTRE_CLÉ_API";
const url = "https://api.connectif.cloud/purchases/";
const purchase = {
contactEmail: "client@exemple.com",
purchaseId: "POS-20260804-001",
cartId: "POS-20260804-001",
purchaseDate: "2026-08-04T15:30:00Z",
sourceType: "point-of-sale",
sourceName: "Magasin Centre",
products: [
{
productId: "SKU-12345",
name: "Chaussure de running",
categories: ["Chaussures/Running"],
quantity: 2,
unitPrice: 39.95,
price: 79.90,
productDetailUrl: "https://www.mondomaine.com/produits/SKU-12345"
}
],
totalQuantity: 2,
totalPrice: 79.90
};
async function main() {
const response = await fetch(url, {
method: "POST",
headers: {
"Authorization": `apiKey ${apiKey}`,
"Content-Type": "application/json"
},
body: JSON.stringify(purchase)
});
const result = await response.json();
console.log(result);
}
main();
Le script enregistre un achat effectué dans un magasin physique et l’associe au contact indiqué dans l’attribut contactEmail. Les attributs sourceType et sourceName identifient le point de vente physique et le nom de la source où il a été réalisé.
Succès !
L’importation des achats des magasins physiques est maintenant prête.
Continuez à apprendre !
Pour exploiter tout le potentiel de votre compte Connectif, nous vous recommandons de continuer avec les articles suivants :
- Intégrations via API, pour gérer des événements tels que les enregistrements d’achats ou les créations de contacts.
- Intégration personnalisée pour envoyer des données depuis Connectif, pour envoyer des informations en temps réel via Webhooks.
- Importation de contacts, pour importer manuellement des contacts dans Connectif.
- Exportation de contacts et d’activités, pour exporter des contacts et événements depuis Connectif.