Exécutez plusieurs instances de widget sur la même page avec des conteneurs, des événements et des API d'instance isolés. Utilisez des ID d'instance uniques pour charger différentes configurations côte à côte (par exemple, vente + support) sans collisions.
Certaines applications ont besoin de plus d'un widget à la fois. Les sites de commerce électronique multi-marques pourraient afficher des widgets pour différentes catégories de produits, et les plateformes de support peuvent exécuter des widgets séparés pour la vente et le support technique. Le support multi-widget est désormais disponible grâce à l'intégration basée sur des instances et des API par instance.
data-instance-id uniquedata-config-id par instance si nécessairecompanin-widget-container-<instanceId> / companin-docs-widget-container-<instanceId>)Cela permet à plusieurs widgets indépendants de coexister sur une page sans se remplacer mutuellement.
Utilisez des ID de script uniques et des ID d'instance pour chaque instance de widget :
<script
id="companin-widget-script-sales"
src="https://widget.companin.tech/widget.js"
data-client-id="..."
data-agent-id="..."
data-config-id="sales-config-id"
data-instance-id="sales-widget"
></script>
<script
id="companin-widget-script-support"
src="https://widget.companin.tech/widget.js"
data-client-id="..."
data-agent-id="..."
data-config-id="support-config-id"
data-instance-id="support-widget"
></script>
Utilisez les API de registre pour cibler des instances spécifiques :
const sales = window.CompaninWidgets?.get('sales-widget');
const support = window.CompaninWidgets?.get('support-widget');
sales?.sendMessage('Afficher les offres actuelles');
support?.sendMessage('J'ai besoin d'aide technique');
window.CompaninWidgets?.list();
window.CompaninWidgets?.destroy('support-widget');
Les instances du widget de docs utilisent un registre parallèle :
window.CompaninDocsWidgets.get(id)window.CompaninDocsWidgets.list()window.CompaninDocsWidgets.destroy(id)Les intégrations existantes continuent de fonctionner. window.CompaninWidget et window.CompaninDocsWidget pointent toujours vers l'instance récemment initialisée, tandis que les API de registre fournissent un ciblage multi-instance déterministe.