Como trazer um dado do Salesforce para uma variável da conversa: cumprimentar pelo nome, ramificar o fluxo conforme o status de um registro ou reutilizar um Id mais adiante.
Este bloco faz o contrário do bloco de ação: em vez de escrever no Salesforce, ele lê um campo e o salva em uma variável que você pode usar no restante da conversa.Com isso você pode cumprimentar a pessoa pelo nome, dizer em que status está a solicitação dela, ou enviá-la por um caminho diferente do fluxo conforme o que diz o registro dela.O bloco tem um nome diferente conforme o seu tipo de integração:
Tipo de integração
Nome do bloco
Objeto único
Objeto CRM
Multi-objeto
CRM Multiple Object
Em multi-objeto os dois blocos do Salesforce têm nomes quase idênticos. O que lê é CRM Multiple Object. O que escreve é CRM Multiple Object Action, com “Action” no final.
Cada bloco lê um único campo. Se você precisar de três dados, usará três blocos.
Se o Treble não encontrar o registro, a variável fica vazia. O fluxo não para nem mostra um erro: simplesmente a variável chega sem conteúdo, e se você a usar em uma mensagem a pessoa verá um espaço em branco.Por isso convém colocar um bloco de Condições logo depois, que verifique se a variável tem valor e monte um caminho alternativo quando não tiver.
No construtor de conversas, abra o painel de blocos e procure o bloco de leitura dentro de Blocos avançados.
O nome que você vê no painel de blocos pode não ser o mesmo que aparece depois sobre o bloco na tela. Guie-se pelo ícone e pela descrição (“salva a variável no Treble”): é o bloco que traz informação do CRM, não o que a salva lá.
Arraste-o para a tela e clique em Configuração para abri-lo.
Objeto. De qual objeto você vai ler. Pode ser a sua entidade pai (por exemplo Contact) ou algum dos seus objetos relacionados.Hierarquia. O que fazer quando a pessoa tem mais de um registro desse objeto.
Opção
O que faz
Primeiro criado
Lê do registro mais antigo
Último criado
Lê do registro mais recente
Personalizado
Você define um filtro para apontar para um registro específico
A hierarquia de leitura e a de escrita são configurações independentes. Se você lê com Primeiro criado e escreve com Último criado, vai ler de um registro e escrever em outro. Quando ambos os blocos devem trabalhar sobre o mesmo registro, verifique se a hierarquia coincide.
No final você define como a variável vai se chamar. Se você escrever cliente_fuente, no restante da conversa você a usa como {{cliente_fuente}}.
Use nomes em minúsculas e com sublinhado, sem espaços nem acentos. São mais fáceis de escrever corretamente nas mensagens e evitam erros difíceis de ver.
O modal tem três passos, porque primeiro é preciso dizer em qual dos seus objetos a pessoa será buscada.
Referência. Qual dos objetos que você configurou na instalação será usado para encontrar a pessoa.Campo de busca de telefone. Por qual campo de telefone desse objeto a busca é feita. A lista suspensa mostra todos os campos de telefone do objeto (Phone, Mobile Phone, Fax, e os personalizados que você tiver).
Escolha o mesmo campo onde realmente estão salvos os números dos seus registros. Se você escolher um diferente, o Treble não vai encontrar ninguém e todas as variáveis vão chegar vazias.
Uma vez configurado, o bloco mostra na tela um resumo e, abaixo, a variável que ele produz. Você pode copiá-la com o botão de copiar e colá-la em qualquer bloco posterior.
O bloco de leitura tem que ficar antes no fluxo do que o bloco onde você usa a variável. Se você colocá-lo depois, a variável ainda não tem valor no momento em que a mensagem é enviada.
Em multi-objeto, o bloco de leitura e o de escrita se distinguem pelo último quadro do resumo: o de leitura termina em Variável, o de ação termina em Na propriedade → Colocar.
Leia o nome do registro e use-o na primeira mensagem. Lembre-se do caminho alternativo: se a pessoa é nova e não existe no Salesforce, a variável chega vazia.
Ramificar o fluxo conforme o status de um registro
Leia um campo de status e conecte o bloco a um bloco de Condições. Assim você pode dar uma mensagem diferente para quem tem uma solicitação em andamento e para quem já a tem aprovada.
Salvar o Id para escrever depois nesse mesmo registro
Em multi-objeto você pode ler o Id de um registro em uma variável e usá-lo mais adiante na hierarquia personalizada do bloco de ação (Account ID = {{client_id}}). É a forma mais confiável de garantir que a escrita caia no registro que você quer, e não em outro do mesmo objeto.
Se o dado já está no Salesforce, leia-o em vez de pedi-lo. Isso encurta a conversa e evita que a pessoa escreva algo diferente do que você já tem registrado.
A variável traz um código estranho em vez do texto que vejo no Salesforce
Acontece com campos do tipo lista suspensa e com campos de relacionamento. O Salesforce salva internamente um valor diferente do que mostra na tela, e é isso que o Treble lê.Se você precisar mostrar o texto para a pessoa, use um bloco de Condições para traduzir o código para a palavra correspondente.
Um campo de data não chega como eu esperava
Os campos de data e data/hora chegam no formato interno do Salesforce, não no formato que você vê na tela nem no do seu país.Se você vai mostrar a data para a pessoa no chat, verifique primeiro como o valor chega com um teste real antes de publicar o fluxo.
Na mensagem aparece {{mi_variable}} tal como está, com as chaves
O nome da variável na mensagem não coincide exatamente com o que você definiu no bloco. Verifique maiúsculas, acentos e sublinhados; o mais seguro é copiar a variável a partir do bloco com o botão de copiar.