SDK Android (Kotlin)
L'employé ORYKSA AI intégré dans une application Android : Jetpack Compose ou Views, le même chat que sur le site web, en quatre langues.
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
| Package | Version | Plateformes | Licence |
|---|---|---|---|
com.oryksa:sdk (Maven Central, JitPack, GitHub) | 1.1.1 | Android 6.0+ (minSdk 23) | MIT |
Installer
Disponible sur Maven Central (com.oryksa:sdk:1.1.1) et sur JitPack.
// build.gradle.kts (app): Maven Central is in the default repositories
implementation("com.oryksa:sdk:1.1.1")
// Alternative, JitPack:
// settings.gradle.kts -> repositories { maven("https://jitpack.io") }
// implementation("com.github.oryksa:oryksa-android:1.1.1")
Exemple minimal
Un bouton qui ouvre l'activité de chat. Le chat affiche le nom et la photo de l'employé IA, exactement comme le chat du site web.
import com.oryksa.sdk.*
// The app never holds the API key: your backend creates short-lived
// session tokens (oryk_cs_...) with POST /v1/sessions and hands them over.
val client = OryksaClient(getToken = { myBackend.fetchOryksaToken() })
OryksaChatActivity.client = client
@Composable
fun MyScreen() {
val context = LocalContext.current
OryksaChatButton(client = client, onClick = {
OryksaChatActivity.open(context, lang = "en") // en, pt, br, es
})
}
// Apps with Views: OryksaChatActivity.open(this, "en")
Éléments
| Élément | Ce qu'il fait |
|---|---|
OryksaChatButton(client, onClick) | Bouton avec la photo et le nom ; ouvre le chat. |
OryksaChatActivity | L'écran de chat (Compose ou Views) : OryksaChatActivity.open(context, lang). |
OryksaChat(client) | Le panneau de chat en Compose, intégré où vous le souhaitez. |
OryksaChatTheme | Couleurs. |
client.agent(), client.sendAndWait(text), 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.
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.
