Développeurs
API JavaScript
Pilotez le Messenger depuis votre propre code.
Une fois l’extrait chargé, appelez Shopxare(command, …) depuis votre page.
boot
Démarre le Messenger. app_id est obligatoire.
Shopxare('boot', {
app_id: 'YOUR_APP_ID',
user_id: '42', // your own ID for a logged-in user
user_hash: 'HMAC…', // see Identity verification
email: '[email protected]',
name: 'Ada Lovelace',
phone: '+48 600 000 000',
attributes: { plan: 'pro', shop_orders: 3, shop_cart_items: 2, shop_cart_total: '59.90', shop_currency: 'EUR' },
company: { company_id: '7', name: 'Analytical Ltd' },
hide_default_launcher: false,
});
Les données de boutique s’affichent sous forme de carte Boutique à côté de la conversation : shop_orders, shop_total_spent, shop_currency, shop_cart_items, shop_cart_total et shop_viewing_product (l’extension WooCommerce et l’extrait Shopify les envoient pour vous).
Définissez hide_default_launcher: true pour masquer le bouton rond et ouvrir le Messenger depuis votre propre bouton.
update
Envoyez de nouvelles données utilisateur, par exemple après la connexion.
Shopxare('update', { email: '[email protected]' });
show, hide et showNewMessage
Shopxare('show');
Shopxare('hide');
Shopxare('showNewMessage');
trackEvent
Enregistrez une action du client. Les événements apparaissent sur le contact et peuvent démarrer des parcours.
Shopxare('trackEvent', 'added_to_cart', { sku: 'A-100', price: 49 });
Écouter les changements
Shopxare('onUnreadCountChange', (count) => { /* update your badge */ });
Shopxare('onShow', () => {});
Shopxare('onHide', () => {});
shutdown
Appelez-le à la déconnexion. Il met fin à la session, pour que la personne suivante sur le même navigateur ne voie pas les conversations.
Shopxare('shutdown');
Toujours bloqué ? Contact