ORYKSAORYKSADevelopers
Obtener claves de API

Chat para sitios

Pon el empleado de IA en cualquier sitio con una sola etiqueta de script: texto y voz, foto, saludo y sugerencias.

Solo para clientes. Este canal atiende a los clientes de la empresa (preguntas, ventas, reservas) con tu Brain, productos y servicios. Nunca es una interfaz del dueño: no cambia ajustes, no lee Actividades ni acepta órdenes del dueño, aunque alguien diga que es el dueño. El dueño habla con ORYKSA solo en la app oficial de ORYKSA, el panel y la extensión del navegador. Más información

Copia tu token del widget en la app de ORYKSA (u obtén el código listo con GET /v1/widget) y pega la etiqueta una vez, en el layout común. El token es público a propósito: solo permite que los visitantes conversen, no puede leer ni cambiar nada.

<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>

Aspecto: se elige en la app

El lado de la pantalla (derecha o izquierda), el tema claro u oscuro, el color principal y si los visitantes pueden arrastrar el chat se eligen en app.oryksa.com > Conectores > Chat del sitio. La elección se guarda sola y se aplica al momento en tu sitio, sin cambiar el código.

El endpoint público GET https://app.oryksa.com/widget/api/{token}/info la devuelve en "style": {"position", "theme", "accent", "drag"}.

Opciones en el código

Los atributos en el código siguen funcionando y tienen prioridad sobre lo guardado en la app.

AtributoDescripción
data-langen, pt, pt-BR o es. Por defecto sigue el idioma de la página.
data-positionleft o right.
data-accent, data-ink, data-paperColores en hex, para combinar con tu marca.
data-font-title, data-font-textFamilias tipográficas ya cargadas por tu página.

Arrastrar el chat

En el ordenador, el visitante arrastra el chat por la parte superior a cualquier lugar de la página; la posición queda guardada en ese sitio. En pantallas pequeñas (menos de 900 px de ancho) el chat se queda en su esquina. Puedes desactivar el arrastre en la app.

Tiendas online y WordPress

WordPress y WooCommerce, Shopify y Nuvemshop tienen su propio plugin o app, que añaden este mismo chat sin código: plugin de WordPress, app de Shopify, app de Nuvemshop.

Las respuestas de voz y los canales web dependen del plan. Limita el chat a tus dominios con PUT /v1/widget/domains o en la app. Esta página usa el mismo chat: ábrelo en la esquina.