Cómo traer un dato de Salesforce a una variable de la conversación: saludar por el nombre, ramificar el flujo según el estado de un registro o reutilizar un Id más adelante.
Este bloque hace lo contrario del bloque de acción: en vez de escribir en Salesforce, lee un campo y lo guarda en una variable que puedes usar en el resto de la conversación.Con eso puedes saludar a la persona por su nombre, decirle en qué estado va su solicitud, o mandarla por un camino distinto del flujo según lo que diga su registro.El bloque se llama distinto según tu tipo de integración:
Tipo de integración
Nombre del bloque
Objeto único
Objeto CRM
Multi-objeto
CRM Multiple Object
En multi-objeto los dos bloques de Salesforce tienen nombres casi idénticos. El que lee es CRM Multiple Object. El que escribe es CRM Multiple Object Action, con “Action” al final.
Cada bloque lee un solo campo. Si necesitas tres datos, usarás tres bloques.
Si Treble no encuentra el registro, la variable queda vacía. El flujo no se detiene ni muestra un error: simplemente la variable llega sin contenido, y si la usas en un mensaje la persona verá un espacio en blanco.Por eso conviene poner un bloque de Condiciones justo después, que revise si la variable tiene valor y arme un camino alterno cuando no lo tenga.
Desde el constructor de conversaciones, abre el panel de bloques y busca el bloque de lectura dentro de Bloques avanzados.
El nombre que ves en el panel de bloques puede no ser el mismo que aparece después sobre el bloque en el lienzo. Guíate por el ícono y por la descripción (“guarda la variable en Treble”): es el bloque que trae información del CRM, no el que la guarda allá.
Arrástralo al lienzo y haz clic en Configuración para abrirlo.
Objeto. De cuál objeto vas a leer. Puede ser tu entidad padre (por ejemplo Contact) o alguno de sus objetos relacionados.Jerarquía. Qué hacer cuando la persona tiene más de un registro de ese objeto.
Opción
Qué hace
Primero creado
Lee del registro más antiguo
Último creado
Lee del registro más reciente
Personalizado
Tú defines un filtro para apuntar a un registro específico
La jerarquía de lectura y la de escritura son configuraciones independientes. Si lees con Primero creado y escribes con Último creado, vas a leer de un registro y escribir en otro. Cuando ambos bloques deben trabajar sobre el mismo registro, revisa que la jerarquía coincida.
Al final defines cómo se va a llamar la variable. Si escribes cliente_fuente, en el resto de la conversación la usas como {{cliente_fuente}}.
Usa nombres en minúscula y con guion bajo, sin espacios ni tildes. Son más fáciles de escribir correctamente en los mensajes y evitan errores difíciles de ver.
El modal tiene tres pasos, porque primero hay que decir sobre cuál de tus objetos se va a buscar a la persona.
Referencia. Cuál de los objetos que configuraste al instalar se va a usar para encontrar a la persona.Campo de búsqueda de teléfono. Por cuál campo de teléfono de ese objeto se busca. El desplegable lista todos los campos de teléfono del objeto (Phone, Mobile Phone, Fax, y los personalizados que tengas).
Elige el mismo campo donde realmente están guardados los números de tus registros. Si eliges uno distinto, Treble no va a encontrar a nadie y todas las variables van a llegar vacías.
Una vez configurado, el bloque muestra en el lienzo un resumen y, abajo, la variable que produce. Puedes copiarla con el botón de copiar y pegarla en cualquier bloque posterior.
El bloque de lectura tiene que ir antes en el flujo que el bloque donde usas la variable. Si lo pones después, la variable todavía no tiene valor en el momento en que se envía el mensaje.
En multi-objeto, el bloque de lectura y el de escritura se distinguen por el último recuadro del resumen: el de lectura termina en Variable, el de acción termina en En la propiedad → Colocar.
Lee el nombre del registro y úsalo en el primer mensaje. Acuérdate del camino alterno: si la persona es nueva y no existe en Salesforce, la variable llega vacía.
Ramificar el flujo según el estado de un registro
Lee un campo de estado y conecta el bloque a un bloque de Condiciones. Así puedes dar un mensaje distinto a quien tiene una solicitud en trámite y a quien ya la tiene aprobada.
Guardar el Id para escribir después sobre ese mismo registro
En multi-objeto puedes leer el Id de un registro en una variable y usarlo más adelante en la jerarquía personalizada del bloque de acción (Account ID = {{client_id}}). Es la forma más confiable de asegurarte de que la escritura cae sobre el registro que quieres, y no sobre otro del mismo objeto.
Si el dato ya está en Salesforce, léelo en vez de pedirlo. Acorta la conversación y evita que la persona escriba algo distinto a lo que ya tienes registrado.
La variable trae un código raro en vez del texto que veo en Salesforce
Pasa con campos de tipo lista desplegable y con campos de relación. Salesforce guarda internamente un valor distinto al que muestra en pantalla, y eso es lo que Treble lee.Si necesitas mostrarle el texto a la persona, usa un bloque de Condiciones para traducir el código a la palabra que corresponde.
Un campo de fecha no llega como esperaba
Los campos de fecha y fecha/hora llegan en el formato interno de Salesforce, no en el formato que ves en pantalla ni en el de tu país.Si vas a mostrarle la fecha a la persona en el chat, revisa primero cómo llega el valor con una prueba real antes de publicar el flujo.
En el mensaje aparece {{mi_variable}} tal cual, con las llaves
El nombre de la variable en el mensaje no coincide exactamente con el que definiste en el bloque. Revisa mayúsculas, tildes y guiones bajos; lo más seguro es copiar la variable desde el bloque con el botón de copiar.