ORYKSAORYKSADevelopers
Obter chaves de API

Chat para sites

Põe o colaborador de IA em qualquer site com uma só tag de script: texto e voz, foto, saudação e sugestões.

Só para clientes. Este canal atende os clientes da empresa (perguntas, vendas, marcações) com o teu Brain, produtos e serviços. Nunca é uma interface do dono: não muda definições, não lê Atividades nem aceita ordens do dono, mesmo que alguém diga que é o dono. O dono fala com a ORYKSA só na app ORYKSA oficial, no painel e na extensão do browser. Saber mais

Copia o teu token do widget na app ORYKSA (ou obtém o código pronto com GET /v1/widget) e cola a tag uma vez, no layout comum. O token é público de propósito: só deixa os visitantes conversar, não consegue ler nem mudar 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>

Aspeto: escolhe-se na app

O lado do ecrã (direita ou esquerda), o tema claro ou escuro, a cor principal e se os visitantes podem arrastar o chat escolhem-se em app.oryksa.com > Conectores > Chat do site. A escolha fica guardada sozinha e aplica-se logo no teu site, sem trocar o código.

O endpoint público GET https://app.oryksa.com/widget/api/{token}/info devolve-a em "style": {"position", "theme", "accent", "drag"}.

Opções no código

Os atributos no código continuam a funcionar e têm prioridade sobre o que está guardado na app.

AtributoDescrição
data-langen, pt, pt-BR ou es. Por omissão segue a língua da página.
data-positionleft ou right.
data-accent, data-ink, data-paperCores em hex, para combinar com a tua marca.
data-font-title, data-font-textFamílias de letra já carregadas pela tua página.

Arrastar o chat

No computador, o visitante arrasta o chat pelo topo para qualquer sítio da página; a posição fica guardada nesse site. Em ecrãs pequenos (menos de 900 px de largura) o chat fica no seu canto. Podes desligar o arrastar na app.

Lojas online e WordPress

O WordPress e o WooCommerce, a Shopify e a Nuvemshop têm plugin ou app próprios, que põem este mesmo chat sem código: plugin WordPress, app Shopify, app Nuvemshop.

As respostas por voz e os canais web dependem do plano. Limita o chat aos teus domínios com PUT /v1/widget/domains ou na app. Esta página usa o mesmo chat: abre-o no canto.