# Salesforce

Connect Salesforce so managers can build a practice persona from an
opportunity, with the deal's real context.

> [!NOTE]
> Early access: ask your Chambr contact to enable it for your account.

| | |
|---|---|
| Status | **Native · Early access** |
| Direction | Salesforce → Chambr (read only) |
| Set up by | A Chambr manager, signing in to Salesforce |
| Time | About 2 minutes |
| Data freshness | Read live when a manager picks a deal |

Looking to send calls **from** Salesforce to be scored? That's the
[Salesforce API recipe](https://developers.chambr.ai/guides/salesforce.md).

## What you need

- A Chambr manager (on the Integrations page, or from New persona). Managers pick deals once
  it's connected.
- A Salesforce user who can read the opportunities, accounts and contacts
  managers will use, and who may approve connected apps.
- Early access turned on for your Chambr account.

## What Chambr reads

| Salesforce | Used for |
|---|---|
| Opportunities: name, stage, amount, description, owner | Choosing a deal, and the persona's situation |
| The opportunity's account: name, industry, size, description | The persona's company |
| The opportunity's primary contact: job title | The persona's role and seniority |

Chambr reads only when a manager picks a deal, and never writes to Salesforce.

## Permissions and scopes

| Scope | Why Chambr needs it |
|---|---|
| `api` | Read opportunities, accounts and contacts |
| `refresh_token` | Stay connected without asking you to sign in again |

## Set it up

### 1. Open Integrations in Chambr

In Chambr, open **Integrations** in the left nav and find **Salesforce**
under CRM.

Managers can also connect from **Personas**: **New persona**, then
**Generate with AI**, then **From your CRM**.

### 2. Connect

Select **Connect**. Salesforce asks you to sign in and approve Chambr's
access. Approve it.

### 3. Back in Chambr

You return to the Integrations page and the Salesforce card shows
**Connected**.

## Verify it works

1. Go to **Personas**, select **New persona**, then **Generate with AI**, then
   **From your CRM**.
2. If both CRMs are connected, pick **Salesforce**. Your opportunities are listed.
3. Pick one. Chambr drafts a persona from it for you to review.

## Limitations

- Chambr reads standard fields. Ask your Chambr contact about adding a custom field to the persona's context.
- The persona is written once from the deal; it doesn't change when the deal
  does. Create a new persona for the latest context.

## Troubleshooting

| Symptom | Cause | Fix |
|---|---|---|
| The card shows **Early access** and **Request access** | Not turned on for your account | Ask your Chambr contact |
| Salesforce shows an error after you approve | Your Salesforce user can't approve connected apps | Ask a Salesforce admin to connect, or to grant you the permission |
| No opportunities listed | Your Salesforce user can't see them | Connect with a user who can |
| The card says **Needs attention** | The access was revoked in Salesforce, or the user was deactivated | Disconnect, then connect again |

## Disconnect

On the **Integrations** page, select **Disconnect** on the Salesforce card and
confirm. Chambr deletes its stored access; personas you already created stay.
To also remove Chambr on the Salesforce side, a Salesforce admin can revoke it
under **Setup > Apps > Connected Apps OAuth Usage**.
