Intégration de Corti Assistant : Workflow typique

Vue d’ensemble

Ce guide vous accompagne dans l’intégration de Corti Assistant dans une application web via un iframe.

Vous allez :

Authentifier l’utilisateur avec OAuth2
Créer une session (interaction) via l’API
Intégrer l’iframe
Récupérer la documentation générée

Même s’il est centré sur les applications web, ce workflow s’applique à la plupart des cas d’usage embarqués.
Pour une introduction générale à l’intégration de Corti Assistant, consultez le guide : Intégrer Corti Assistant via iFrame ou WebView

1. 🔐 Authentification via OAuth2

Documentation : Guide d’intégration OAuth
PKCE est recommandé pour les applications frontend, mais d’autres flux (Auth Code, ROPC, Client Credentials) sont disponibles selon votre cas d’usage.
Le lien ci-dessus vous aidera à choisir le bon flux.

2. 🗂️ Créer une interaction

Documentation : Corti API – Create Interaction
Pour démarrer une nouvelle session, vous devez créer une interaction via une requête POST vers l’endpoint /interactions/.

Dans cette requête, vous pouvez inclure des métadonnées (ex. : ID patient, ID utilisateur, balises personnalisées) pour identifier ou catégoriser la session.

En réponse, vous obtiendrez un interaction.id, qui servira de référence de session.
Vous en aurez besoin pour intégrer l’Assistant à l’étape suivante.

3. 🧳 Intégrer l’iframe de Corti Assistant

Selon votre région, l’URL de l’application web sera l’une des suivantes :

https://assistant.us.corti.app
https://assistant.eu.corti.app

Prenez la réponse complète de l’authentification (étape 1) et encodez-la en Base64 :

await response.text();
const b64_auth = btoa(data);

Générez ensuite l’URL de l’application web en ajoutant l’interaction ID (de l’étape 2) dans le chemin, et la réponse auth encodée en paramètre de requête :

const webAppUrl =
`https://assistant.us.corti.app/session/${interactionId}?auth_response=${b64_auth}&embedded=true`

Passez cette URL dans votre balise iframe en vous assurant d’utiliser exactement cette configuration :

<iframe
name="iframe"
id="frame"
title="Corti Assistant"
src="{{webapp_url}}"
sandbox="allow-forms allow-modals allow-pointer-lock allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts allow-downloads"
allow="microphone *; camera *; device-capture *"
>
</iframe>

4. 📄 Récupérer la documentation générée

Documentation :

Une fois l’interaction terminée (ex. : une conversation a été enregistrée et transcrite), vous pouvez récupérer la documentation générée.

Listez tous les documents associés à une interaction en appelant l’endpoint /documents/ avec l’interaction_id
Pour accéder à un document spécifique, appelez /documents/{id} avec son document_id

Cela vous permet d’afficher ou de traiter le contenu généré par Corti Assistant.

🧠 Conseils pour développeurs

Ne stockez jamais de secrets dans le JS frontend
Validez toujours les endpoints HTTPS
Utilisez async/await pour garder un code propre
Gérez le renouvellement des tokens expirés
Utilisez les outils de développement du navigateur pour déboguer les flux iframe et authentification