ORYKSAORYKSADevelopers
Obtener claves de API

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

PaqueteVersiónPlataformasLicencia
Oryksa (GitHub)1.1.1iOS 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

PiezaQué 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.
OryksaChatThemeColores.
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.
Seguridad de base. Nunca pongas la clave secreta en el paquete de la app. Usa 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.