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

# Sincronizar objetos do Salesforce

> Como fazer o Treble enxergar as alterações que você faz no Salesforce. É o passo mais esquecido e a causa mais comum de erros que parecem não ter explicação.

O Treble guarda uma **cópia da estrutura** dos seus objetos e campos do Salesforce: quais objetos existem, quais campos cada um tem, quais valores cada lista suspensa aceita e quais são obrigatórios.

Essa cópia não se atualiza sozinha. Ela é atualizada quando você executa a **sincronização de objetos**.

<Warning>
  Toda vez que você alterar algo no Salesforce que afete a estrutura, execute a sincronização. Se não fizer isso, o Treble continua trabalhando com a versão anterior e os erros que aparecem **normalmente não têm relação evidente com a alteração que você fez**.
</Warning>

<div class="hr" />

## Quando você precisa sincronizar

<AccordionGroup>
  <Accordion title="Você criou ou modificou um campo">
    Um campo novo não aparece nos blocos do Treble até que você sincronize.
  </Accordion>

  <Accordion title="Você alterou se um campo é obrigatório ou definiu um valor padrão para ele">
    O Treble decide quais campos enviar ao criar um registro com base nessa informação. Se ela estiver desatualizada, ele pode enviar campos que já não são necessários, ou omitir outros que agora são.
  </Accordion>

  <Accordion title="Você adicionou ou modificou uma regra de validação">
    As regras de validação afetam quais valores o Salesforce aceita ao criar ou atualizar um registro.
  </Accordion>

  <Accordion title="Você criou ou alterou um tipo de registro (record type)">
    Os tipos de registro definem quais valores de lista e quais buscas são válidos em cada registro.

    <a class="article-link" href="/pt/docs/integrations/salesforce/features/record-types"><p>Tipos de registro</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a>
  </Accordion>

  <Accordion title="Você adicionou valores a uma lista suspensa (picklist)">
    O Treble mostra as opções que tinha salvas na última sincronização.
  </Accordion>

  <Accordion title="Os nomes dos campos aparecem em outro idioma">
    O Treble mostra os rótulos dos campos **exatamente como o Salesforce os retorna**, e o Salesforce os traduz de acordo com o idioma do usuário com o qual a integração está conectada.

    Se você quiser vê-los em inglês em vez de espanhol (ou o contrário), é preciso alterar o idioma desse usuário no Salesforce e sincronizar novamente. Não é uma configuração do Treble.
  </Accordion>

  <Accordion title="O Treble avisou que publicou uma melhoria">
    Algumas melhorias da integração só ficam visíveis depois de sincronizar.
  </Accordion>
</AccordionGroup>

<div class="hr" />

## Como sincronizar

<Steps>
  <Step title="Abra qualquer conversa">
    Entre na sua plataforma do Treble e abra qualquer fluxo de conversa. **Não importa qual**: a sincronização é da conta inteira, não do fluxo em que você está.
  </Step>

  <Step title="Clique na engrenagem da barra superior">
    Dentro do construtor de conversas, na barra superior à esquerda, clique no ícone de engrenagem ⚙.

    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-object-sync-1.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=b1523474010de0016649b5466e4e6800" alt="O ícone de engrenagem na barra superior do construtor de conversas" className="mx-auto" width="3024" height="1712" data-path="images/salesforce-object-sync-1.png" />

    <Info>
      É a mesma engrenagem para todos os fluxos. Se você não a vê, confirme que está dentro do construtor de conversas e não na lista de campanhas.
    </Info>
  </Step>

  <Step title="Clique em Sincronizar dados">
    Abre-se o painel de **Configurações**. Lá embaixo está o cartão **Bloco de objeto CRM: sincronização de dados**, com o botão **Sincronizar dados**.

    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-object-sync-2.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=a444549598a4962df3521ecd49333a17" alt="O painel de configurações com o cartão de sincronização de dados" className="mx-auto" width="3024" height="1710" data-path="images/salesforce-object-sync-2.png" />
  </Step>

  <Step title="Espere terminar">
    Enquanto roda, o botão mostra um indicador de carregamento. Dependendo da quantidade de objetos e campos da sua organização, pode levar de alguns segundos a alguns minutos.

    <Check>
      Abaixo do botão, **Última sincronização** mostra a data, a hora e o status. Quando diz **Concluída**, os blocos do Treble já estão mostrando a nova estrutura.
    </Check>

    <Info>
      Essa linha de "última sincronização" é a forma mais rápida de resolver um "já sincronizei": se a data é antiga, ela não foi executada; se é recente e o problema continua, a questão é outra.
    </Info>
  </Step>
</Steps>

<Note>
  **Há três sincronizações diferentes** e elas se confundem com facilidade:

  | Sincronização | O que move | Quando roda |
  | - | - | - |
  | **Inicial de contatos** | Seus registros do Salesforce para o Treble | Uma vez, ao conectar a integração |
  | **Periódica de contatos** | Os registros criados, modificados ou excluídos desde a última passada | Sozinha, a cada \~30 minutos. Não é preciso fazer nada |
  | **De objetos** (esta página) | A **estrutura**: objetos, campos, listas suspensas, tipos de registro | Manualmente, quando você a executa |

  Se alguém disser "já sincronizei" mas o problema continuar, vale a pena confirmar **qual** das três.

  A regra rápida: se falta um **contato**, é coisa das duas primeiras e se verifica na [visão de Sales](/pt/docs/integrations/salesforce/features/sales-view). Se falta um **campo** ou uma opção de lista, é esta.
</Note>

<div class="hr" />

## Como saber se o problema é falta de sincronização

Estes sinais costumam apontar para uma estrutura desatualizada:

| O que você vê | O que revisar |
| - | - |
| Um campo que você criou no Salesforce não aparece na lista de propriedades do Treble | Sincronize |
| O Treble envia um valor para uma lista suspensa e o Salesforce o rejeita, embora o valor exista | Sincronize, e revise o tipo de registro do registro |
| Um novo campo obrigatório faz a criação de registros falhar | Sincronize |
| Você alterou uma configuração no Treble e "não aconteceu nada" | Quase tudo é lido no momento de sincronizar, não em tempo real |

<Tip>
  **Recomendação prática:** incorpore a sincronização ao seu processo. Toda vez que a sua equipe de Salesforce fizer uma alteração de estrutura, que a pessoa que administra o Treble execute a sincronização como passo seguinte. Leva menos de um minuto e evita diagnósticos longos.
</Tip>

<div class="hr" />

## Próximos passos

<CardGroup cols={2}>
  <Card title="Tipos de registro" icon="layer-group" href="/pt/docs/integrations/salesforce/features/record-types">
    Por que um tipo de registro errado produz erros em campos que parecem não ter relação.
  </Card>

  <Card title="Configurações avançadas" icon="sliders" href="/pt/docs/integrations/salesforce/features/advanced-settings">
    O que pode ser personalizado e quais limites tem.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.