Como escrever dados no Salesforce a partir de uma conversa: criar e atualizar registros, escolher qual é atualizado e salvar o que a pessoa responde.
O bloco de Ação no CRM escreve no Salesforce a partir do fluxo de conversa. Com ele você pode salvar o que a pessoa responde, marcar a origem de um lead, mudar o status de uma solicitação ou criar um registro novo.O bloco tem um nome diferente conforme o seu tipo de integração:
Tipo de integração
Nome do bloco
Objeto único
Ação no CRM
Multi-objeto
CRM Multiple Object Action
Em multi-objeto os nomes são muito parecidos e é fácil confundi-los. O que escreve é CRM Multiple Object Action. O que apenas lê se chama CRM Multiple Object, sem “Action”.
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.
No construtor de conversas, abra o painel de blocos e procure Ação no CRM dentro de Blocos avançados.Arraste-o para a tela e clique em Configuração para abri-lo.
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ção
O que faz
Primeiro criado
Usa o registro mais antigo
Último criado
Usa o registro mais recente. É a opção mais comum
Personalizado
Você define um filtro: por exemplo, o registro cujo campo Status seja Ativo
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.
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.
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 antes de alterá-lo.
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:
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.
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.
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: ContactHierarquia: Último criadoNa propriedade: Lead Source ↳ Colocar: Web
Em multi-objeto o resumo inclui também o objeto de referência e o campo de busca:À 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.
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”.
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.
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.
Preciso conectar outro bloco depois do de ação?
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.
Quase sempre é falta de sincronização. Execute a sincronização de objetos e abra o bloco novamente.
O Salesforce rejeita um valor de uma lista suspensa que existe
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.
O dado é salvo em um registro diferente do que eu esperava
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.
No campo de nome do CRM fica o texto de uma mensagem
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.
Estão sendo criados registros duplicados
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.
O Salesforce responde que foi salvo, mas o campo fica vazio
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.