SDK de Flutter

El empleado de IA de ORYKSA dentro de una app Flutter: el mismo chat que el sitio web, en cuatro idiomas, con un Brain que aprende la app.

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

flutter pub add oryksa

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 'package:oryksa/oryksa.dart';

// The app never holds the API key: your backend creates short-lived
// session tokens (oryk_cs_...) with POST /v1/sessions and hands them over.
final client = OryksaClient(
  getToken: () async => await myBackend.fetchOryksaToken(),
);

Scaffold(
  body: MyScreen(),
  floatingActionButton: OryksaChatButton(client: client, lang: 'en'), // en, pt, br, es
);

Piezas

Lado del servidor (Dart)

La clave de API se queda en tu servidor. 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 'dart:io';
import 'package:oryksa/oryksa_server.dart';   // backend only: never import it in the app

final oryksa = Oryksa(Platform.environment['ORYKSA_API_KEY']!);
// short-lived token for one app user: send only client_token to the app
final 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: appScreens, faq: appFaq);
// webhooks: pass the RAW body
final event = verifyWebhook(rawBody, request.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.