## O que convém entender primeiro Cada bloco de Ação no CRM escreve **uma única propriedade**. Se você precisar salvar três dados, usará três blocos. Além disso, o bloco faz duas coisas diferentes conforme o caso: * Se **encontra** o registro da pessoa, ele o **atualiza**. * Se **não o encontra**, ele o **cria**. Essa diferença importa mais do que parece. Alguns campos do Salesforce só aceitam valores no momento da criação: por exemplo, um campo que uma regra de validação exige ao criar, ou o tipo de registro de uma Person Account. Como o bloco escreve **depois** de criar o registro, nesses casos o valor chega tarde. Se você se deparar com isso, confira [configurações avançadas](/pt/docs/integrations/salesforce/features/advanced-settings).

## Adicionar o bloco No construtor de conversas, abra o painel de blocos e procure **Ação no CRM** dentro de *Blocos avançados*. Adicionar o bloco de Ação no CRM ao fluxo

Adicionar o bloco de Ação no CRM ao fluxo

Arraste-o para a tela e clique em **Configuração** para abri-lo.

## Configuração ### 1. Objeto e hierarquia Selecionar o objeto do Salesforce

**Objeto.** Escolha em qual objeto você vai escrever. Pode ser a sua entidade pai (por exemplo `Contact`) ou algum dos seus objetos relacionados. **Hierarquia.** Define o que acontece quando a pessoa tem **mais de um registro** desse objeto. É uma decisão importante e fácil de passar despercebida. Opções de hierarquia

Escolher a propriedade e o valor a salvar

**Propriedade.** O campo do Salesforce que você vai escrever. **Valor.** O que você quer salvar. Pode ser um texto fixo, ou uma variável da conversa usando chaves duplas, por exemplo `{{nombre}}`. O tipo de campo muda como esta parte aparece. Se for uma lista suspensa, você verá as opções disponíveis em vez de uma caixa de texto. Se as opções que você espera não aparecerem, provavelmente falta [sincronizar objetos](/pt/docs/integrations/salesforce/object-sync). ### 3. Criar um novo objeto No final do modal há um interruptor: **"Criar um novo objeto com esta configuração"**. Se você o ativar, o Treble **sempre cria um registro novo**, sem verificar antes se a pessoa já existe. Use-o apenas quando você realmente quiser um registro por conversa (por exemplo, uma solicitação nova a cada vez). Se você o ativar no objeto principal por engano, vai acabar com um contato duplicado para cada conversa. Em multi-objeto o bloco pede um passo a mais no início, porque primeiro é preciso dizer **em qual dos seus objetos** você está trabalhando. O modal tem três passos numerados. ### 1. Objeto de referência e campo de telefone Passos 1 e 2 do bloco CRM Multiple Object Action

Passos 1 e 2 do bloco CRM Multiple Object Action

**Objeto de referência.** Qual dos objetos que você configurou na instalação você vai usar neste bloco (por exemplo `Lead`, `Account` ou um objeto personalizado). **Campo de busca de telefone.** Por qual campo desse objeto a pessoa é buscada. Este campo cumpre **duas funções ao mesmo tempo**: é por onde o Treble busca o registro, e também onde escreve o número quando o cria. Alterá-lo depois afeta as duas coisas. Se todos os seus registros históricos têm o número no campo anterior, o Treble deixará de encontrá-los e começará a criar duplicados. Confira [configurações avançadas](/pt/docs/integrations/salesforce/features/advanced-settings) antes de alterá-lo. ### 2. Objeto e hierarquia Na mesma tela, o passo 2 pede o objeto no qual você vai escrever e a hierarquia. Pode ser o mesmo objeto de referência ou um relacionado. Além de *Primeiro criado* e *Último criado*, multi-objeto oferece **Personalizado**, que permite apontar para um registro específico com uma propriedade e um valor: Hierarquia personalizada com propriedade e valor

Hierarquia personalizada com propriedade e valor

O valor aceita variáveis da conversa. No exemplo, `Account ID = {{client_id}}` escreve exatamente na conta cujo Id ficou salvo na variável `{{client_id}}` — útil quando você já leu o Id em um bloco anterior e quer ter certeza de escrever nesse registro e não em outro. ### 3. Propriedade e valor Propriedade a escrever e valor a salvar

**Propriedade.** O campo do Salesforce que você vai escrever (no exemplo, `Account Name`). **Salvar como texto.** O valor. Pode ser texto fixo ou uma variável com chaves duplas, por exemplo `{{nombre_cuenta}}`. Logo abaixo está o interruptor **"Criar um novo objeto com esta configuração"**. Se você o ativar, o Treble **sempre cria um registro novo** do objeto do passo 2, sem verificar antes se ele já existe. Use-o apenas quando você realmente quiser um registro por conversa. Se você o ativar no seu objeto principal por engano, vai acabar com um registro duplicado para cada conversa.

## Como aparece no fluxo Uma vez configurado, o bloco mostra um resumo do que faz, para que você possa ler o fluxo sem abrir cada um. Em **objeto único** aparece assim: ``` Objeto: Contact Hierarquia: Último criado Na propriedade: Lead Source ↳ Colocar: Web ``` Em **multi-objeto** o resumo inclui também o objeto de referência e o campo de busca: Blocos de leitura e escrita na tela do fluxo

Blocos de leitura e escrita na tela do fluxo

À esquerda está o bloco de **leitura** (*CRM Multiple Object*, que termina em uma variável) e à direita o de **escrita** (*CRM Multiple Object Action*, que termina em *Na propriedade → Colocar*). O ícone e o último quadro do resumo são a forma mais rápida de distingui-los num relance.

## Quando se escreve, e por que a ordem importa Cada bloco escreve no Salesforce **no momento exato em que a conversa passa por ele**. Não espera o final do fluxo, e não é desfeito se a pessoa abandonar a conversa depois. **Conversas incompletas também deixam dados.** Se você colocar um bloco de ação logo depois da primeira pergunta e a pessoa abandonar ali, esse dado já ficou escrito no Salesforce. É a causa da reclamação mais comum sobre "informação lixo no CRM". ### Como evitar dados pela metade Salve as respostas em variáveis da conversa durante o fluxo, e coloque **todos** os blocos de ação juntos no final, depois da última pergunta. Assim só chega ao CRM a informação de quem completou o fluxo.

Como salvar em variáveis

Se você preferir escrever ao longo do caminho —por exemplo para não perder os dados de quem abandona— adicione um último bloco de ação que marque um campo do tipo "fluxo concluído". Depois você pode filtrar por esse campo no Salesforce. Não para que a escrita aconteça: o bloco escreve ao passar por ele, havendo ou não um bloco seguinte. Mas sim para que o fluxo faça sentido: um bloco de ação não diz nada à pessoa. Se for o último passo, o normal é colocar uma mensagem de encerramento depois.

## Problemas frequentes Quase sempre é falta de sincronização. Execute a [sincronização de objetos](/pt/docs/integrations/salesforce/object-sync) e abra o bloco novamente. Costuma ser o **tipo de registro**. Os tipos de registro definem quais valores de lista são válidos em cada registro, então um valor correto para um tipo pode ser inválido para outro.

Tipos de registro

Confira a **hierarquia**. Se a pessoa tem vários registros e você escolheu *Último criado*, o bloco escreve no mais recente, que pode não ser o que você tem aberto no Salesforce. Por exemplo, um contato cujo nome no Salesforce ficou como *"Olá, vi o anúncio e quero informações"*. Quase sempre é um bloco de ação escrevendo a **resposta da pessoa** no campo de nome. Confira qual propriedade esse bloco tem configurada: é fácil apontar para `Name` ou `FirstName` quando na verdade você queria um campo próprio. Confira se o interruptor **"Criar um novo objeto"** está ativado em um bloco onde não deveria. Confira também se o campo de busca de telefone é o mesmo onde estão salvos os números dos registros existentes. Pode haver uma automação no seu Salesforce (um Flow, Process Builder ou trigger) que limpa ou sobrescreve esse campo depois de criar o registro. Uma forma rápida de confirmar: se o valor **é** salvo quando se escreve em um registro que já existe, mas **não** quando ele é criado, quase com certeza há uma automação que roda na criação.

## Próximos passos Trazer um valor do Salesforce para uma variável da conversa. O que fazer quando um campo deve ser escrito no momento da criação. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.