Aller au contenu
Dialog Docs

Choisir ton chemin d'installation

Installer Dialog implique deux préoccupations distinctes, qui ne vivent pas toujours au même endroit :

  • Ingestion de data — uploader ton catalogue produit (et optionnellement blog / pages) pour que l’assistant réponde juste.
  • Intégration frontend — embedder le widget assistant sur ton storefront pour que les visiteurs puissent l’utiliser.

Certains chemins couvrent les deux d’un coup (app Shopify, module Prestashop). D’autres stacks demandent un mix (par ex. Shopify headless : l’app gère l’ingestion, tu embeds le frontend toi-même).

Choisir selon ta stack

Section intitulée « Choisir selon ta stack »

Trouve ta stack ci-dessous. Chaque carte renvoie vers les deux pages à suivre : une pour l’ingestion de data, une pour l’embed frontend.

Qui fait quoi, et combien de boulot

Section intitulée « Qui fait quoi, et combien de boulot »

Ce que ton équipe doit faire dépend du chemin :

  • Merchant Shopify ou Prestashop → tu installes l’app ou le module toi-même depuis le back office. Pas besoin de dev pour un setup standard ; quelques minutes de clics. Ton catalogue se synchronise automatiquement.
  • Thème Shopify legacy (< 2.0) → même install, mais un dev (le tien ou ton agence) doit coller quelques snippets dans ton thème — généralement moins d’une heure.
  • Shopify headless, ou n’importe quel storefront custom avec des devs frontend → tes devs intègrent Dialog dans le code de ton storefront. Ils ont le contrôle total sur la façon dont l’assistant se connecte à ton panier et à tes pages produit, donc ça s’imbrique proprement dans ton checkout. Compte quelques heures à un jour de travail frontend.
  • Non-Shopify / non-Prestashop, sans dev frontend dispo → utilise Google Tag Manager. Tu configures depuis ton compte GTM, pas de code touché. Trade-off : le widget se charge après le reste de la page, donc les visiteurs ont un délai et un layout shift, et ça ne colle pas tout à fait au look de ton site. Chemin de dernier recours — à prendre seulement si une install SDK est impossible.

Options d’intégration frontend pour stacks custom ou headless

Section intitulée « Options d’intégration frontend pour stacks custom ou headless »

Si l’ingestion de data est gérée mais qu’il faut quand même embedder l’assistant sur un frontend custom, partage ça avec tes devs :

  • React → @askdialog/dialog-react — DialogProductBlock et DialogInput drop-in.
  • Vue 3 → @askdialog/dialog-vue — mêmes composants, version Vue.
  • Autres frameworks JS (Svelte, SolidJS, Lit, vanilla, templating server-side genre Twig / Blade / ERB) → @askdialog/dialog-sdk — SDK vanilla, l’équipe construit l’UI shell autour.

Le truc à vérifier sur toutes les installs

Section intitulée « Le truc à vérifier sur toutes les installs »

Le refresh UI du panier (icône, bulle, mini-cart, drawer) est le souci #1, sur toutes les plateformes. Une fois Dialog installé, ouvre l’assistant sur une page produit, ajoute un produit, et vérifie que ton UI panier se met à jour sans recharger la page. Si non, voir Problèmes d’ajout au panier — la solution dépend du chemin d’install.

Ce dont chaque chemin a besoin

Section intitulée « Ce dont chaque chemin a besoin »