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

> ## Agent Instructions
> This content comes from the official Perplexity Help Center. Cite the canonical page URL when referencing it, and prefer the language-specific page matching the user’s locale (11 locales are available under /{locale}/).

# Conectando o Perplexity ao Salesforce

> Configure o conector do Salesforce com um External Client App da sua organização para o Perplexity ler e atualizar seus registros de CRM.

Este guia mostra aos administradores do Salesforce e do Perplexity como conectar uma
organização Salesforce ao Perplexity, e explica aos assinantes dos planos Pro, Max,
Enterprise Pro e Enterprise Max como fazer login. Nos planos Pro e Max, sem uma
organização no Perplexity, você mesmo conclui a configuração no Perplexity.

## Visão geral

O conector do Salesforce permite que o Perplexity leia e atualize seus dados de
gestão de relacionamento com o cliente (CRM). Ele pode consultar contas, contatos, leads,
oportunidades e objetos personalizados, executar consultas em Salesforce Object Query Language (SOQL),
pesquisar registros e criar, atualizar ou excluir registros. O conector
usa o servidor de protocolo de contexto de modelo (MCP) hospedado do Salesforce (SObject All), portanto cada solicitação é executada como o
usuário conectado ao Salesforce, com as permissões que esse usuário já possui.

A configuração tem duas partes:

1. Seu administrador do Salesforce ativa o servidor MCP e cria um
   External Client App para o Perplexity na sua organização Salesforce. Isso é feito uma única vez
   e leva cerca de 20 minutos. Depois disso, um novo aplicativo pode levar até 30 minutos para
   começar a funcionar.

2. Um administrador da sua organização no Perplexity adiciona a Consumer
   Key desse aplicativo nas configurações de conectores da organização. Isso também é feito uma única vez.
   Depois disso, cada pessoa conecta sua própria conta Salesforce. Nos planos Pro
   e Max, você mesmo adiciona a Consumer Key na guia **Gerenciar configuração**
   do conector.

Seu administrador do Salesforce conclui a primeira parte. O administrador da sua
organização no Perplexity, ou você mesmo nos planos Pro e Max, conclui a segunda.
A equipe do Perplexity não precisa de acesso à sua organização Salesforce.

> [!NOTE]
>
> O conector do Salesforce está disponível nos planos Pro, Max, Enterprise Pro e
> Enterprise Max. Sua organização Salesforce precisa ser Enterprise Edition ou superior,
> ou uma organização Developer Edition para testes.

## Privacidade e segurança de dados

O Perplexity acessa o Salesforce apenas como o usuário que se conectou, portanto as
permissões do Salesforce delimitam o que o Perplexity pode ver ou alterar.

* **Escopo de acesso** — Perfis, conjuntos de permissões, segurança em nível de campo e
  regras de compartilhamento continuam valendo. Os usuários não podem ver nem alterar pelo
  Perplexity nada que já não pudessem ver ou alterar no Salesforce.

* **Trilha de auditoria** — As alterações feitas pelo Perplexity aparecem na trilha de auditoria
  do Salesforce em nome do usuário. O tráfego MCP aparece nos logs de API do Salesforce com
  `API_CLIENT_CATEGORY = SALESFORCE_HOSTED_MCP`.

* **Conexão direta** — O Perplexity se conecta diretamente ao Salesforce com o
  External Client App da sua própria organização Salesforce. Não há nenhum serviço de integração de terceiros
  como intermediário.

* **Controle do administrador** — Seu administrador do Salesforce pode revogar todo o
  acesso a qualquer momento, desativando o servidor MCP ou bloqueando o External
  Client App. Nos planos Enterprise, o administrador da sua organização no Perplexity também pode desativar
  o conector para a organização. Desativá-lo bloqueia o conector, mas mantém os
  tokens de login armazenados dos usuários até que cada usuário se desconecte. Para
  remover o acesso de todos de uma vez, bloqueie o External Client App no Salesforce.

* **Onde os dados ficam armazenados** — O Perplexity não mantém uma cópia separada dos
  seus registros do Salesforce. Os resultados que aparecem em uma sessão são salvos com essa
  sessão e seguem suas configurações de retenção de sessões. Consulte [Retenção de dados para
  Enterprise](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/11652701-retencao-de-dados-para-enterprise.md).

* **Uso para treinamento** — Os dados acessados por meio do conector do Salesforce nunca são
  usados para treinar os modelos do Perplexity nem qualquer modelo de terceiros.

* **Criptografia** — As credenciais do conector são criptografadas em trânsito com TLS
  e criptografadas em repouso.

* **Conformidade** — Os controles do Perplexity são auditados sob a SOC 2 Type II.
  A documentação de segurança e conformidade está disponível na [Central de Confiança da Perplexity](https://trust.perplexity.ai/).

## Como ativar

### Antes de começar

* Você está no plano Pro, Max, Enterprise Pro ou Enterprise Max.

* Você conta com um administrador do sistema Salesforce para a organização que deseja conectar.

* Nos planos Enterprise, você conta com um administrador da sua organização no
  Perplexity que pode gerenciar as configurações de conectores. Nos planos Pro e Max, você mesmo
  adiciona a Consumer Key.

* Sua organização pode usar os servidores MCP hospedados do Salesforce. O Salesforce destina os servidores
  MCP hospedados a clientes com Flex Credits, e o uso dos servidores pode ser cobrado.
  Confirme com seu executivo de contas do Salesforce. Consulte [Servidores MCP hospedados
  do Salesforce: primeiros
  passos](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/hosted-mcp-servers-overview.html)
  e [Uso faturável de Flex Credits](https://help.salesforce.com/s/articleView?language=en_US\&id=ai.usage_flex_credits.htm\&type=5).

> [!NOTE]
>
> Os servidores MCP hospedados do Salesforce aceitam apenas External Client Apps criados dentro
> da sua própria organização. Connected Apps e o registro automático de clientes não são
> compatíveis, por isso o Perplexity não pode fornecer um aplicativo compartilhado para todos os clientes. Consulte [Práticas recomendadas de segurança para servidores MCP hospedados do Salesforce](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/security-best-practices.html).

### Etapa 1: Ativar o servidor MCP SObject All (administrador do Salesforce, cerca de 2 minutos)

> [!TIP]
>
> Para experimentar primeiro, teste com uma [organização Salesforce Developer Edition](https://developer.salesforce.com/signup) gratuita antes de configurar o ambiente de produção.

1. Faça login no Salesforce em `login.salesforce.com`
   ou na URL do seu My Domain, como `https://yourcompany.my.salesforce.com`.

2. Clique no ícone de engrenagem no canto superior direito.

3. Escolha **Setup**.

[![Menu de engrenagem do Salesforce com Setup em destaque](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_setup_menu.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=f3df13563e3f357430ceaf3e1f64e539)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_setup_menu.png)

Figura 1 — O menu de engrenagem abre o Setup do Salesforce.

4. Em **Quick Find**, digite **MCP Servers** e abra **Integrations → API Catalog
   → MCP Servers**. Todos os servidores padrão começam com o status **Inactive**. O banner
   amarelo é o aviso de cobrança de Flex Credits do Salesforce.

[![Lista MCP Servers em Setup do Salesforce, com SObject All no status Active e os demais servidores padrão no status Inactive](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_servers_list.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=85a286319bd12d1b95a1342094acf2fb)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_servers_list.png)

Figura 2 — A lista MCP Servers, com SObject All ativo e os demais servidores padrão inativos.

5. Abra **SObject All**.

6. Clique em **Activate**. Quando a ativação terminar, o status será **Active** e o
   botão mudará para **Deactivate**.

7. Deixe todos os outros servidores desativados.

[![SObject All antes da ativação, com Activate destacado](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_sobject_all.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=e30addc3c5dcc2b3d7993b54f0707143)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_sobject_all.png)

Figura 3 — SObject All antes da ativação, com Activate destacado.

Consulte [Ativar servidores MCP padrão do Salesforce em API Catalog](https://help.salesforce.com/s/articleView?id=platform.api_catalog_activate_salesforce_mcp_servers.htm\&language=en_US\&type=5)
e a [referência de SObject All](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/sobject-all.html).

> [!NOTE]
>
> O Perplexity usa SObject All em vez de SObject Reads para poder criar e
> atualizar registros. Cada chamada continua sendo executada com o perfil, a segurança em nível de campo
> e as regras de compartilhamento do próprio usuário.

### Etapa 2: Criar o External Client App (administrador do Salesforce, cerca de 10 minutos)

As tabelas desta etapa e da próxima classificam cada configuração:

* **Bloqueada**: Exigida pelo Salesforce. Para alterá-la, é preciso entrar em contato com o suporte do Salesforce.
* **Obrigatória**: O conector não funciona sem ela.
* **A seu critério**: Funciona de qualquer uma das formas.
* **Manter desativada**: Funciona se ativada, mas aumenta o risco.
* **Testar primeiro**: É possível, mas teste primeiro em um ambiente de sandbox ou em uma organização Developer Edition.

1. Em **Quick Find** de Setup, digite **External Client App Manager** e abra a página.

2. Clique em **New External Client App**.

[![External Client App Manager com o botão New External Client App](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_eca_manager.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=4a48f7a2c614b4356232653c39b9c2b2)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_eca_manager.png)

Figura 4 — External Client App Manager, onde você cria o aplicativo do Perplexity.

3. Preencha **Basic Information**:

   | Campo | Valor | É possível alterar? |
   | - | - | - |
   | **External Client App Name** | `Perplexity` | A seu critério |
   | **API Name** | `Perplexity` | A seu critério |
   | **Contact Email** | Uma lista de distribuição de TI | A seu critério |
   | **Distribution State** | **Local** | Obrigatória |
   | **Info URL** | `https://www.perplexity.ai` (opcional) | A seu critério |
   | **Description** | Permite que o Perplexity execute ferramentas MCP hospedadas do Salesforce em nome dos usuários conectados. | A seu critério |

   *Tabela 1 — Configurações de Basic Information para o External Client App do Perplexity.*

[![Seção Basic Information com o nome do aplicativo Perplexity e Distribution State definido como Local](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_eca_basic_info.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=c2d3b693af2339dce83cd2599d8be425)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_eca_basic_info.png)

Figura 5 — Basic Information para o External Client App do Perplexity.

4. Expanda **API (Enable OAuth Settings)** e selecione **Enable OAuth**.

5. **Callback URL** (obrigatório): cole as duas URLs abaixo, uma por linha, exatamente como
   estão escritas. Qualquer diferença faz o login falhar com `redirect_uri_mismatch`.

   ```text theme={null}
   https://www.perplexity.ai/rest/connections/oauth_callback
   https://enterprise.perplexity.ai/rest/connections/oauth_callback
   ```

6. **OAuth Scopes** (obrigatório): mova exatamente dois escopos para **Selected OAuth
   Scopes**:

   * **Access Salesforce hosted MCP servers (mcp\_api)**
   * **Perform requests at any time (refresh\_token, offline\_access)**

   Deixe **Introspect all Tokens** e **Configure ID token** desmarcados. Você
   usará o botão **Consumer Key and Secret** mostrado aqui na Etapa 4.

[![OAuth Settings com as duas URLs de retorno do Perplexity e os escopos mcp\_api e refresh\_token selecionados](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_eca_oauth_settings.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=d45db1d53ddcb4e0cdfbc978df66e19e)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_eca_oauth_settings.png)

Figura 6 — Configurações de OAuth com as duas URLs de retorno e os dois escopos obrigatórios.

7. Configure **Flow Enablement** e **Security**:

   | Configuração | Valor | Motivo | É possível alterar? |
   | - | - | - | - |
   | **Flow Enablement** (todas as 5 opções) | Desativado | O conector não usa essas opções. Ativá-las apenas abre mais formas de acesso. | Manter desativada |
   | **Require secret for Web Server Flow** | Desativado | O Perplexity usa um cliente público com PKCE. Se ativar esta opção, compartilhe o Consumer Secret junto com a chave. O formulário de configuração do Perplexity aceita esse valor. | A seu critério |
   | **Require secret for Refresh Token Flow** | Desativado | O mesmo que acima. | A seu critério |
   | **Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows** | Ativado | Exigida pelo Salesforce. Para alterá-la, é preciso entrar em contato com o suporte do Salesforce. | Bloqueada |
   | **Enable Refresh Token Rotation** | Ativado | Exigida pelo Salesforce. Para alterá-la, é preciso entrar em contato com o suporte do Salesforce. | Bloqueada |
   | **Issue JSON Web Token (JWT)-based access tokens for named users** | Ativado | Sem esta opção, o login funciona, mas todas as chamadas MCP retornam 401. | Obrigatória |
   | **Limit Idle Refresh Token Time-to-Live (TTL) to 30 Days** | Ativado | Exigida pelo Salesforce. Para alterá-la, é preciso entrar em contato com o suporte do Salesforce. | Bloqueada |
   | **Enforce Refresh Token IP Allowlist** | Desativado | As renovações de tokens vêm dos servidores do Perplexity, não das redes dos seus usuários, por isso uma lista de permissões pode bloqueá-las. | Manter desativada |

   *Tabela 2 — Configurações de Flow Enablement e Security para o External Client App do Perplexity.*

[![Configurações de Flow Enablement e Security com PKCE e tokens de acesso baseados em JWT selecionados](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_eca_security.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=8796874a25ebb88f75d99b803b4f0157)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_eca_security.png)

Figura 7 — Configurações de Flow Enablement e Security para o aplicativo do Perplexity.

8. Deixe as configurações de **SAML**, **Canvas**, **Mobile** e **Push Notification**
   desativadas e clique em **Create**.

[![Configurações de SAML, Canvas, Mobile e Push Notification todas desativadas](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_eca_other_settings.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=2eb476106c11b07af5d6a39defa3847b)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_eca_other_settings.png)

Figura 8 — Configurações de SAML, Canvas, Mobile e Push Notification mantidas desativadas.

Consulte [Criar um External Client App para servidores MCP hospedados](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/create-external-client-app.html)
e [Configurar as opções de OAuth do External Client App](https://help.salesforce.com/s/articleView?id=xcloud.configure_external_client_app_oauth_settings.htm\&language=en_US\&type=5).

### Etapa 3: Definir políticas (administrador do Salesforce, cerca de 3 minutos)

Abra o aplicativo, acesse **Policies** e clique em **Edit**.

| Configuração | Recomendação | Motivo | É possível alterar? |
| - | - | - | - |
| **Permitted Users** | **All users can self-authorize** | Cada pessoa faz login com sua própria conta, portanto as permissões do Salesforce continuam valendo. Para restringir o acesso, selecione **Admin approved users are pre-authorized** e atribua um conjunto de permissões. | A seu critério |
| **IP Relaxation** | **Relax IP restrictions**, se algum perfil tiver intervalos de IP para login | Sem intervalos de IP para login, **Enforce IP restrictions** também funciona. | A seu critério |
| **Refresh Token Policy** | A seu critério, por exemplo, expirar após 30 dias sem uso | 30 dias ou menos, com rotação. | A seu critério |
| **Named User JWT token timeout** | Use the user's default session timeout | Padrão do Salesforce. | A seu critério |
| **Start Page** | Nenhuma | Padrão do Salesforce. | A seu critério |
| **Single Logout** | Desativado | Você pode ativar esta opção depois para encerrar as sessões assim que alguém sair. | A seu critério |
| **High Assurance Session Required** | Desativado | Pode exigir uma verificação de login adicional, como autenticação multifator (MFA), que as tarefas agendadas não conseguem concluir. | Testar primeiro |

*Tabela 3 — Configurações de política recomendadas para o External Client App do Perplexity.*

> [!NOTE]
>
> O Salesforce recomenda uma política de token de atualização de 30 dias ou menos com rotação.
> Um limite menor faz com que as pessoas que usam [Tarefas agendadas no Computer](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/11521526-tarefas-agendadas-no-computer.md)
> precisem se reconectar com mais frequência. Não escolha **Immediately expire refresh token**, porque
> as tarefas agendadas falhariam.

[![Configurações de App Authorization: política de token de atualização, flexibilização de IP e tempo limite do token JWT](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_policies_app_authorization.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=29d1480bee5592407c595dc4fce37242)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_policies_app_authorization.png)

Figura 9 — Configurações de política de App Authorization.

[![Opções de Permitted Users: All users can self-authorize e Admin approved users are pre-authorized](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_eca_permitted_users.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=10e789a201ca669863d07c945fe5269a)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_eca_permitted_users.png)

Figura 10 — Opções de Permitted Users para o aplicativo do Perplexity.

Clique em **Save** quando terminar.

Consulte [Gerenciar External Client Apps](https://help.salesforce.com/s/articleView?id=xcloud.manage_external_client_apps.htm\&language=en_US\&type=5), [Rotação de tokens de atualização](https://help.salesforce.com/s/articleView?id=005316711\&language=en_US\&type=1)
e [Práticas recomendadas de segurança para servidores MCP hospedados do Salesforce](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/security-best-practices.html).

### Etapa 4: Compartilhar a Consumer Key (administrador do Salesforce, cerca de 2 minutos)

1. No aplicativo, abra **Settings → OAuth Settings → Consumer Key and Secret**
   (mostrado na Etapa 2.6). O Salesforce envia um código de verificação por e-mail.

2. Copie a **Consumer Key**. Se você ativou **Require secret for Web Server
   Flow** ou **Require secret for Refresh Token Flow** na Etapa 2.7, copie também
   o **Consumer Secret**.

3. Nos planos Enterprise, envie a chave e, se o tiver copiado, o segredo ao administrador
   da sua organização no Perplexity pelo seu gerenciador de senhas ou por outro canal
   aprovado para compartilhar segredos. Nos planos Pro ou Max, sem uma organização
   no Perplexity, envie-os da mesma forma à pessoa que concluirá a Etapa 5,
   ou guarde-os no seu gerenciador de senhas se essa pessoa for você.

> [!WARNING]
>
> Nunca envie a Consumer Key ou o Consumer Secret por chat comum ou e-mail.

> [!NOTE]
>
> Um novo External Client App pode levar até 30 minutos para começar a funcionar. Até
> lá, o login falha com `invalid_client_id`.

### Etapa 5: Adicionar a Consumer Key ao Perplexity (Enterprise: administrador da sua organização no Perplexity, cerca de 5 minutos)

Estas configurações se aplicam apenas à sua organização. Outras organizações usam seu
próprio External Client App e suas próprias configurações.

1. No Perplexity, abra **Configurações da organização → [Conectores](https://www.perplexity.ai/account/org/connectors)**.

2. Procure **Salesforce**.

3. Selecione o conector cuja descrição começa com "Consulte, pesquise, crie
   e atualize registros do CRM Salesforce." Se ele não aparecer, o novo conector do Salesforce
   ainda não está disponível para sua organização.

4. Clique em **Gerenciar configuração**. Se o botão não aparecer, abra o menu **Mais opções**
   da linha e escolha **Gerenciar configuração**.

5. Escolha **Usar configuração personalizada da organização**. Se **Método de configuração** aparecer,
   selecione **Inserir credenciais manualmente**.

6. Cole a **Consumer Key**. Deixe o **Consumer Secret** em branco, a menos que você
   tenha ativado uma exigência de segredo na Etapa 2.7.

[![Formulário Gerenciar configuração do Salesforce no Perplexity com Inserir credenciais manualmente selecionado e os campos Consumer Key e Consumer Secret](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_perplexity_setup_form.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=ed446ec9cdbff711748ead26b7bfcc4f)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_perplexity_setup_form.png)

Figura 11 — O formulário de configuração do Salesforce no Perplexity.

7. Opcional: se sua organização usa login único, insira as URLs do seu My Domain para que os usuários
   acessem diretamente a página de login da empresa em vez de clicar em **Use Custom
   Domain**:

   * **Authorization Endpoint**:
     `https://yourcompany.my.salesforce.com/services/oauth2/authorize`

   * **Token Endpoint**:
     `https://yourcompany.my.salesforce.com/services/oauth2/token`

   * **Revocation Endpoint**:
     `https://yourcompany.my.salesforce.com/services/oauth2/revoke`

   Substitua `yourcompany` pelo nome do seu My Domain. Você pode encontrá-lo em
   **Setup** do Salesforce, em **My Domain**. Deixe esses campos em branco para usar
   `login.salesforce.com`.

8. Clique em **Salvar configuração** e, depois, em **Continuar** para confirmar.

Você também pode abrir o conector do Salesforce e clicar em **Abrir configurações do conector**
no cartão **Configuração da organização necessária** para acessar a mesma configuração.

> [!NOTE]
>
> Você pode alterar a Consumer Key ou as URLs do My Domain depois em **Gerenciar configuração**.
> Alterar a configuração desconecta os membros que já se conectaram, então eles precisam
> se reconectar depois.

### Etapa 5 (sem uma organização no Perplexity): Adicionar a Consumer Key por conta própria (cerca de 5 minutos)

Se você está no plano Pro ou Max e não faz parte de uma organização no Perplexity, você mesmo adiciona
a Consumer Key do seu próprio External Client App. Você ainda precisa de um administrador do sistema
Salesforce para concluir as Etapas 1 a 4. Se você não tem uma organização Salesforce
da empresa, pode criar uma [organização Salesforce Developer Edition](https://developer.salesforce.com/signup) gratuita.
Você será o administrador do sistema dessa organização, então poderá concluir as Etapas 1 a 4 por conta própria.

1. Abra o [conector do Salesforce](https://www.perplexity.ai/computer/connectors?connector=salesforce_mcp).
   O conector mostra **Configuração pessoal necessária**.

2. Abra a guia **Gerenciar configuração** e escolha **Usar configuração personalizada**. Se **Método de configuração**
   aparecer, selecione **Inserir credenciais manualmente**.

3. Cole a **Consumer Key**. Deixe o **Consumer Secret** em branco, a menos que você
   tenha ativado uma exigência de segredo na Etapa 2.7. Se quiser, adicione as URLs do seu My Domain,
   conforme descrito na Etapa 5.7.

4. Clique em **Salvar configuração** e, depois, em **Continuar** para confirmar. Em seguida, prossiga para
   a Etapa 6.

Esta configuração se aplica apenas a você.

### Etapa 6: Conectar sua conta (cada usuário)

1. Abra o [conector do Salesforce](https://www.perplexity.ai/computer/connectors?connector=salesforce_mcp)
   no Perplexity e clique em **Adicionar conector** (ou **Conectar**).

2. Faça login no Salesforce e aprove o acesso. Se URLs do My Domain foram adicionadas
   na Etapa 5, você acessará diretamente a página de login da empresa.
   Caso contrário, se sua empresa usa login único, clique em **Use Custom Domain**
   na página de login do Salesforce, insira o domínio da empresa, como
   `yourcompany`, e faça login. Consulte [Usar a URL de login correta](https://help.salesforce.com/s/articleView?id=xcloud.getstart_login_urls.htm\&language=en_US\&type=5).

[![Tela Allow Access do Salesforce com as permissões solicitadas pelo Perplexity e os botões Deny e Allow](https://mintcdn.com/perplexity-help-center/jXyVOP6pZJdyykyP/help-center/assets/img/salesforce_mcp_consent.png?fit=max\&auto=format\&n=jXyVOP6pZJdyykyP\&q=85\&s=79b7a8e2145a5d9a295bfb99f0107444)](https://www.perplexity.ai/help-center/help-center/assets/img/salesforce_mcp_consent.png)

Figura 12 — O Salesforce pede que você permita o acesso na primeira vez que se conecta.

### Como verificar se funcionou

1. Em uma nova sessão, pergunte: *"Usando o Salesforce, com qual usuário estou conectado?"* O Perplexity
   deve responder com seu nome e sua função no Salesforce.

2. Peça: *"Liste as 5 contas que visualizei mais recentemente."*

3. Opcional: peça ao Perplexity para criar um registro de teste do objeto Task no Salesforce e, depois,
   excluí-lo. Verifique se a trilha de auditoria do Salesforce mostra seu nome. Uma tentativa de gravação de um usuário Read Only
   deve falhar com `INSUFFICIENT_ACCESS_OR_READONLY`.

Consulte as orientações do Salesforce em [Testar clientes MCP](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/test-connection.html).

## Testando na prática

* *"Mostre minhas oportunidades abertas com fechamento neste trimestre, ordenadas por valor."*

* *"Atualize a etapa da oportunidade da Globex para Negociação."*

* *"Toda segunda-feira, resuma as oportunidades que mudaram de etapa na semana anterior."*

## Permissões e escopos

| Item | Finalidade |
| - | - |
| Escopo `mcp_api` | Permite que o Perplexity chame o servidor MCP hospedado do Salesforce |
| Escopo `refresh_token` | Mantém os usuários conectados entre sessões. Sua política de token de atualização determina a duração desse período. |
| Perfil e regras de compartilhamento do Salesforce | Delimitam o acesso. Um usuário com acesso somente leitura pode ler, mas não gravar. |

*Tabela 4 — O que o Perplexity solicita e quais são seus limites.*

Ações disponíveis: obter o schema do objeto, executar consultas SOQL, pesquisar (Salesforce Object Search Language, SOSL), obter informações do usuário,
listar registros recentes, obter registros relacionados, criar um registro, atualizar um registro ou
registro relacionado e excluir um registro ou registro relacionado. Consulte a [referência de SObject All](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/sobject-all.html).

Não são compatíveis: atualizações em massa ou em lote, upload de arquivos e anexos,
conversão de leads, envio de e-mails e execução de relatórios. Essas ações não estão disponíveis nos
[servidores MCP hospedados padrão](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/servers-reference.html) do Salesforce.

## Solução de problemas

| Sintoma | Causa provável | Como resolver |
| - | - | - |
| O conector do Salesforce não aparece | O administrador da sua organização no Perplexity o desativou, ou ele ainda não está disponível para sua organização ou seu plano | Consulte o administrador da sua organização no Perplexity e confira os planos listados em [Visão geral](#overview) |
| **Configuração da organização necessária** | Nenhuma Consumer Key foi salva no Perplexity | Peça ao administrador da sua organização no Perplexity para concluir a Etapa 5 |
| **Configuração pessoal necessária** | Você está no plano Pro ou Max, sem uma organização no Perplexity, e ainda não salvou uma Consumer Key | Conclua a [Etapa 5 (sem uma organização no Perplexity)](#etapa-5-sem-uma-organização-no-perplexity--adicionar-a-consumer-key-por-conta-própria-cerca-de-5-minutos) |
| `redirect_uri_mismatch` | Uma URL de retorno está ausente ou foi digitada incorretamente | Confira novamente a Etapa 2.5. As URLs precisam ser exatamente iguais. |
| `invalid_client_id` | Consumer Key incorreta ou aplicativo criado há menos de 30 minutos | Copie a chave novamente ou aguarde e tente de novo |
| O login funciona, mas as solicitações falham com 401 | SObject All não está ativo, os tokens baseados em JWT não estão habilitados ou falta o escopo `mcp_api` | Confira novamente as Etapas 1, 2.6 e 2.7 |
| A página de login exige o domínio da empresa ou o SSO não aparece | Sua organização bloqueia logins por `login.salesforce.com` | Adicione URLs do My Domain na Etapa 5 ou clique em **Use Custom Domain** e insira seu domínio |
| `OAUTH_APP_ACCESS_DENIED` | **Permitted Users** bloqueia este usuário | Altere **Permitted Users** ou atribua o conjunto de permissões |
| `INSUFFICIENT_ACCESS_OR_READONLY` | O perfil do usuário no Salesforce não permite a ação | Esse comportamento é esperado. Ajuste as permissões do Salesforce se necessário. |
| Os usuários precisam se reconectar periodicamente | O token de atualização expirou ou atingiu o tempo limite de inatividade | Revise a política de token de atualização no External Client App |
| O conector mostra **Adicionar conector** (ou **Conectar**) novamente | A configuração mudou ou o acesso foi revogado no Salesforce | Clique em **Adicionar conector** (ou **Conectar**) no [conector do Salesforce](https://www.perplexity.ai/computer/connectors?connector=salesforce_mcp) e faça login novamente |
| Os resultados parecem desatualizados | O conector lê os dados do Salesforce em tempo real a cada solicitação | Confira o registro no Salesforce. Se houver diferença, pergunte novamente em uma nova sessão. |

*Tabela 5 — Erros comuns do conector do Salesforce.*

## Perguntas frequentes

### Quais dados o conector acessa?

Somente os dados que o usuário conectado já pode acessar no Salesforce, por meio das
ações listadas em [Permissões e escopos](#permissions-and-scopes). Perfis,
conjuntos de permissões, segurança em nível de campo e regras de compartilhamento continuam valendo.

### O Perplexity pode gravar no Salesforce?

Sim, se as permissões do usuário no Salesforce permitirem. Para limitar isso, conceda aos usuários um
conjunto de permissões ou um perfil mais restrito.

### Meu administrador pode restringir quem usa este conector?

Sim, dos dois lados. No Salesforce, use **Permitted Users** com um conjunto de permissões.
Nos planos Enterprise, o administrador da sua organização no Perplexity pode desativar o conector para
a organização. Os tokens de login armazenados dos usuários são mantidos até que cada usuário
se desconecte, portanto, para remover o acesso de todos de uma vez, bloqueie o External Client
App no Salesforce. Para ver quem se conectou ou revogar tokens, consulte [Gerenciar
o uso de OAuth de External
Client Apps](https://help.salesforce.com/s/articleView?id=xcloud.manage_external_client_app_usage.htm\&language=en_US\&type=5).

### Por quanto tempo os dados são mantidos depois que eu me desconecto ou o conector é desativado?

Quando você se desconecta, o Perplexity exclui seus tokens de login do Salesforce armazenados.
Se o administrador da sua organização no Perplexity desativar o conector, os tokens dos usuários
são mantidos até que cada usuário se desconecte. Para remover o acesso de todos de uma
vez, seu administrador do Salesforce pode bloquear o External Client App. As sessões
que incluem resultados do Salesforce seguem suas configurações de retenção de sessões. Consulte
[Retenção de dados para Enterprise](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/11652701-retencao-de-dados-para-enterprise.md).

### Eu usava o conector anterior do Salesforce. O que muda?

Você precisará se reconectar uma vez, depois que a Consumer Key for adicionada na Etapa 5,
pelo administrador da sua organização no Perplexity ou, nos planos Pro ou Max
sem uma organização, por você.
Sua conexão existente não pode ser migrada automaticamente, porque o novo
conector usa o aplicativo da sua própria organização Salesforce.

### Meus dados do Salesforce serão usados para treinar modelos de IA?

Não. Os dados acessados por meio do conector do Salesforce nunca são usados para treinar
os modelos do Perplexity nem qualquer modelo de terceiros.

### Este conector está disponível no meu plano?

Sim, nos planos Pro, Max, Enterprise Pro e Enterprise Max. Sua organização Salesforce
precisa ser Enterprise Edition ou superior, ou uma organização Developer Edition para
testes.

## Artigos relacionados

* [Conectores do Perplexity para Enterprise: FAQ](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/10673197-conectores-do-perplexity-para-enterprise-perguntas-frequentes.md)

* [Controle de acesso baseado em funções para conectores](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/2026100201-controle-de-acesso-baseado-em-funcoes-para-conectores.md)

* [Guia de solução de problemas do conector Enterprise](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/10673201-guia-de-solucao-de-problemas-do-conector-enterprise.md)

* [Conectando o Perplexity ao Snowflake](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/14017006-conectando-o-perplexity-ao-snowflake.md)

## Precisa de mais ajuda?

Ao entrar em contato, informe o nome do conector, a mensagem de erro exata, o
horário em que ela ocorreu e as etapas deste artigo que não resolveram o problema.

> [!NOTE]
>
> Fale com sua equipe de conta ou [entre em contato conosco por **Help > Falar com o suporte**](https://www.perplexity.ai/?support=true#settings/account).
> Acesse a [Central de Confiança](https://trust.perplexity.ai/) para obter
> documentação de segurança e conformidade.


## Related topics

- [Conectores e integrações](https://www.perplexity.ai/help-center/help-center/pt-BR/collections/18799295-conectores-e-integracoes.md)
- [Conectando o Perplexity ao Linear](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/12167711-conector-linear-para-enterprise.md)
- [Conectando o Perplexity ao Guidepoint](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/14818160-conectando-o-perplexity-ao-guidepoint.md)
- [Conectando o Perplexity ao Snowflake](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/14017006-conectando-o-perplexity-ao-snowflake.md)
