1. Developing Open Storefront Framework Applications for Commerce Experience
  2. Enable Digital Assistant

Enable Digital Assistant

The communications storefront and self-care application is preintegrated with Oracle Digital Assistant. But, it is disabled by default. You can enable it based on your business needs.

Here's how you can enable Digital Assistant:

  1. In the OCC Admin console, navigate to Settings > Extension Settings > DX4C Store Site Settings.

  2. Update the following site settings:

    • Oracle Digital Assistant Enabled: Select to enable Digital Assistant.

    • Oracle Digital Assistant Instance URL: Enter the URL for the Digital Assistant instance.

    • Oracle Digital Assistant Channel ID: Enter the channel ID for the Digital Assistant instance.

  3. Click Save and then Publish.

Once you update the site settings, the Digital Assistant chat widget appears in the application when a user is signed in.

You can also use the useDigialAssistant hook in the @oracle-dx4c-buying/common/hooks/hook.js file to enable Digital Assistant. By default, this hook also displays the chat widget only if the user is signed in.

To modify when the ODA chat widget is displayed, use the following functions from @oracle-dx4c-buying/common/digital-assistant/index.js:

  • initializeODA: Dynamically imports the Digital Assistant SDK script located in <workspace>//occ-public/web-sdk.js and then displays the chat widget in the UI.

  • closeODA: Closes the SDK instance and removes the Digital Assistant chat widget from the UI.

  • isODAEnabled: Specifies whether the Digital Assistant SDK has been initialized or not.

For more information, see the Oracle Digital Assistant documentation.