Utilisez l'API d'Omnisend pour connecter des plateformes de commerce électronique personnalisées (comme Magento ou OpenCart) ou créer des intégrations avancées qui transmettent des données de contact, de commande, de produit et d'événement entre votre boutique et Omnisend.
Cet article explique quand utiliser l'API, ce qu'elle fait et quels guides d'intégration suivre.
Avant de commencer
✅ Ce guide est destiné à :
Magento, OpenCart ou des plateformes de commerce électronique sur mesure.
Développeurs créant des intégrations d'applications tierces.
Utilisateurs avancés ajoutant des fonctionnalités personnalisées (webhooks, événements personnalisés).
❌ Pas nécessaire pour :
Shopify, WooCommerce ou BigCommerce (ces plateformes s'intègrent automatiquement – aucune configuration d'API requise).
Prérequis :
Générer une clé API (requise pour toutes les requêtes API).
Connaissances de base des API REST et de JSON (ou embaucher un développeur).
Accès au backend/code de votre boutique.
Qu'est-ce que l'API Omnisend ?
L'API Omnisend permet à votre boutique ou application d'envoyer automatiquement des données à Omnisend – aucun téléchargement manuel requis.
Par exemple, lorsqu'un client (e) passe une commande, l'API transmet les détails de la commande à Omnisend afin que vous puissiez déclencher des e-mails de Confirmation de commande. Ou lorsque un visiteur parcourt des produits, l'API suit son activité pour les workflows d'Abandon de navigation.
Omnisend fournit deux types d'API :
API REST – transmet des données entre le backend de votre boutique et Omnisend (contacts, commandes, produits, événements).
API JavaScript – suit l'activité du site web (vues de pages, vues de produits, ajouts au panier) pour des workflows comportementaux.
Quand utiliser l'API
Utilisez l'API si :
Vous gérez une plateforme de commerce électronique sur mesure (pas Shopify/WooCommerce/BigCommerce).
Vous êtes sur Magento, OpenCart ou une autre plateforme sans plugin Omnisend natif.
Vous souhaitez créer des intégrations personnalisées (par exemple, synchroniser des contacts depuis un CRM, déclencher des flux de travail en fonction des événements de l'application).
Vous avez besoin de fonctionnalités avancées comme les webhooks, le suivi des custom events ou la synchronisation des données en temps réel.
Ne pas utiliser l'API si :
Vous êtes sur Shopify, WooCommerce ou BigCommerce – utilisez le plugin natif à la place (configuration plus rapide, pas de codage).
Commencer
Étape 1. Consultez la documentation de l'API :
Guide de démarrage rapide – bases de l'API REST (authentification, points de terminaison, format de requête).
Guide de l'API JavaScript – configuration du suivi du site web.
Étape 2. Générer une clé API :
Suivez ce guide pour créer une clé avec les bonnes permissions (Contacts, Commandes, Produits, Événements).
Étape 3. Testez votre intégration :
Utilisez les journaux API (Paramètres de la boutique → Journaux API) pour déboguer les requêtes et confirmer que les données passent correctement.
Guides d'intégration spécifiques aux fonctionnalités
Une fois que votre connexion API de base fonctionne, complétez ces guides pour activer des fonctionnalités spécifiques d'Omnisend :
Contacts (e) & Synchronisation des données. Transférer les informations de contact à Omnisend– synchroniser les listes d'abonnés, ajouter des propriétés personnalisées, mettre à jour les détails du contact.
Commandes & Récupération du Panier:
Activer les flux de travail de Panier abandonné – passer les données du panier pour déclencher des e-mails/SMS de panier abandonné.
Activer les flux de Confirmation de commande et de Confirmation d'expédition – passer les données de commande pour déclencher des e-mails transactionnels.
Suivi de Produit:
Configurer le product picker – laissez les utilisateurs sélectionner des produits dans l'Éditeur d'emails et les workflows d'automatisation.
Activer les flux de travail d'abandon de Produit & d'Abandon de navigation – suivre les vues de produit et les ajouts au panier.
Événements personnalisés. Déclencher des événements personnalisés pour les flux de travail d'Automatisation– passer des données personnalisées (par exemple, "essai commencé," "abonnement renouvelé") pour déclencher des flux de travail.
Analyse et reporting (Bêta). Exporter les données d'analyse avec l'API Statistics– interroger les performances de la campagne et du Workflow, les métriques d'engagement, l'attribution des revenus, les métriques de ventes au niveau du Produit (unités commandées totales et attribuées), la Délivrabilité et les données de croissance de l'Audience pour les outils BI, les tableaux de bord personnalisés ou les intégrations de data warehouse.
Formulaires et suivi des performances (Bêta). Exporter les données des formulaires avec l'API Forms– récupérer des listes de formulaires, des rapports de performance, des soumissions de contact et des données de test A/B pour des tableaux de bord personnalisés ou des intégrations tierces.
Foire aux questions
Ai-je besoin de compétences en programmation pour utiliser l'API ?
Oui. Vous devrez comprendre les API REST, JSON et le code backend de votre boutique. Si vous n'êtes pas développeur, engagez-en un ou utilisez une intégration native (Shopify/WooCommerce/BigCommerce).
Quelle est la différence entre l'API REST et l'API JavaScript ?
API REST passe des données entre les serveurs (contacts, commandes, produits)
API JavaScript suit le comportement des utilisateurs sur votre site web (vues de pages, vues de produits, ajouts au panier)
La plupart des intégrations utilisent les deux.
Puis-je utiliser l'API en parallèle avec des intégrations natives ?
Oui. Par exemple, les utilisateurs de Shopify peuvent utiliser l'API JavaScript pour suivre des événements personnalisés même si l'intégration de base (commandes, contacts) est automatique.
Comment résoudre les erreurs de l'API ?
Vérifiez Logs API (Paramètres de la Boutique → Logs API) pour voir les détails des requêtes/réponses. Problèmes courants : clé API incorrecte, champs requis manquants et limite de taux dépassée.
Vous avez d'autres questions ? Contactez-nous à [email protected] ou chat dans l'application.