SDK de React Native

El empleado de IA de ORYKSA dentro de una app React Native o Expo: el mismo chat que el sitio web, en cuatro idiomas, sin código nativo.

Qué hace el SDK y para qué sirve

Pone en tu app la burbuja de chat y la voz de ORYKSA para atender a los clientes de tu empresa: preguntan, compran y reservan. La IA responde con tu Brain, tus productos y tus servicios, con el nombre, la foto y la voz que elegiste en Tu IA, y guarda leads, reservas y ventas en las Actividades de tu cuenta ORYKSA, como en WhatsApp o en el chat del sitio.

No es una interfaz del dueño: por el SDK nadie cambia tus ajustes, lee tus Actividades ni da órdenes a ORYKSA, aunque diga que es el dueño. El chat en el que el dueño habla con ORYKSA existe solo en la app oficial de ORYKSA, el panel y la extensión del navegador.

Voz desde la versión 1.1 (Android, iOS, Flutter y React Native), con el mismo comportamiento que la app de ORYKSA. Los SDK de JavaScript y .NET son solo texto.

Las palabrotas que escribe el cliente aparecen con asteriscos en el chat (la misma lista de todos los chats de ORYKSA, en GET https://app.oryksa.com/widget/profanity.json); las respuestas de la IA ya vienen filtradas.

Más información en el Centro de Ayuda

Instalar

npm install @oryksa/react-native

Los tipos de TypeScript vienen incluidos. Alternativa directa desde GitHub: npm install github:oryksa/oryksa-react-native#v1.1.1.

Ejemplo mínimo

Un botón flotante que abre el chat. El botón muestra "Hablar con <nombre>" con la foto del empleado de IA, exactamente como el chat del sitio.

import { OryksaClient, OryksaChatButton } from "@oryksa/react-native";

// The app never holds the API key: your backend creates short-lived
// session tokens (oryk_cs_...) with POST /v1/sessions and hands them over.
const client = new OryksaClient({
  getToken: async () => {
    const r = await fetch("https://your-server.example/oryksa-token");
    return (await r.json()).token;
  },
});

export default function App() {
  return (
    <>
      <MyScreen />
      <OryksaChatButton client={client} lang="en" />   {/* en, pt, br, es */}
    </>
  );
}

Piezas

Lado del servidor (Node)

La clave de API se queda en tu servidor. Con @oryksa/sdk tu backend crea los tokens de sesión que usa la app y mantiene el Brain del agente sincronizado con la app mediante learnApp.

import { Oryksa, verifyWebhook } from "@oryksa/sdk";   // server side, Node

const oryksa = new Oryksa(process.env.ORYKSA_API_KEY);
// short-lived token for one app user: send only client_token to the app
const session = await oryksa.createSession({ conversationId: "user-42", customerName: "Ana" });
// keep the Brain in sync with the app (call it on every release)
await oryksa.learnApp({ name: "My app", screens, faq });
// webhooks: pass the RAW body
const event = await verifyWebhook(rawBody, req.headers["oryksa-signature"], webhookSecret);

Qué ve el usuario

• El mismo aspecto que el chat del sitio: botón con la foto, cabecera con el nombre y "online", burbujas, sugerencias, ENVIAR y "Powered by ORYKSA".
• Idiomas: en, pt (Portugal), br (Brasil), es. El nombre y la foto vienen del perfil "Tu IA" del dueño.
• Voz (desde la 1.1): el micrófono del chat abre la pantalla de voz, con el mismo comportamiento que la app de ORYKSA. Cada respuesta tiene un botón de copiar.