# Salesforce

> Each call can update the caller's Salesforce lead, contact, account or opportunity and log the call on it — reviewed first or written automatically.

Source: https://app.activelens.ai/help/salesforce

Salesforce is connected once for the whole workspace, by an admin, from
**Integrations → Salesforce**. Once it is connected, after each call a
**Salesforce** card finds the caller in Salesforce and the record the call is
about, fills in the fields you chose from what was said, and logs the call on
them.

## Setting up Salesforce

The setup takes an admin through five steps:

1. **Connect your Salesforce organization.** Sign in to Salesforce as an
   administrator, or as a user with "Approve Uninstalled Connected Apps", and
   press **Allow**. Below the button you can instead connect
   a Salesforce sandbox, or **Sign in at your company's Salesforce
   domain** — the address that ends in .my.salesforce.com. ActiveLens reaches
   only what the connecting user can see, so connect as a user who holds
   "Modify All Data"; the page warns you when they don't.
2. **Match your team to Salesforce users.** Members are matched to Salesforce
   users by email; choose one by hand where the emails differ, or **Use
   automatic** to go back to the email match.
3. **Your first setups.** Choose what calls update — see **Setups** below.
   Names, record types and the fields a call fills in are on the settings
   page.
4. **How Salesforce is updated.** **Review first**, **Log & review** or
   **Automatic** — see below.
5. **Ready.** Check what calls will update and press **Finish**.

**Skip all** keeps every setting as it is and goes straight to the settings
page. **Run setup again** on the Salesforce page takes you back through the
steps later.

## Salesforce sharing

**Respect Salesforce sharing** is on by default: each person finds and
updates only the records their own Salesforce user may, and a member who
isn't matched to an active Salesforce user gets no Salesforce cards. The
page counts the members who aren't matched, and **Salesforce users** lists
them.

With it off, everyone finds and updates what the connected Salesforce user
may, and members with no Salesforce user get cards too.

## After a call

By default, every call or meeting of 30 seconds or more gets a **Salesforce**
card among the call's actions. It works in steps:

1. **Find the record** — the caller's lead, contact or person account, found
   by their phone number, then a number said on the call, then their name;
   for a meeting, by the invite's emails, then names. Then the record the call
   is about in one of your setups — for example one of the account's open
   opportunities. When several people share the number, the card asks who
   called, by default. When the caller isn't in Salesforce yet, the card
   offers a new lead, contact or person account, as your setups allow.
2. **New record** — only when one is being created, filled in from the call.
3. **The fields** — one step per group of fields the setup fills, with values
   from what was said.
4. **Convert the lead** — only for a lead whose setup offers it; see **Lead
   conversion** below.
5. **Summary** — the notes the call is logged with.

The card says why it picked its record and how sure it is. To pick another
one, choose from the caller's records, press **Start in another setup**, or
press **Search Salesforce** and search by a name, a phone number, an email or
a record's name. Opportunities and accounts show only when one of your setups
covers them.

**Do It Now** writes everything to Salesforce at once: the fields, any new
record, the status or stage the setup moves the record to, and the call,
logged as a task — or, for a meeting, an event — with the call's summary.

## Review first or Automatic

The first section of the Salesforce page, **How Salesforce is updated**,
decides what happens next:

- **Review first** (the default) — the card waits on the board until someone
  checks it and presses **Do It Now**. Nothing reaches Salesforce before that.
- **Log & review** — the call is logged on the caller's lead, contact or
  person account right after the call, and on the account or opportunity
  when there is only one or the AI is sure; fields, statuses, stages and new
  records wait on the card. It is logged only when exactly one record has the
  caller's number or email — two on one number, or none, and nothing is
  logged and the card says why.
- **Automatic** — Salesforce is updated right after the call.

In **Automatic**, the card waits for a person instead when the caller was
found only by their name, several people share the number (**Several people
on one number** set to Ask), the AI isn't sure enough which record the call
is about (**Write only when the AI is** Very sure or Fairly sure), there are
no notes to write, the person who took the call can't edit the record, or
Salesforce refuses a value. Two more are switches, both on by default: **A new
lead, contact, person account or opportunity would be created**, and **A
required field is empty**.

With **Tell the person who took the call** on, they get an email saying what
was written to Salesforce, or why the card waits. **Automatic** never
converts a lead.

## Setups

A setup says what a call updates:

- **A lead** — the caller's lead, or a new one when they aren't in Salesforce
  yet.
- **The caller's contact** — its fields, and the call logged on it.
- **The caller's person account** — for people kept as person accounts.
- **The caller's account** — the account the caller's contact belongs to.
- **An opportunity** — one of the account's open opportunities, or a new one
  when there is none.

A new workspace starts with a lead and a contact setup and can have up to 10.
A setup's kind is chosen when it is added; for another kind, add another
setup. In each setup you choose its name, the **Record types it covers**, the
teams whose calls use it, the fields to update and the status or stage the
record gets after the call, whether a new record can start there, and how
the call is logged.

Each field is filled by the AI from the call, with the same value every time,
with the day of the call, or left for the person on the card. Fields
Salesforce fills in by itself — formulas, roll-ups, auto-numbers — are shown
greyed, with the reason.

## Lead conversion

Turn on **Offer “Convert this lead” on the card** in a lead setup, and the
card gets a **Convert the lead** step. It starts off on every call; turned
on, it asks for the **Converted status** and the account — a new one named
after the lead's company, or an account Salesforce already has by that name —
and makes an opportunity only when asked. The lead becomes a new contact on
the account.

The conversion runs right after the write. If Salesforce doesn't convert the
lead, the lead's changes and the call are still saved: convert it in
Salesforce, or press **Try converting again**. A converted lead has no undo.

## Undo

After a write, the card shows what changed, with links into Salesforce.
**Undo field changes** puts them back for 10 minutes; a field someone changed
in Salesforce since is left as it is. The logged task or event stays in
Salesforce, and a new record or a converted lead has no undo — change it in
Salesforce.

## Caller lookup

After a call, ActiveLens looks the caller up in Salesforce by their number, or
by a meeting attendee's email. What it finds shows on the left of the call
page, with a link to open it, and the desktop app shows the same thing during
a call. Nothing is written to Salesforce.

It is on by default. To stop it, turn off **Caller lookup** on
**Integrations → Salesforce**.

## Ask Anything

Switch on **Answer from Salesforce records** to let Ask Anything answer from
your Salesforce leads, contacts, accounts and opportunities, alongside calls
and the knowledge base. Choose how many records to keep, which kinds, whether
an answer may read a record's tasks and events, how often to look for changes,
and who can ask. ActiveLens keeps each record's details and a two-sentence
summary, never its tasks, events, emails or phone numbers; the record itself
stays in Salesforce and is read when an answer needs it. While Salesforce
sharing is respected, each person gets answers only from records their own
Salesforce user may see. Pick **Salesforce** under **Search in** to ask about
your Salesforce records only.

Turning it off, or **Delete scanned data**, deletes everything that was kept.

## Your own calls

Each member can turn on **Don't add Salesforce cards for my calls** on the
Salesforce page: their calls get no card after the call, and they can still
add one from **+** on the board. The page also shows which Salesforce user
they are matched to.

## Disconnect Salesforce

**Disconnect** on the Salesforce page gives up ActiveLens's access to your
Salesforce organization. It also removes the Salesforce settings, what Ask
Anything kept, the users matched by hand and everyone's **Don't add
Salesforce cards for my calls** switch, so connecting again starts the setup
anew. Calls stay in ActiveLens, and your Salesforce records are not changed.

## Troubleshooting

- **A call got no Salesforce card** — it was shorter than the shortest call,
  a sample, private or trashed call; the call taker isn't matched to a
  Salesforce user while sharing is respected, or turned their cards off; no
  setup serves their team; or your plan doesn't include AI action execution —
  see [Plans and billing](/help/plans-and-billing). Otherwise, add one from
  **+** on the call.
- **"Waiting for you" on an automatic card** — read why on the card, fix it
  and press **Do It Now**.
- **"Salesforce needs to be reconnected"** — Salesforce no longer accepts the
  workspace's access, often because ActiveLens was blocked there or the user
  who connected it was deactivated. Press **Reconnect Salesforce**.
- **The connect page stopped on a Salesforce error** — only a Salesforce
  administrator, or a user allowed to approve connected apps, can connect.

## Related

- [Connect an integration](/help/connecting-an-integration)
- [Actions on a call](/help/action-items)
- [My call did not appear](/help/call-not-showing-up)
