Aller au contenu
Orkiva

Agents commerciaux

Intégrer le widget

Le widget affiche votre agent dans une bulle de discussion sur votre site, sur ordinateur et sur mobile. Il suffit d’un script.

Installation

  1. 1

    Publiez l’agent

    Le widget ne répond que pour un agent publié.

  2. 2

    Autorisez votre domaine

    Onglet Intégration de l’agent : ajoutez les domaines de votre site (ex. www.votre-site.fr). Le widget refuse de démarrer sur un autre site.

  3. 3

    Collez le script

    Copiez le code depuis l’onglet Intégration ou la page Intégrations, et collez-le avant la balise </body> de chaque page où l’agent doit apparaître :

    html
    <script src="https://app.getorkiva.com/widget.js" data-agent="agt_VOTRE_IDENTIFIANT" async></script>

L’identifiant agt_… n’est pas un secret

Il identifie publiquement votre agent. La sécurité repose sur les domaines autorisés, des sessions de courte durée et des limites d’usage.

Apparence

  • Couleur principale et position (en bas à droite ou à gauche) : onglet Intégration.
  • Nom affiché, avatar et message d’accueil : onglet Identité.
  • Les changements sont visibles après la publication de l’agent.

Sites WordPress, Wix, Shopify…

Tous les outils de création de site permettent d’ajouter un script dans le pied de page (souvent appelé « code personnalisé » ou « intégration HTML »). Collez-y le code ci-dessus, puis publiez votre site.

Fonctionnement et limites

  • Chaque visiteur obtient une session limitée à sa conversation, valable 30 minutes et renouvelée tant qu’il discute (4 heures au maximum).
  • Un message fait 4 000 caractères au maximum.
  • Pour éviter les abus, le nombre de messages par minute est limité ; au-delà, le visiteur est invité à patienter.
  • Les conversations apparaissent dans Conversations, avec la page d’entrée du visiteur.

Le widget ne démarre pas ?

Vérifiez que l’agent est publié (et non suspendu), que le domaine exact de la page figure dans les domaines autorisés, et que votre offre n’a pas atteint sa limite de messages du mois (page Consommation).