## Lo primero que conviene entender Cada bloque de Acción en CRM escribe **una sola propiedad**. Si necesitas guardar tres datos, usarás tres bloques. Además, el bloque hace dos cosas distintas según el caso: * Si **encuentra** el registro de la persona, lo **actualiza**. * Si **no lo encuentra**, lo **crea**. Esta diferencia importa más de lo que parece. Algunos campos de Salesforce solo aceptan valores en el momento de la creación: por ejemplo, un campo que una regla de validación exige al crear, o el tipo de registro de una Person Account. Como el bloque escribe **después** de crear el registro, en esos casos el valor llega tarde. Si te topas con eso, revisa [configuraciones avanzadas](/es/docs/integrations/salesforce/features/advanced-settings).

## Agregar el bloque Desde el constructor de conversaciones, abre el panel de bloques y busca **Acción en CRM** dentro de *Bloques avanzados*. Agregar el bloque de Acción en CRM al flujo

Agregar el bloque de Acción en CRM al flujo

Arrástralo al lienzo y haz clic en **Configuración** para abrirlo.

## Configuración ### 1. Objeto y jerarquía Seleccionar el objeto de Salesforce

**Objeto.** Elige sobre cuál objeto vas a escribir. Puede ser tu entidad padre (por ejemplo `Contact`) o alguno de sus objetos relacionados. **Jerarquía.** Define qué pasa cuando la persona tiene **más de un registro** de ese objeto. Es una decisión importante y fácil de pasar por alto. Opciones de jerarquía

Elegir la propiedad y el valor a guardar

**Propiedad.** El campo de Salesforce que vas a escribir. **Valor.** Lo que quieres guardar. Puede ser un texto fijo, o una variable de la conversación usando llaves dobles, por ejemplo `{{nombre}}`. El tipo de campo cambia cómo se ve esta parte. Si es una lista desplegable, verás las opciones disponibles en vez de una caja de texto. Si las opciones que esperas no aparecen, probablemente falte [sincronizar objetos](/es/docs/integrations/salesforce/object-sync). ### 3. Crear un nuevo objeto Al final del modal hay un interruptor: **"Crear un nuevo objeto con esta configuración"**. Si lo activas, Treble **siempre crea un registro nuevo**, sin revisar primero si la persona ya existe. Úsalo solo cuando de verdad quieras un registro por conversación (por ejemplo, una solicitud nueva cada vez). Si lo activas en el objeto principal por error, vas a terminar con un contacto duplicado por cada conversación. En multi-objeto el bloque pide un paso más al inicio, porque primero hay que decir **sobre cuál de tus objetos** estás trabajando. El modal tiene tres pasos numerados. ### 1. Objeto de referencia y campo de teléfono Pasos 1 y 2 del bloque CRM Multiple Object Action

Pasos 1 y 2 del bloque CRM Multiple Object Action

**Objeto de referencia.** Cuál de los objetos que configuraste al instalar vas a usar en este bloque (por ejemplo `Lead`, `Account` o un objeto personalizado). **Campo de búsqueda de teléfono.** Por cuál campo de ese objeto se busca a la persona. Este campo cumple **dos funciones a la vez**: es por donde Treble busca el registro, y también donde escribe el número cuando lo crea. Cambiarlo después afecta las dos cosas. Si todos tus registros históricos tienen el número en el campo anterior, Treble dejará de encontrarlos y empezará a crear duplicados. Revisa [configuraciones avanzadas](/es/docs/integrations/salesforce/features/advanced-settings) antes de cambiarlo. ### 2. Objeto y jerarquía En la misma pantalla, el paso 2 pide el objeto sobre el que vas a escribir y la jerarquía. Puede ser el mismo objeto de referencia o uno relacionado. Además de *Primero creado* y *Último creado*, multi-objeto ofrece **Personalizado**, que te deja apuntar a un registro específico con una propiedad y un valor: Jerarquía personalizada con propiedad y valor

Jerarquía personalizada con propiedad y valor

El valor acepta variables de la conversación. En el ejemplo, `Account ID = {{client_id}}` escribe exactamente sobre la cuenta cuyo Id quedó guardado en la variable `{{client_id}}` — útil cuando ya leíste el Id en un bloque anterior y quieres asegurarte de escribir sobre ese registro y no sobre otro. ### 3. Propiedad y valor Propiedad a escribir y valor a guardar

**Propiedad.** El campo de Salesforce que vas a escribir (en el ejemplo, `Account Name`). **Guardar como texto.** El valor. Puede ser texto fijo o una variable con llaves dobles, por ejemplo `{{nombre_cuenta}}`. Debajo está el interruptor **"Crear un nuevo objeto con esta configuración"**. Si lo activas, Treble **siempre crea un registro nuevo** del objeto del paso 2, sin revisar primero si ya existe. Úsalo solo cuando de verdad quieras un registro por conversación. Si lo activas sobre tu objeto principal por error, vas a terminar con un registro duplicado por cada conversación.

## Cómo se ve en el flujo Una vez configurado, el bloque muestra un resumen de lo que hace, para que puedas leer el flujo sin abrir cada uno. En **objeto único** se ve así: ``` Objeto: Contact Jerarquía: Último creado En la propiedad: Lead Source ↳ Colocar: Web ``` En **multi-objeto** el resumen incluye además el objeto de referencia y el campo de búsqueda: Bloques de lectura y escritura en el lienzo del flujo

Bloques de lectura y escritura en el lienzo del flujo

A la izquierda está el bloque de **lectura** (*CRM Multiple Object*, que termina en una variable) y a la derecha el de **escritura** (*CRM Multiple Object Action*, que termina en *En la propiedad → Colocar*). El ícono y el último bloque del resumen son la forma más rápida de distinguirlos de un vistazo.

## Cuándo se escribe, y por qué importa el orden Cada bloque escribe en Salesforce **en el momento exacto en que la conversación pasa por él**. No espera al final del flujo, y no se deshace si la persona abandona la conversación después. **Las conversaciones incompletas también dejan datos.** Si pones un bloque de acción justo después de la primera pregunta y la persona abandona ahí, ese dato ya quedó escrito en Salesforce. Es la causa de la queja más común sobre "información basura en el CRM". ### Cómo evitar datos a medias Guarda las respuestas en variables de la conversación durante el flujo, y pon **todos** los bloques de acción juntos al final, después de la última pregunta. Así solo llega al CRM la información de quienes completaron el flujo.

Cómo guardar en variables

Si prefieres escribir sobre la marcha —por ejemplo para no perder los datos de quien abandona— agrega un último bloque de acción que marque un campo tipo "flujo completado". Después puedes filtrar por ese campo en Salesforce. No para que la escritura ocurra: el bloque escribe al pasar por él, haya o no un bloque siguiente. Pero sí para que el flujo tenga sentido: un bloque de acción no le dice nada a la persona. Si es el último paso, lo normal es poner un mensaje de cierre después.

## Problemas frecuentes Casi siempre es falta de sincronización. Corre la [sincronización de objetos](/es/docs/integrations/salesforce/object-sync) y vuelve a abrir el bloque. Suele ser el **tipo de registro**. Los tipos de registro definen qué valores de lista son válidos en cada registro, así que un valor correcto para un tipo puede ser inválido para otro.

Tipos de registro

Revisa la **jerarquía**. Si la persona tiene varios registros y elegiste *Último creado*, el bloque escribe sobre el más reciente, que puede no ser el que tienes abierto en Salesforce. Por ejemplo, un contacto cuyo nombre en Salesforce quedó como *"Hola, vi el anuncio y quiero información"*. Casi siempre es un bloque de acción escribiendo la **respuesta de la persona** sobre el campo de nombre. Revisa cuál propiedad tiene configurada ese bloque: es fácil apuntar a `Name` o `FirstName` cuando en realidad querías un campo propio. Revisa si el interruptor **"Crear un nuevo objeto"** está activado en un bloque donde no debería. También revisa que el campo de búsqueda de teléfono sea el mismo donde están guardados los números de los registros existentes. Puede haber una automatización en tu Salesforce (un Flow, Process Builder o trigger) que limpia o sobrescribe ese campo después de crear el registro. Una forma rápida de confirmarlo: si el valor **sí** se guarda cuando se escribe sobre un registro que ya existe, pero **no** cuando se crea, casi seguro hay una automatización que corre en la creación.

## Siguientes pasos Traer un valor de Salesforce a una variable de la conversación. Qué hacer cuando un campo debe escribirse en el momento de crear. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.