SDK de Swift (iOS y macOS)
El empleado de IA de ORYKSA dentro de una app iOS o macOS: SwiftUI y UIKit, el mismo chat que el sitio web, en cuatro idiomas, sin dependencias.
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
| Paquete | Versión | Plataformas | Licencia |
|---|---|---|---|
Oryksa (GitHub) | 1.1.1 | iOS 15+, macOS 12+ | MIT |
Instalar
En Xcode: File > Add Package Dependencies, pega la URL del repositorio y elige 1.1.1. O añádelo a tu Package.swift; con CocoaPods añade el pod desde el registro público.
// Package.swift .package(url: "https://github.com/oryksa/oryksa-swift", from: "1.1.1") # CocoaPods (https://cocoapods.org/pods/Oryksa) pod 'Oryksa', '~> 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 Oryksa
// The app never holds the API key: your backend creates short-lived
// session tokens (oryk_cs_...) with POST /v1/sessions and hands them over.
let client = OryksaClient(getToken: { try await MyBackend.fetchOryksaToken() })
struct ContentView: View {
var body: some View {
MyScreen()
.overlay(alignment: .bottomTrailing) {
OryksaChatButton(client: client, lang: "en") // en, pt, br, es
}
}
}
Piezas
| Pieza | Qué hace |
|---|---|
OryksaChatButton(client:, lang:) | Botón flotante con la foto y el nombre; abre el chat. |
OryksaChatView(client:) | El panel de chat en SwiftUI, donde quieras. |
OryksaChatViewController(client:) | El mismo panel para apps UIKit. |
OryksaChatTheme | Colores. |
client.agent(), client.sendAndWait(_:), client.messages() | Sin interfaz: datos del agente, enviar un mensaje y esperar la respuesta, historial de mensajes. |
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.
getToken para pedir a tu backend un token oryk_cs_... de corta duración; el SDK lo renueva cuando caduca. Crea los tokens con la API de sesiones desde cualquier lenguaje de servidor.
