> For the complete documentation index, see [llms.txt](https://docs.valorx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.valorx.com/valorx-wave/help-and-faq/page-1.md).

# Page 1

## Set Up User Access

To use the Einstein model, every Wave AI user, including the administrator, must meet all four requirements below:

<table><thead><tr><th width="174">What each user needs</th><th>How to give it</th></tr></thead><tbody><tr><td><strong>API Enabled</strong></td><td>Give the user this permission through their profile or a permission set.</td></tr><tr><td><strong>A Valorx Permission Set</strong></td><td>Assign a Valorx permission set, such as <strong>Valorx Grid Standard User</strong> or <strong>Valorx Grid Designer User</strong>.</td></tr><tr><td><strong>A Wave Package License</strong></td><td>This is only required if the package was installed with per-user licenses. In <strong>Setup</strong>, go to <strong>Installed Packages</strong>, find the Valorx package, click <strong>Manage Licenses</strong>, and assign a license to each Wave AI user.</td></tr><tr><td><strong>External Client App Approval</strong></td><td>Configure access for the user's profile or assigned permission set in <a href="#approve-users-in-the-valorx-external-client-app">Step 3</a>.</td></tr></tbody></table>

{% hint style="danger" %}

#### Important

A user must have **all four requirements** to use Wave AI. If any requirement is missing, the user may see an access or permission error.

**Note:** Steps 3–5 are **one-time org-level setup** performed by a System Administrator. You do not need to repeat these steps for each user.
{% endhint %}

## Approve users in the Valorx External Client App

The Valorx package installs the settings needed to communicate securely with Salesforce and the Wave AI service. In this step, choose which **profiles or permission sets** can access Wave AI.

1. In Salesforce **Setup**, search for **External Client App Manager** and open **Valorx**.<br>

   <figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F5rYlcv7SiPA33VBw8nYE%2FOpen%20the%20Valorx%20External%20Client%20App.gif?alt=media&amp;token=77589a72-7a62-4c0f-9e20-bf898eba48bf" alt=""><figcaption><p>Open the Valorx External Client App<br></p></figcaption></figure>
2. On the **Policies** tab, click **Edit**.
3. Under **OAuth Policies → Plugin Policies**, set **Permitted Users** to **Admin approved users are pre-authorized**. The profile and permission set selectors will appear.<br>

   <figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FWnSZeSNLWG2YcboJTvxj%2FEdit%20admin%20approval.gif?alt=media&amp;token=eab0184e-a507-45ce-925b-84a944746a82" alt=""><figcaption><p>Admin approved users are pre-authorized<br></p></figcaption></figure>
4. Choose how to grant access:
   * **By profile:** Move the required profiles to **Selected Profiles**. All users with those profiles can access Wave AI.
   * **By permission set:** Move a permission set to **Selected Permission Sets**. You can use an existing permission set created in your org, a cloned Valorx permission set, or a new permission set.
5. Click **Save**.<br>

   <figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FL9ymYCgG1oG8Y8q1N73r%2FChoose%20who%20can%20access%20Wave%20AI.gif?alt=media&amp;token=f1b641f7-97a5-4894-be61-f6eb9fa460c4" alt=""><figcaption><p>Choose who can access Wave AI</p></figcaption></figure>

{% hint style="info" %}

#### Using a Valorx Permission Set?&#x20;

Salesforce currently doesn't allow permission sets installed with a package to be selected here. In **Setup → Permission Sets**, select a Valorx permission set, such as Valorx Grid Standard User, click **Clone**, and save it with a new name. Select the clone in the External Client App and keep the original Valorx permission set assigned to users so they continue to receive updates. A new permission set for app access does not require any specific permissions.
{% endhint %}

{% hint style="danger" %}

#### Important

If you grant access by permission set, assign the selected permission set to every Wave AI user, including the administrator.
{% endhint %}

{% hint style="warning" %}

#### Using Login IP Ranges?&#x20;

If your profiles use Login IP Ranges, or **Enforce login IP ranges on every request** is enabled in Session Settings, add the Valorx IP addresses to your allowed ranges. Contact Valorx Support for the current list.
{% endhint %}

## Check the Valorx Named Credential

The Valorx Named Credential is enabled when the package is installed. In Salesforce **Setup**, search for **Named Credentials** and open **Valorx**. Make sure **Enabled for Callouts** is turned on. If it is off, click **Edit**, enable it, and click **Save**.

If callouts are disabled, Wave AI cannot communicate with the Valorx service.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F688Mtmx9XldIU9fknhs9%2FCheck%20the%20Valorx%20Named%20Credential.gif?alt=media&amp;token=1744a8f9-6f91-43eb-a83b-4db833cdf9d8" alt=""><figcaption><p>Check the Valorx Named Credential</p></figcaption></figure>

## Turn on Wave AI

In the **App Launcher**, open the **Valorx Wave** app and select the **Wave Admin** tab. Under **Settings**, click **Wave AI** and switch on the toggle.

Wait until the page displays **“Wave AI is ready to go.”** The page shows the sync progress. Small orgs may finish in minutes, while large orgs can take 30 minutes or more. You can leave the page while the sync runs and return later to check the result.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FJxG1WK7E1hPKoAB1IDIb%2FEnable%20Wave%20AI.gif?alt=media&amp;token=1e7ac5ca-b774-419a-9057-090f88be51ee" alt=""><figcaption><p>Turn on Wave AI</p></figcaption></figure>

#### After setup

Wave AI refreshes your org information automatically every **72 hours**. If you add or change objects, fields, or layouts, click **Sync Now** on the Wave AI settings page to make those changes available sooner. If a sync fails, the page displays **“Last sync failed”** with the failure time. Retry using **Sync Now**; if it fails again, contact Valorx Support.

Turning off Wave AI stops future refreshes, but an in-progress sync will finish.

{% hint style="info" %}

#### Sandbox Note

Each sandbox must have Wave AI enabled in its own Wave Admin. After a sandbox refresh, the External Client App and Named Credential settings carry over, so you only need to turn Wave AI on again.
{% endhint %}

## Test Wave AI

Open a grid in the **Surf the Wave** tab and test Wave AI. The AI chat panel should display **“Wave AI is ready! Start chatting below.”**

{% hint style="warning" %}
**Note:** The Wave AI chat panel appears only on grids. The user must have access to at least one grid.
{% endhint %}

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FGwPF3gdj91vKS6X5AO9U%2FTest%20Wave%20AI.gif?alt=media&amp;token=2d7b779c-7d5a-4f19-8447-43aac656eead" alt=""><figcaption><p>Wave AI</p></figcaption></figure>
