SDK Swift (iOS e macOS)
O colaborador de IA da ORYKSA dentro de um app iOS ou macOS: SwiftUI e UIKit, o mesmo chat do site, em quatro idiomas, sem dependências.
O que o SDK faz e para que serve
Coloca no seu app o balão de chat e a voz da ORYKSA para atender os clientes da sua empresa: eles perguntam, compram e agendam. A IA responde com o seu Brain, os seus produtos e os seus serviços, com o nome, a foto e a voz que você escolheu em Sua IA, e registra leads, agendamentos e vendas nas Atividades da sua conta ORYKSA, como no WhatsApp ou no chat do site.
Não é uma interface do dono: pelo SDK ninguém altera as suas configurações, lê as suas Atividades ou dá ordens à ORYKSA, mesmo dizendo que é o dono. O chat em que o dono fala com a ORYKSA existe só no app ORYKSA oficial, no painel e na extensão do navegador.
Voz desde a versão 1.1 (Android, iOS, Flutter e React Native), com o mesmo comportamento do app ORYKSA. Os SDKs JavaScript e .NET são só texto.
Os palavrões que o cliente digita aparecem com asteriscos no chat (a mesma lista de todos os chats da ORYKSA, em GET https://app.oryksa.com/widget/profanity.json); as respostas da IA já vêm filtradas.
Saiba mais na Central de Ajuda
| Pacote | Versão | Plataformas | Licença |
|---|---|---|---|
Oryksa (GitHub) | 1.1.1 | iOS 15+, macOS 12+ | MIT |
Instalar
No Xcode: File > Add Package Dependencies, cole a URL do repositório e escolha 1.1.1. Ou adicione ao seu Package.swift; no CocoaPods adicione o pod a partir do 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'
Exemplo mínimo
Um botão flutuante que abre o chat. O botão mostra "Falar com <nome>" com a foto do colaborador de IA, exatamente como o chat do site.
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
}
}
}
Peças
| Peça | O que faz |
|---|---|
OryksaChatButton(client:, lang:) | Botão flutuante com a foto e o nome; abre o chat. |
OryksaChatView(client:) | O painel de chat em SwiftUI, onde você quiser. |
OryksaChatViewController(client:) | O mesmo painel para apps UIKit. |
OryksaChatTheme | Cores. |
client.agent(), client.sendAndWait(_:), client.messages() | Sem interface: dados do agente, enviar uma mensagem e aguardar a resposta, histórico de mensagens. |
O que o usuário vê
- O mesmo visual do chat do site: botão com a foto, cabeçalho com o nome e "online", balões, sugestões, ENVIAR e "Powered by ORYKSA".
- Idiomas:
en,pt(Portugal),br(Brasil),es. O nome e a foto vêm do perfil "Sua IA" do dono. - Voz (desde a 1.1): o microfone no chat abre a tela de voz, com o mesmo comportamento do app ORYKSA. Cada resposta tem um botão de copiar.
getToken para buscar no seu backend um token oryk_cs_... de curta duração; o SDK renova o token quando ele expira. Crie os tokens com a API de sessões a partir de qualquer linguagem de servidor.
