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