ORYKSAORYKSADéveloppeurs
Obtenir des clés API

Chat de site web

Ajoutez l’employé IA à n’importe quel site web avec une seule balise script : texte et voix, photo, message d’accueil et suggestions.

Pour les clients uniquement. Ce canal sert les clients de l'entreprise (questions, ventes, réservations) avec votre Brain, vos produits et services. Ce n'est jamais une interface pour le propriétaire : il ne modifie pas les paramètres, ne lit pas les Activités ni ne donne d'ordre au propriétaire, même si quelqu'un prétend l'être. Le propriétaire parle à ORYKSA uniquement dans l'application officielle ORYKSA, le dashboard et l'extension navigateur. Plus

Copiez votre jeton de widget depuis l’application ORYKSA (ou récupérez le code prêt à l’emploi avec GET /v1/widget) et collez la balise une seule fois, dans la mise en page partagée. Le jeton est public par conception : il permet seulement aux visiteurs de discuter, il ne peut rien lire ni modifier.

<script src="https://app.oryksa.com/static/oryksa-widget.js"
        data-token="YOUR_WIDGET_TOKEN" data-lang="en" defer></script>
// app/layout.tsx
import Script from "next/script";

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script src="https://app.oryksa.com/static/oryksa-widget.js"
                data-token="YOUR_WIDGET_TOKEN" strategy="afterInteractive" />
      </body>
    </html>
  );
}
import { useEffect } from "react";

export default function App() {
  useEffect(() => {
    if (document.getElementById("oryksa-widget")) return;
    const s = document.createElement("script");
    s.id = "oryksa-widget";
    s.src = "https://app.oryksa.com/static/oryksa-widget.js";
    s.defer = true;
    s.setAttribute("data-token", "YOUR_WIDGET_TOKEN");
    document.body.appendChild(s);
  }, []);
  return <Routes />;
}
// nuxt.config.ts
export default defineNuxtConfig({
  app: {
    head: {
      script: [{ src: "https://app.oryksa.com/static/oryksa-widget.js", defer: true,
                 "data-token": "YOUR_WIDGET_TOKEN" }],
    },
  },
});
<!-- src/layouts/Base.astro, before </body> -->
<script is:inline src="https://app.oryksa.com/static/oryksa-widget.js"
        data-token="YOUR_WIDGET_TOKEN" defer></script>

Apparence : choisie dans l’application

Le côté de l’écran (droit ou gauche), le thème clair ou sombre, la couleur principale et la possibilité pour les visiteurs de déplacer le chat sont définis dans app.oryksa.com > Connecteurs > Chat sur site web. Le choix est enregistré automatiquement et s’applique immédiatement sur votre site, sans modifier le code.

Le point de terminaison public GET https://app.oryksa.com/widget/api/{token}/info le retourne en tant que "style": {"position", "theme", "accent", "drag"}.

Options dans le code

Les attributs dans l’extrait de code restent valides et prennent le dessus sur ce qui est enregistré dans l’application.

AttributDescription
data-langen, pt, pt-BR ou es. Par défaut, il suit la langue de la page.
data-positionleft ou right.
data-accent, data-ink, data-paperCouleurs en hexadécimal, pour correspondre à votre marque.
data-font-title, data-font-textFamilles de polices déjà chargées par votre page.

Déplacer le chat

Sur ordinateur, le visiteur déplace le chat par sa barre supérieure à n’importe quel endroit de la page ; la position est mémorisée sur ce site. Sur les petits écrans (moins de 900 px de large), le chat reste dans son coin. Vous pouvez désactiver le déplacement dans l’application.

Boutiques en ligne et WordPress

WordPress et WooCommerce, Shopify et Nuvemshop disposent de leur propre plugin ou application, qui ajoutent ce même chat sans code : Plugin WordPress, Application Shopify, Application Nuvemshop.

Les réponses vocales et les canaux web dépendent du forfait. Verrouillez le chat à vos domaines avec PUT /v1/widget/domains ou dans l’application. Cette page utilise le même chat : ouvrez-le dans le coin.