Skip to main content

Bp Integration FAQ & Common Issues

This article is to help you solve some basic FAQs that you may have for the Best Practice and Lyrebird integration.

If your issue is related to slow performance, crashing or WebView errors, please visit this article - Why is Lyrebird slow, crashing, or showing a WebView error in Bp Premier?

Why can't I see the Lyrebird "L" button?

If the Lyrebird "L" button is missing, or you find you can see it for some patients but not others, it may be because the wrong page is open.


The Lyrebird L will only appear when starting a patient visit, not when viewing records.

To start a visit:

  1. Open the appointment book.

  2. Select Start Visit.

  3. The Lyrebird "L" will appear

Screenshot of the Lyrebird L button in the ribbon during an active visit


If you are returning after a completed visit, you can re-open the visit to access Lyrebird.

Selecting the "Reopen Visit button" in the dropdown from the appointment list.

Alternatively, the L button will be visible when opening the record using this filing cabinet button here:

Image of the filing cabinet button on the home page of Bp Premier

If all of the above have been checked, and you still don't see the L button, the next step is to check the integration:

Refresh the Integration

  1. On Best Practice, head to Setup → Configuration

  2. Then head to Database → Setup third-party integration

  3. Search for Lyrebird Health, uncheck it, then recheck it, and click Save

  4. Open a patient record to check if you’re prompted to log in again


Why am I being asked to log in for every patient?

If you're being asked to log in every time, please double check you have the correct API key listed in your Best Practice Settings.
This is essential as it links your Lyrebird and Best Practice accounts.

Ensure your unique API key is matching

  1. Open your Lyrebird account in an external browser (not within Bp)

  2. Navigate to Settings → Integrations

  3. Copy your Bp Account Key

  4. Return to Best Practice, go to Setup → Users

  5. Select the relevant user, click Edit, then choose Lyrebird Scribe (bottom right)

  6. Paste the Bp Account Key into the designated field and click Save

If that doesn't work, you can refresh the integration:

  1. On Best Practice, head to Setup → Configuration

  2. Then head to Database → Setup third-party integration

  3. Search for Lyrebird Health, uncheck it, then recheck it, and click Save

  4. Open a patient record to check if you’re prompted to log in again


My account should be on Bp Free, why am I still seeing usage limits?

When you register for Lyrebird via the L button on Bp, your account will automatically be on the Bp free tier. The Bp Free plan includes:

  • Unlimited actions for Notes and Standard Dictate

  • 10 actions per month for AI Edit, Smart Dictate, and Documents

  • A one-time allowance of 20 actions for Workflows (including CCMP and Health Assessments) starting from the day the plan was activated - not 20 actions monthly, but only 20 actions in total

  • Document sharing and access to community-shared templates

To make sure your account gets access to Bp Free when you sign up, you can follow these steps to ensure your API is matching across Lyrebird and Best Practice.

You may also need to reach out to our Support team by clicking the chat bubble in the bottom right corner so they can confirm your account is configured correctly.


Where do my documents save in Bp Premier?

  • Notes save in "Today's Notes".

  • Care Plans & Health Assessments save in "Correspondence Out".

  • Documents and Letters must be copy/pasted into Bp Premier.

You may need to refresh the Patient File to view saved items in Correspondence Out. Press F5 to refresh or go to ViewRefresh in the top banner of Bp.


Why do I get a "Leave Site" pop-up when I start a consultation?

This was a known issue that has been resolved in the Bp Premier Oxford - 1.14.0.1114 update, so please coordinate this upgrade when possible.

If you are unable to proceed with the update for any reason, the workaround is to wait for the "Leave Site" message to appear, click Cancel, and Lyrebird will continue capturing the consultation as usual.


Why does the "Start Listening" button jump around the screen or need to be clicked twice?

Some users have reported issues where the Lyrebird window in Bp would auto-refresh and either appear to jump on "Start Listening," or require two clicks to begin a consult.

This issue is related to how Best Practice renders the window. It has been resolved in the Bp Premier Oxford - 1.14.0.1114 update, so please arrange this when possible to resolve the issue.

If, for any reason, you are not able to upgrade, the following workaround is available:

  1. Open the window

  2. Wait a few seconds for Best Practice to finish re-rendering.

  3. Press Start Listening — Lyrebird will then work as expected.


Do settings added in the Global Personalisation section of one template carry over to others?

When adding to the global personalisation settings in a template this does not carry over to other templates as these settings will be controlled template by template.


What do I do if my microphone is not connecting to Bp Premier when using Lyrebird?

The latest version Bp Premier Oxford - 1.14.0.1114 will automatically grant Lyrebird permission to use your microphone, however if it has accidentally been blocked previously, you can follow these steps:

  1. Close Best Practice completely 

  2. Click the Windows icon (bottom left of your screen) and search for "Run"

  3. Open the Run app and type: %APPDATA% then click OK

  4. In the file path at the top of the window, click on "AppData"

  5. Open the Local folder, then open the Best Practice folder

  6. Find and delete the folder titled EBWebView inside the "Best Practice" folder.

  7. Reopen Best Practice and a test patient file, then open Lyrebird.

If this does not work, reach out to Lyrebird Support!


Why am I seeing document template suggestions that are not relevant to my specialty?

Lyrebird now filters document and template suggestions based on your field of practice, so that only clinically relevant content appears during a consult - for example, a cardiologist won't be shown GP note templates.

If your suggestions seem limited or don't match your specialty, it's likely because your field of practice is set incorrectly in your account - a common issue for users who signed up via Best Practice, where the field defaults to General Practitioner.

To fix this:

  1. Open Lyrebird in an external browser (not within Bp).

  2. Go to Settings → Profile.

  3. Update your Field of Practice to match your specialty.

  4. Save your changes - your suggestions will update immediately.

If you're a practice manager setting up accounts for your team, make sure each user's field of practice is correctly set during onboarding to avoid this issue.


Why do I get an "Unable to Contact Lyrebird Scribe Api" error?

This error can arise either if the integration is not enabled or if you have recently updated to the latest version of Best Practice.

To resolve this, please try the following steps:


Not seeing your question?

Our support team is happy to help.

Live Chat: click the blue LiveChat icon in the bottom right corner of Lyrebird.

Phone: +61 483 964 067

Did this answer your question?