Options du code d'intégration
Les attributs lus par le script du chat du site web, pour les développeurs qui ajoutent le chat à la main.
Cette page s'adresse aux développeurs. La plupart des gens peuvent copier le code depuis Canaux → Chat du site web sans le modifier. Voir Installer sur votre site web.
Le code d'intégration
<script
src="https://chatzora.com/widget.js"
data-agent-id="YOUR_ASSISTANT_ID"
data-api-base="https://chatzora.com"
data-title="Your business name"
async
></script>Placez-le avant la balise de fermeture </body> sur chaque page où le chat doit apparaître.
Attributs
| Attribut | Obligatoire | Ce qu'il fait |
|---|---|---|
data-agent-id | Oui | L'assistant à charger. Sans lui, le script ne fait rien. |
data-api-base | Non | L'adresse Chatzora à contacter. Par défaut, l'adresse depuis laquelle le script a été chargé. |
data-title | Non | Texte d'en-tête affiché avant le chargement des réglages enregistrés. |
data-color | Non | Couleur du thème affichée avant le chargement des réglages enregistrés, par exemple #059669. |
data-welcome-message | Non | Message de bienvenue affiché avant le chargement des réglages enregistrés. |
data-launcher-text | Non | Texte du bouton du chat affiché avant le chargement des réglages enregistrés. |
data-position | Non | left ou right, avant le chargement des réglages enregistrés. |
data-lead-capture | Non | true pour afficher le formulaire de contact avant le chargement des réglages enregistrés. |
data-visitor-id | Non | Votre propre identifiant stable du visiteur, comme l'identifiant de votre client. Si vous l'omettez, un identifiant aléatoire est créé et conservé dans le navigateur. |
Les attributs d'apparence ne sont que des valeurs de départ. Une fois le chat chargé, les réglages enregistrés dans le tableau de bord (Paramètres → Fenêtre de chat) les remplacent. Modifiez l'apparence dans le tableau de bord plutôt que dans le code.
Comportement
- Sur les écrans de 480 px de large ou moins, le chat s'ouvre en plein écran. Sur les écrans plus grands, il s'ouvre en fenêtre flottante.
- Les réponses s'affichent au fur et à mesure qu'elles sont écrites lorsque le navigateur le permet. Les réponses qui utilisent une intégration, comme une recherche de produits, arrivent en une seule fois.
- Si Sites autorisés à afficher votre chat est renseigné, le chat ne fonctionne que sur ces origines exactes.
- Si le chat du site web est désactivé dans le tableau de bord, le script retire le chat de la page.
Content Security Policy
Si votre site utilise une Content Security Policy, autorisez script-src, connect-src et frame-src pour votre adresse Chatzora (https://chatzora.com). Les pages de réservation s'ouvrent dans un cadre ; si vous utilisez des liens de réservation, autorisez aussi votre outil de planification dans frame-src.
Page de chat hébergée
Vous pouvez créer un lien vers la page de chat hébergée, ou l'intégrer, à la place du script :
https://chatzora.com/widget?agentId=YOUR_ASSISTANT_ID