> ## 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.

# Instalar Treble no Salesforce

> Neste guia, aprenda como integrar o Treble com o Salesforce. Isso é algo que você só precisa fazer uma vez. Uma vez configurado, o Treble o ajudará a aproveitar todo o potencial do WhatsApp para vender mais através da sua integração.

<Warning>
  Para instalar a integração do seu produto com o Salesforce, é crucial que <u>o usuário tenha permissões de administrador na organização do Salesforce</u> (perfil "System Administrator" ou equivalente).

  Um usuário com permissões limitadas (por exemplo, um perfil "Standard User") não terá acesso às APIs necessárias para concluir a conexão, e a integração falhará.
</Warning>

# Passos para instalar a integração do Treble no Salesforce

1. Faça login em <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. Vá para Configurações
3. Vá para Integrações
4. Clique em "Habilitar" na seção do Salesforce

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

<Steps>
  <Step title="Escolher o ambiente do Salesforce">
    O Treble permite conectar qualquer ambiente do Salesforce. Escolha se você vai conectar sua organização de **Produção** ou um **Sandbox** (geralmente usado para testes, sem afetar dados reais).

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

  <Step title="Autenticar-se com o Salesforce">
    Insira o usuário do Salesforce com o qual você vai conectar a integração e clique em "Confirmar".

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

    Isso abrirá uma janela do Salesforce onde você deve fazer login e autorizar o acesso do Treble à sua organização.
  </Step>

  <Step title="Configurar entidade pai">
    Depois que o acesso for autorizado, volte para Configurações → Integrações → Salesforce e clique em "Configurações" para escolher a entidade pai (por exemplo, Contact ou Account) que o Treble vai usar para sincronizar seus contatos.

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

    <Warning>
      Depois de configurada a entidade pai, você não poderá modificá-la a menos que desinstale e reinstale a integração.
    </Warning>

    Clique em "Salvar configuração" para continuar.

    <Note>
      Se sua integração for do tipo **Salesforce Multiple Object**, este passo é diferente: em vez de escolher uma única entidade pai, você verá "Selecionar objetos para instalar" e poderá escolher **vários objetos do Salesforce** de uma vez. Para cada objeto selecionado, você precisará configurar seu campo de telefone, campo de nome e campo de proprietário. O restante do fluxo (autenticação, seleção de agentes, sincronização) é idêntico.
    </Note>
  </Step>

  <Step title="Selecionar agentes">
    Logo após salvar a configuração, o Treble abre automaticamente um modal para que você escolha quais usuários do Salesforce deseja transformar em agentes do Treble.

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

    Você pode buscar por nome ou email, selecionar usuários um por um ou usar "Selecionar todos". O contador no topo (por exemplo, "1/10 agentes usados") reflete o limite do seu plano — você não poderá selecionar mais usuários do que tiver disponível.

    <Info>
      Se não quiser adicionar agentes agora, pode clicar em "Não importar agentes por enquanto". Lembre-se de que esse modal não aparece novamente depois — se quiser adicionar agentes mais tarde, terá que fazer isso manualmente, um por um. Consulte [Criar um novo agente](/pt/docs/agent-platform/admin/tags-teams#criar-um-novo-agente).
    </Info>

    <Warning>
      Se você selecionar o usuário com o qual se autenticou no Salesforce, esse agente será criado automaticamente com a função de **Administrador**. Consulte [Funções dos agentes](/pt/docs/agent-platform/admin/tags-teams#funcoes-dos-agentes) para mais informações.
    </Warning>

    Ao confirmar, o Treble cria os agentes selecionados. Se algum não puder ser criado (por exemplo, porque o email já existe como agente), você verá um resumo indicando quais falharam e por quê.

    <img src="https://mintcdn.com/trebleai/1tKbg52VI1qrAl5B/images/install-sf-5.png?fit=max&auto=format&n=1tKbg52VI1qrAl5B&q=85&s=758fd329a7daef5f34fd53d38d42a8e2" alt="Resultado da criação de agentes" width="450" className="mx-auto" data-path="images/install-sf-5.png" />
  </Step>

  <Step title="Sincronização de contatos">
    Depois de selecionar seus agentes, o Treble começa a sincronizar seus contatos do Salesforce em segundo plano. Esse processo pode demorar dependendo do tamanho da sua base de contatos — enquanto isso, você verá a integração no status "Processando".

    <Check>
      Parabéns! Neste ponto, você já integrou sua empresa com o Treble e o Salesforce. Quando a sincronização terminar, você verá a integração como "Conectado".
    </Check>
  </Step>
</Steps>