ORYKSAORYKSADevelopers
Obter chaves de API

Chat para sites

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

Só para clientes. Este canal atende os clientes da empresa (perguntas, vendas, agendamentos) com o seu Brain, produtos e serviços. Nunca é uma interface do dono: não altera configuraçõ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ó no app ORYKSA oficial, no painel e na extensão do navegador. Saiba mais

Copie seu token do widget no app ORYKSA (ou obtenha o código pronto com GET /v1/widget) e cole a tag uma vez, no layout comum. O token é público de propósito: só permite que os visitantes conversem, não consegue ler nem alterar 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>

Aparência: escolhida no app

O lado da tela (direita ou esquerda), o tema claro ou escuro, a cor principal e se os visitantes podem arrastar o chat são escolhidos em app.oryksa.com > Conectores > Chat do site. A escolha é salva automaticamente e vale na hora no seu site, sem trocar o código.

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

Opções no código

Os atributos no código continuam funcionando e têm prioridade sobre o que está salvo no app.

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

Arrastar o chat

No computador, o visitante arrasta o chat pelo topo para qualquer lugar da página; a posição fica salva nesse site. Em telas pequenas (menos de 900 px de largura) o chat fica no seu canto. Você pode desligar o arrastar no app.

Lojas online e WordPress

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

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