ORYKSAORYKSADéveloppeurs
Obtenir des clés API

SDK Swift (iOS et macOS)

L’employé ORYKSA AI dans une application iOS ou macOS : SwiftUI et UIKit, le même chat que sur le site, en quatre langues, sans dépendances.

Ce que fait le SDK et à quoi il sert

Il intègre la bulle de chat ORYKSA et la voix dans votre application, pour servir les clients de votre entreprise: ils posent des questions, achètent et réservent. L'IA répond avec votre Brain, vos produits et vos services, avec le nom, la photo et la voix que vous avez choisis dans Votre IA, et enregistre les leads, réservations et ventes dans les Activités de votre compte ORYKSA, comme WhatsApp ou le chat du site web.

Ce n'est pas une interface pour le propriétaire : via le SDK, personne ne modifie vos paramètres, ne lit vos Activités ou ne donne d'ordres à ORYKSA, même s'il se présente comme le propriétaire. Le chat où le propriétaire parle à ORYKSA existe uniquement dans l'application officielle ORYKSA, le tableau de bord et l'extension navigateur.

La voix depuis la version 1.1 (Android, iOS, Flutter et React Native), avec le même comportement que l'application ORYKSA. Les SDK JavaScript et .NET sont uniquement textuels.

Les gros mots saisis par le client apparaissent sous forme d'astérisques dans le chat (la même liste que tous les chats ORYKSA, depuis GET https://app.oryksa.com/widget/profanity.json) ; les réponses de l'IA sont déjà filtrées.

En savoir plus dans le Centre d'aide

PackageVersionPlateformesLicence
Oryksa (GitHub)1.1.1iOS 15+, macOS 12+MIT

Installer

Dans Xcode : Fichier > Ajouter des dépendances de package, collez l’URL du dépôt et sélectionnez 1.1.1. Ou ajoutez-le à votre Package.swift; les utilisateurs de CocoaPods ajoutent le pod depuis le registre public.

// Package.swift
.package(url: "https://github.com/oryksa/oryksa-swift", from: "1.1.1")

# CocoaPods (https://cocoapods.org/pods/Oryksa)
pod 'Oryksa', '~> 1.1'

Exemple minimal

Un bouton flottant qui ouvre le chat. Le bouton affiche "Parler à <name>" avec la photo de l'employé IA, exactement comme le chat du site web.

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
            }
    }
}

Éléments

ÉlémentCe qu'il fait
OryksaChatButton(client:, lang:)Bouton flottant avec la photo et le nom, ouvre le chat.
OryksaChatView(client:)Le panneau de chat en SwiftUI, où vous le souhaitez.
OryksaChatViewController(client:)Le même panneau pour les applications UIKit.
OryksaChatThemeCouleurs.
client.agent(), client.sendAndWait(_:), client.messages()Pas d'interface : détails de l'agent, envoi d'un message et attente de la réponse, historique des messages.

Ce que l'utilisateur voit

  • Le même aspect que le chat du site web : bouton avec la photo, en-tête avec le nom et « en ligne », bulles, suggestions, ENVOYER et « Powered by ORYKSA ».
  • Langues : en, pt (Portugal), br (Brésil), es. Le nom et la photo proviennent du profil « Votre IA » du propriétaire.
  • Voix (depuis 1.1) : le micro dans le chat ouvre l'écran vocal, avec le même comportement que l'application ORYKSA. Chaque réponse a un bouton copier.
Sécurité dès la conception. Ne mettez jamais la clé secrète dans le bundle de l'application. Utilisez getToken pour récupérer un jeton oryk_cs_... temporaire depuis votre backend ; le SDK le renouvelle à expiration. Créez les jetons avec l' API Sessions depuis n'importe quel langage serveur.