Expression Australia's BODI HealthDirect SDK Integration Help

Overview

The Expression Australia BODI HealthDirect SDK has been developed specifically to support Expression Australia's BODI (Business On-Demand Interpreting) platform. BODI empowers organisations to request Auslan interpreters on demand for real-time video consultations.

This SDK enables seamless integration between the BODI platform and HealthDirect’s secure video conferencing system, allowing approved HealthDirect clients (such as clinics) to initiate interpreter requests directly into active video sessions. The result is a streamlined, privacy-conscious, and accessible communication experience for all participants.

2. Installation

Include the SDK via CDN or a downloaded file:

3. Configuration

Before making interpreter requests, you must configure the SDK.

In the test environment, both baseURL and clientId must be configured. These values will be provided to you by the Expression Australia team.

    EABodiHD.configure({
      baseURL: "https://api.development.ea-aod.com",
      clientId: "your-client-id",
      clientSecret: "your-client-secret"
    });
        

⚠️ Never expose your clientSecret in frontend production code — use best security practices to hide it from end users.

In the production environment, HealthDirect does not need to configure baseURL or clientId. These values are automatically embedded in the production SDK.

4. Requesting an Auslan Interpreter

Use the following function to trigger an interpreter request:

await EABodiHD.requestAuslanInterpreter("clinicId / tenantId / teamId", "Video Session URL", "genderPreference");
        

• "clinicId / tenantId / teamId" — This value is assigned to the clinic using the HealthDirect application. It helps the interpreter platform route the request appropriately.
• "Video Session URL" — The HealthDirect video session where the interpreter will join.
• "Preferred Gender" — To request a interpreter of a specific Gender request, values can be "Male", "Female" or "Any"

5. Error Handling

try {
  await EABodiHD.requestAuslanInterpreter(...);
} catch (err) {
  console.error("Request failed:", err);
}