> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Treble in Salesforce

> In this guide, learn how to integrate Treble with Salesforce. This is something you only need to do once. Once configured, Treble will help you leverage the full potential of WhatsApp to sell more through your integration.

<Warning>
  To install the integration of your product with Salesforce, it is crucial that <u>the user has administrator permissions in the Salesforce org</u> ("System Administrator" profile or equivalent).

  A user with limited permissions (for example, a "Standard User" profile) won't have access to the APIs needed to complete the connection, and the integration will fail.
</Warning>

# Steps to install the Treble integration in Salesforce

1. Log in to <a class="article-link" href="https://app.treble.ai"><p>app.treble.ai</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a>
2. Go to Settings
3. Go to Integrations
4. Click on "Enable" in the Salesforce section

<img src="https://mintcdn.com/trebleai/1tKbg52VI1qrAl5B/images/install-sf.gif?s=db23e386e5030b30dd5acb2cc72c7490" alt="Install Treble in Salesforce" className="mx-auto" width="3010" height="1522" data-path="images/install-sf.gif" />

<Steps>
  <Step title="Choose the Salesforce environment">
    Treble lets you connect any Salesforce environment. Choose whether you're connecting your **Production** org or a **Sandbox** (usually used for testing, without affecting real data).

    <img src="https://mintcdn.com/trebleai/1tKbg52VI1qrAl5B/images/install-sf-1.png?fit=max&auto=format&n=1tKbg52VI1qrAl5B&q=85&s=97f4c63615713a8ef07769326d1a01bb" alt="Choose Salesforce environment" width="450" className="mx-auto" data-path="images/install-sf-1.png" />
  </Step>

  <Step title="Authenticate with Salesforce">
    Enter the Salesforce username you're going to connect the integration with and click "Confirm".

    <img src="https://mintcdn.com/trebleai/1tKbg52VI1qrAl5B/images/install-sf-2.png?fit=max&auto=format&n=1tKbg52VI1qrAl5B&q=85&s=99a9833346918b767dc8713c399737c5" alt="Salesforce authentication" width="450" className="mx-auto" data-path="images/install-sf-2.png" />

    This will open a Salesforce window where you must log in and authorize Treble's access to your org.
  </Step>

  <Step title="Configure the parent entity">
    Once access is authorized, go back to Settings → Integrations → Salesforce and click "Settings" to choose the parent entity (e.g. Contact or Account) that Treble will use to sync your contacts.

    <img src="https://mintcdn.com/trebleai/1tKbg52VI1qrAl5B/images/install-sf-3.png?fit=max&auto=format&n=1tKbg52VI1qrAl5B&q=85&s=e5b0ed5a46c23b69edd1021f5f088766" alt="Configure Salesforce parent entity" width="450" className="mx-auto" data-path="images/install-sf-3.png" />

    <Warning>
      Once the parent entity is configured, you won't be able to change it unless you uninstall and reinstall the integration.
    </Warning>

    Click "Save configuration" to continue.

    <Note>
      If your integration is of type **Salesforce Multiple Object**, this step looks different: instead of choosing a single parent entity, you'll see "Select objects to install" and can choose **several Salesforce objects** at once. For each object you select, you'll need to configure its phone field, name field, and owner field. The rest of the flow (authentication, agent selection, sync) is identical.
    </Note>
  </Step>

  <Step title="Select agents">
    Right after saving the configuration, Treble automatically opens a modal so you can choose which Salesforce users you want to turn into Treble agents.

    <img src="https://mintcdn.com/trebleai/1tKbg52VI1qrAl5B/images/install-sf-4.png?fit=max&auto=format&n=1tKbg52VI1qrAl5B&q=85&s=ef51ebd425ab7f833ce41862ace534c7" alt="Select Salesforce agents" width="450" className="mx-auto" data-path="images/install-sf-4.png" />

    You can search by name or email, select users one by one, or use "Select all". The counter at the top (e.g. "1/10 agents used") reflects your plan's limit — you won't be able to select more users than you have available.

    <Info>
      If you don't want to add agents right now, you can click "Don't import agents for now". Keep in mind this modal won't show up again afterward — if you want to add agents later, you'll have to do it manually, one by one. See [Create a new agent](/en/docs/agent-platform/admin/tags-teams#create-a-new-agent).
    </Info>

    <Warning>
      If you select the user you authenticated with in Salesforce, that agent will automatically be created with the **Admin** role. See [Agent Roles](/en/docs/agent-platform/admin/tags-teams#agent-roles) for more information.
    </Warning>

    On confirm, Treble creates the selected agents. If any of them couldn't be created (for example, because the email already exists as an agent), you'll see a summary showing which ones failed and why.

    <img src="https://mintcdn.com/trebleai/1tKbg52VI1qrAl5B/images/install-sf-5.png?fit=max&auto=format&n=1tKbg52VI1qrAl5B&q=85&s=758fd329a7daef5f34fd53d38d42a8e2" alt="Agent creation result" width="450" className="mx-auto" data-path="images/install-sf-5.png" />
  </Step>

  <Step title="Contact sync">
    After selecting your agents, Treble starts syncing your Salesforce contacts in the background. This process can take a while depending on the size of your contact base — in the meantime, you'll see the integration in "Processing" status.

    <Check>
      Congratulations! At this point, you have already integrated your company with Treble and Salesforce. Once the sync finishes, you'll see the integration as "Connected".
    </Check>
  </Step>
</Steps>