Passer au contenu principal

​
Vue d’ensemble

Le widget Orova est un fichier JavaScript autonome qui ajoute un bouton flottant de chat/voix/vidéo à n’importe quel site web. Il gère toute l’interface utilisateur, les connexions WebRTC et la communication avec l’API.

​
Installation

<script
  src="https://app.orova.ai/widget/orova-widget.js"
  data-api-key="YOUR_API_KEY"
  data-agent-id="AGENT_ID"
  data-server-url="https://app.orova.ai"
  data-mode="voice"
  data-title="Acme Support"
  data-theme="light"
  data-primary-color="#312E56"
  data-position="bottom-right"
  data-subtitle="We typically reply instantly"
></script>

​
Référence complète des attributs

AttributObligatoirePar défautDescription
data-api-keyOui—Clé API Orova
data-agent-idOui—ID de l’agent
data-server-urlOui—URL du serveur API
data-modeNonchatchat, voice, video, multi
data-positionNonbottom-rightbottom-right, bottom-left
data-themeNonlightlight, dark
data-primary-colorNon#111111Couleur de marque (hex)
data-titleNonOrovaTitre de l’en-tête
data-subtitleNonWe typically reply instantlySous-titre de l’en-tête
data-greetingNon(auto)Message d’accueil personnalisé (remplace le premier message de l’agent)

​
Modes

​
chat — Texte uniquement

Interface de chat simple avec saisie de message et réponses en streaming.

​
voice — Chat + Sélecteur vocal

Affiche un écran de sélection où les utilisateurs choisissent entre le chat textuel et l’appel vocal.

​
video — Appel vidéo

Appel vidéo avec un avatar réaliste. Comprend les commandes de mise en sourdine, de basculement de la caméra et de fin d’appel.

​
multi — Sélecteur Voix + Vidéo

Affiche un écran de sélection où les utilisateurs choisissent entre l’appel vocal et l’appel vidéo.

​
Style

Le widget crée son propre shadow DOM et n’entre pas en conflit avec le CSS de votre site. La propriété data-primary-color contrôle toutes les couleurs d’accentuation, notamment :
  • Le bouton d’action flottant
  • Les bulles de message de l’utilisateur
  • L’arrière-plan de l’en-tête
  • Le bouton d’envoi
  • Les états actifs

​
Compatibilité des navigateurs

  • Chrome 80+
  • Firefox 80+
  • Safari 14+
  • Edge 80+
Les appels vocaux WebRTC nécessitent l’autorisation du microphone. Les appels vidéo chargent automatiquement le SDK requis.