Convyra/Documentation
Docs/Widget & Inbox

Installer et personnaliser le widget

Une balise script, une personnalisation complète depuis le dashboard et un iframe isolé.

Snippet

<script
  async
  src="https://convyra.app/widget.js"
  data-convyra-project="prj_public_VOTRE_ID"
></script>

Personnalisation depuis le dashboard

Ouvrez Paramètres → Widget & apparence. Tout est modifiable sans toucher au code : les visiteurs voient la nouvelle version dès l’enregistrement.

  • Nom de l’expéditeur affiché en haut de la conversation.
  • Logo de l’expéditeur (PNG, JPEG ou WebP, 2 Mo maximum).
  • Couleur d’accent, appliquée au widget, à la bulle et au projet.
  • Position de la bulle : en bas à droite ou en bas à gauche.
  • Texte de la bulle, titre et message d’accueil.
  • Affichage ou non de la mention « Propulsé par Convyra ».

Attributs facultatifs du script

Ces attributs définissent l’apparence avant la première réponse du serveur. Les réglages du dashboard prennent ensuite le relais.

<script
  async
  src="https://convyra.app/widget.js"
  data-convyra-project="prj_public_VOTRE_ID"
  data-convyra-color="#0b6b5f"
  data-convyra-position="left"
  data-convyra-label="Besoin d’aide ?"
></script>

Comportement

  • Le script ne bloque pas le rendu de la page.
  • La conversation persiste grâce à un jeton aléatoire non devinable, enregistré dans le stockage local du navigateur du visiteur sous la clé convyra_widget_ suivie de l’identifiant public du projet. Il ne contient aucune donnée personnelle directe, sert uniquement à la continuité de la conversation et à la présence du visiteur, et demeure jusqu’à l’effacement des données de navigation : mentionnez-le dans votre information cookies et traceurs. Le réglage « Création de la session visiteur » (Paramètres → Widget) permet de ne le poser qu’à la première interaction.
  • Le widget suit l’URL courante et le referrer sans lire le contenu des champs.
  • L’iframe autorise le partage d’écran uniquement après une action explicite du visiteur.