Skip to main content

Companion App: Setup and Testing Guide

The Companion App for Corti Embedded Assistant lets you pair a mobile device to an active desktop session, so recording can happen on your phone (e.g. in-room consultations) while transcripts and notes relay back to the web app in real time.

This guide covers how to enable the Companion App, how pairing works, and how to test the full flow end to end.

Before You Begin

You'll need:

  • The Corti Companion App installed on your mobile device (available from the App Store or Google Play)

  • Access to your Corti Embedded integration or the Corti Embedded Demo

  • A Corti API client configured for the Embedded Assistant with ROPC (Resource Owner Password Credentials) authentication

Getting Started Video

Getting Your API Client

If you don't already have an API client, you can create one through the Corti Console:

  1. Navigate to the Console and create a new API client.

  2. Ensure it's configured for use with the Embedded Assistant.

  3. Select ROPC as the authentication method so you can authenticate with your email and password.

Obtaining Your Auth Response

To authenticate and generate a device pairing QR code, you'll need a Keycloak token response. You can obtain this using an API client such as Postman, Bruno, or Insomnia.

Send a POST request to the Keycloak token endpoint:

curl --request POST \   --url <https://keycloak.eu.corti.app/realms/base/protocol/openid-connect/token> \   --header 'Content-Type: application/x-www-form-urlencoded' \   --data client_id={YOUR_CLIENT_ID} \   --data scope=openid \   --data grant_type=password \   --data password={YOUR_PASSWORD} \   --data username={YOUR_USERNAME}

The full JSON response from this request is what you'll paste into the demo page in the steps below.

Step 1: Authenticate

On the Embedded Demo page, paste your Keycloak auth response into the Auth section to authenticate your user session.

Step 2: Pair Your Mobile Device

  1. Paste your Keycloak auth response into the Device-Link QR section.

  2. A QR code will be displayed on screen.

  3. Open the Corti Companion App on your mobile device.

  4. Scan the QR code using the app, or enter the pairing code manually.

Once the pairing is successful, your mobile device is linked to the desktop session.

Step 3: Enable the Companion App

  1. Create a new interaction in the Embedded Demo.

  2. Navigate into the interaction.

  3. Under Configure App, toggle the Companion App to enabled.

Your mobile device will now appear as an option in the microphone selector, allowing you to record from your phone while the transcript and notes appear in the web app in real time.

Testing the Full Flow

To test the complete end-to-end experience:

  1. Open the Corti Companion App on your paired mobile device.

  2. On the desktop, start a new interaction and enable the Companion App.

  3. Select your mobile device as the microphone source.

  4. Begin speaking — the transcript should appear in real time on the desktop web app.

  5. Verify that notes and facts are generating as expected.

App Availability

The Corti Companion App is available from the App Store (iOS) and Google Play (Android).

Need Help?

If you have questions or experience issues, please contact Corti Support for assistance.

Related Articles
Did this answer your question?