Le widget

Le widget est le moyen le plus rapide de mettre l’assistant dans votre produit. C’est un seul script qui monte un lanceur de chat, isolé de votre page pour que rien n’entre en conflit.

Intégration

Ajoutez une balise de script avec votre clé publiable. Vous pouvez aussi l’installer depuis npm ou héberger le script vous-même si vous préférez.

<script
  type="module"
  src="https://cdn.syncanix.com/widget.js"
  data-key="pk_live_..."
  data-position="bottom-right"
></script>

Le script doit être chargé en type="module". C’est la seule exigence.

Comment il se charge

Le script démarre immédiatement un petit lanceur et ne charge le chat lui-même que lorsqu’un utilisateur l’ouvre, de sorte qu’il ne coûte presque rien d’emblée à votre page. Le chat s’exécute dans un Shadow DOM, donc vos styles et ceux du widget ne s’affectent jamais.

Sûr par défaut

Si la clé ou un attribut est incorrect, le widget ne lève jamais d’erreur dans votre page — il consigne un avertissement et n’affiche rien, et votre clé est masquée dans tout message. Une intégration cassée ne peut pas casser votre application.

Ce à quoi le widget peut et ne peut pas toucher

Le widget est délibérément isolé de la page sur laquelle il vit. Concrètement :

• Il s'exécute dans un Shadow DOM, de sorte que ses styles et ceux de votre page ne peuvent jamais s'influencer mutuellement.
• Il ne lit pas le contenu de votre page, ses cookies, son stockage local ni d'autres scripts — il ne travaille qu'avec ce que vous lui transmettez explicitement.
• Il utilise une clé publiable, qu'il est sans risque d'inclure dans le code source de votre page : elle peut démarrer un chat pour votre espace de travail et rien de plus.
• Il ne peut jamais faire quoi que ce soit que l'utilisateur connecté ne pourrait faire lui-même — chaque action s'exécute avec son identité et ses autorisations.

Étapes suivantes