SDK React Native

L’employé ORYKSA AI dans une application React Native ou Expo : le même chat que sur le site, en quatre langues, sans code natif.

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

Installer

npm install @oryksa/react-native

Les types TypeScript sont inclus. Alternative directe depuis GitHub : npm install github:oryksa/oryksa-react-native#v1.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 { OryksaClient, OryksaChatButton } from "@oryksa/react-native";

// The app never holds the API key: your backend creates short-lived
// session tokens (oryk_cs_...) with POST /v1/sessions and hands them over.
const client = new OryksaClient({
  getToken: async () => {
    const r = await fetch("https://your-server.example/oryksa-token");
    return (await r.json()).token;
  },
});

export default function App() {
  return (
    <>
      <MyScreen />
      <OryksaChatButton client={client} lang="en" />   {/* en, pt, br, es */}
    </>
  );
}

Éléments

Côté serveur (Node)

La clé API reste sur votre serveur. Avec @oryksa/sdk votre backend crée le jeton session tokens utilisés par l'application, et garde le Brain de l'agent synchronisé avec l'application grâce à learnApp.

import { Oryksa, verifyWebhook } from "@oryksa/sdk";   // server side, Node

const oryksa = new Oryksa(process.env.ORYKSA_API_KEY);
// short-lived token for one app user: send only client_token to the app
const session = await oryksa.createSession({ conversationId: "user-42", customerName: "Ana" });
// keep the Brain in sync with the app (call it on every release)
await oryksa.learnApp({ name: "My app", screens, faq });
// webhooks: pass the RAW body
const event = await verifyWebhook(rawBody, req.headers["oryksa-signature"], webhookSecret);

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.