Open Invox Genesis

Version Notice: SOFT Integration is available starting from API version 2026-08-01.
The API version you have selected does not include it. Switch to 2026-08-01 to access this functionality.

Once you have a signature, open the Invox Genesis consultation view with it. The physician is authenticated transparently: no login form, no password, no additional verification step.

There are two ways to open it, and both are fully supported:

MethodWhen to use it
In an iframeYou want the consultation to happen inside your own EHR interface.
In a browser windowYou prefer a separate window or tab, or you cannot embed third-party content.

URL

https://suite.invoxmedical.com/genesis?third-party-signature=<signature>
ParameterRequiredDescription
third-party-signatureYesThe signature returned by Generate signature.
Request the signature at the moment the physician opens the consultation, not in advance and not in bulk. The URL carries a credential: build it server side, use it immediately, and never persist it or share it.

What the physician sees

When Invox Genesis is opened with a valid signature, the platform renders only the consultation view: no header, no sidebar, no menus, no breadcrumbs, no navigation to any other part of the platform. The view takes up the full available viewport, so it can be embedded without visual artifacts.

The consultation context you sent in consultationMetadata is displayed to the physician, so they can confirm they are working on the right patient.

This embedded mode stays active for the whole session: reloading the page or navigating inside Invox Genesis does not restore the rest of the platform. When the consultation ends, a neutral end-of-session screen is shown.

Embedding in an iframe

<iframe
  src="https://suite.invoxmedical.com/genesis?third-party-signature=SIGNATURE"
  allow="microphone"
  style="width: 100%; height: 100%; border: 0"
></iframe>

Requirements for the embedded mode to work:

RequirementDetail
Microphone accessThe allow="microphone" attribute is mandatory: without it the browser blocks recording inside the iframe.
Secure contextThe embedding page must be served over HTTPS. Browsers deny microphone access to insecure origins.
No domain allow-listing is needed. You do not have to register your domain to embed the view. Access is controlled by the signature, not by the embedding site: without a valid signature the iframe shows nothing, and a signature can only be issued with an API Key that holds the GENESIS-SOFT-INTEGRATION permission.

Opening in the browser

If you prefer not to embed the view, open the same URL directly in the browser. The behaviour is identical: same consultation view, same authentication, same end-of-session screen.

In a separate window or tab

Recommended when the physician should keep the EHR visible alongside the consultation.

TypeScript
const url = `https://suite.invoxmedical.com/genesis?third-party-signature=${signature}`;

// New tab
window.open(url, "_blank", "noopener");

// Or a sized window
window.open(url, "invox-genesis", "width=1280,height=800,noopener");
C#
// Desktop client (WinForms / WPF): open in the default browser
var url = $"https://suite.invoxmedical.com/genesis?third-party-signature={signature}";

System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo
{
    FileName = url,
    UseShellExecute = true
});
Java
import java.awt.Desktop;
import java.net.URI;

String url = "https://suite.invoxmedical.com/genesis?third-party-signature=" + signature;

if (Desktop.isDesktopSupported()) {
    Desktop.getDesktop().browse(new URI(url));
}
Python
import webbrowser

url = f"https://suite.invoxmedical.com/genesis?third-party-signature={signature}"

webbrowser.open_new_tab(url)

In the same window

Use a plain redirect when the consultation replaces your current view and the physician returns to the EHR afterwards.

TypeScript
window.location.assign(
  `https://suite.invoxmedical.com/genesis?third-party-signature=${signature}`,
);
Navigating away in the same window discards any unsaved state of your EHR page. If the physician may need to go back and forth between the consultation and the patient record, prefer a separate window or an iframe.
Microphone permission when opening in the browser. The first time a physician opens the consultation on a given device, the browser asks for microphone access. This is a native browser prompt and it must be accepted for recording to work. Unlike the iframe case, no allow attribute is involved.

After the exchange

The signature is consumed when the session is established. Invox Genesis removes third-party-signature from the address bar, so it does not end up in the browser history or in a shared link.

A signature opens one consultation. Do not reuse it, do not build permanent links with it, and do not attach it to a bookmark: after it is exchanged or after its 3-hour lifetime, the URL stops working.

Error handling

If the signature cannot be used, the physician is redirected to a neutral access error page and no session is established. This happens when:

SituationCause
Signature unknown or expiredMore than 3 hours elapsed, or the signature was never issued.
Signature already exchangedThe URL was reused.

Your integration should treat a returning physician who lands on the error page as a retry case: request a new signature and open the consultation again.

If the physician already had a session open on another organization of the platform, opening Invox Genesis with a signature switches the active organization to the one in the signature. This is the same behaviour as the platform's own organization selector.

Sessions without a signature

Opening https://suite.invoxmedical.com/genesis without third-party-signature is the regular platform behaviour: the physician logs in normally and gets the full platform layout. SOFT Integration does not alter it.

Table of Contents