> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Objeto personalizado de conversaciones

> Cómo crear en Salesforce el objeto Treble Conversation para guardar el historial de WhatsApp con formato enriquecido e imágenes.

Además de la Tarea o el Evento, Treble puede guardar el historial de cada conversación en un **objeto personalizado** de Salesforce con formato enriquecido: saltos de línea, enlaces e imágenes que la persona envió por WhatsApp.

<Note>
  **No reemplaza a la Tarea ni al Evento: se suma.** Si creas este objeto, cada conversación cerrada genera la actividad de siempre **y además** un registro en el objeto personalizado.
</Note>

<Info>
  **No hay nada que activar del lado de Treble.** Basta con que el objeto exista en tu organización de Salesforce, con el nombre y los campos exactos que se describen abajo. Treble lo detecta solo y empieza a escribir en él.

  Si el objeto no existe, Treble sigue funcionando normalmente y solo escribe la Tarea o el Evento.
</Info>

<Warning>
  Los nombres de API tienen que ser **exactamente** los que se indican aquí. Si cambias uno, Treble no va a poder escribir, y no vas a ver un error en la plataforma: simplemente no aparecerán registros.
</Warning>

<div class="hr" />

## Lo que vas a crear

| | Nombre de API | Tipo |
| - | - | - |
| El objeto | `TrebleWhatsAppConversation__c` | Objeto personalizado |
| Relación con el registro | `Contact__c` | Relación maestro-detalle |
| La transcripción | `Messages__c` | Área de texto enriquecido |

Esto se hace en Salesforce, con un usuario administrador. Toma unos 10 minutos.

<div class="hr" />

## 1. Crear el objeto

<Steps>
  <Step title="Entra a Setup">
    Haz clic en el ícono de engranaje arriba a la derecha y elige **Setup**.

    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-custom-object-1.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=cddc709fa10ac418b65a3d92869548c3" alt="Abrir Setup en Salesforce" width="320" className="mx-auto" data-path="images/salesforce-custom-object-1.png" />
  </Step>

  <Step title="Abre el Object Manager">
    Busca "object manager" en la barra de búsqueda de Setup y entra a **Object Manager**.

    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-custom-object-2.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=dc3c5ba2d786c6273e774f7866c95a05" alt="Buscar Object Manager" className="mx-auto" width="3456" height="370" data-path="images/salesforce-custom-object-2.png" />
  </Step>

  <Step title="Crea un objeto personalizado">
    Haz clic en **Create → Custom Object**.

    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-custom-object-3.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=4d528115a2836813748a8a214a0c7a4a" alt="Crear un objeto personalizado" className="mx-auto" width="3442" height="528" data-path="images/salesforce-custom-object-3.png" />
  </Step>

  <Step title="Llena la definición del objeto">
    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-custom-object-4.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=566cc286e33ef521e6f478dd46b58854" alt="Formulario de definición del objeto personalizado" className="mx-auto" width="3426" height="1548" data-path="images/salesforce-custom-object-4.png" />

    | Campo | Valor |
    | - | - |
    | **Label** | `Treble Conversation` |
    | **Plural Label** | `Treble Conversations` |
    | **Object Name** | `TrebleWhatsAppConversation` |
    | **Record Name** | `Treble Conversation Name` (o el texto que prefieras) |
    | **Data Type** | `Text` |

    <Warning>
      El **Object Name** es el que importa. Salesforce le agrega `__c` automáticamente, así que el nombre de API queda como `TrebleWhatsAppConversation__c`. Escríbelo exactamente así, sin espacios.
    </Warning>

    Guarda. Al terminar, la pantalla de **Details** debe mostrar el nombre de API correcto:

    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-custom-object-5.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=0d36502806a60af361a99b546fa74b16" alt="Detalles del objeto Treble Conversation ya creado" className="mx-auto" width="3456" height="1566" data-path="images/salesforce-custom-object-5.png" />
  </Step>
</Steps>

<div class="hr" />

## 2. Crear la relación con el registro

Este campo es el que conecta cada conversación con la persona a la que pertenece.

<Steps>
  <Step title="Entra a Fields & Relationships → New">
    Dentro del objeto **Treble Conversation**, abre la pestaña **Fields & Relationships** y haz clic en **New**.
  </Step>

  <Step title="Elige Master-Detail Relationship">
    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-custom-object-6.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=bf32b43293a067b254968f13bbfaaaf7" alt="Elegir el tipo de campo Master-Detail Relationship" className="mx-auto" width="3450" height="1740" data-path="images/salesforce-custom-object-6.png" />
  </Step>

  <Step title="Relaciónalo con el objeto de la persona">
    En **Related To** elige el objeto donde viven tus contactos (normalmente `Contact`).

    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-custom-object-7.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=ade6661eb71efa2a1657b9e9c771f0da" alt="Elegir el objeto relacionado" className="mx-auto" width="3444" height="1742" data-path="images/salesforce-custom-object-7.png" />
  </Step>

  <Step title="Nombra el campo">
    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-custom-object-8.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=da861f086bad451b99732abcd1f3ae54" alt="Nombrar el campo de relación" className="mx-auto" width="2930" height="1316" data-path="images/salesforce-custom-object-8.png" />

    | Campo | Valor |
    | - | - |
    | **Field Label** | `Contact` |
    | **Field Name** | `Contact` |
    | **Child Relationship Name** | `TrebleWhatsAppConversations` |
    | **Sharing Setting** | `Read/Write` |

    <Warning>
      El **Field Name** debe ser exactamente `Contact`, porque el nombre de API resultante (`Contact__c`) es el que Treble usa al escribir.
    </Warning>

    Avanza por los pasos restantes (visibilidad por perfil y page layouts) con los valores por defecto y guarda.
  </Step>
</Steps>

<div class="hr" />

## 3. Crear el campo de mensajes

<Steps>
  <Step title="Fields & Relationships → New → Text Area (Rich)">
    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-custom-object-9.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=27bc978377bd3bfccd66de1a882fe300" alt="Elegir el tipo de campo Text Area (Rich)" className="mx-auto" width="3444" height="1742" data-path="images/salesforce-custom-object-9.png" />

    Tiene que ser **Text Area (Rich)**, no *Text Area (Long)*. El texto enriquecido es lo que permite ver los saltos de línea y las imágenes de la conversación.
  </Step>

  <Step title="Llena los detalles del campo">
    <img src="https://mintcdn.com/trebleai/n_48dzI5l_tB6XfZ/images/salesforce-custom-object-10.png?fit=max&auto=format&n=n_48dzI5l_tB6XfZ&q=85&s=ae59f83124208cbd70cd60e7537fe700" alt="Detalles del campo Messages" className="mx-auto" width="2914" height="1172" data-path="images/salesforce-custom-object-10.png" />

    | Campo | Valor |
    | - | - |
    | **Field Label** | `Messages` |
    | **Field Name** | `Messages` |
    | **Length** | `131072` (el máximo) |
    | **# Visible Lines** | `25` |

    <Tip>
      Usa la longitud máxima. Las conversaciones largas pueden ocupar bastante, y un campo corto haría que se pierda el final de la transcripción.
    </Tip>

    Guarda.
  </Step>
</Steps>

<Check>
  Listo. A partir de la siguiente conversación que se cierre, vas a ver registros nuevos en **Treble Conversations**, relacionados con el registro de cada persona.
</Check>

<div class="hr" />

## Cómo se ve cada registro

| Campo | Qué contiene |
| - | - |
| **Name** | La fecha y hora de inicio de la conversación, seguida de su identificador interno. Por ejemplo: `2026-10-13 14:22:05 - 8f3c...` |
| **Contact** | El registro de la persona |
| **Messages** | La transcripción completa, con formato: cada mensaje en su línea, y las imágenes que la persona envió incrustadas |

<Tip>
  Agrega la lista relacionada **Treble Conversations** al page layout del objeto de tus contactos. Así el asesor ve todas las conversaciones de esa persona directamente en el registro, sin tener que buscarlas.
</Tip>

<div class="hr" />

## Problemas frecuentes

<AccordionGroup>
  <Accordion title="Creé el objeto pero no aparece ningún registro">
    Revisa los nombres de API uno por uno. Es lo que falla en la mayoría de los casos:

    * El objeto debe ser `TrebleWhatsAppConversation__c`
    * El campo de relación debe ser `Contact__c`
    * El campo de mensajes debe ser `Messages__c`

    Un nombre distinto hace que la escritura falle en silencio: Treble sigue creando la Tarea o el Evento, pero no el registro del objeto personalizado.
  </Accordion>

  <Accordion title="El objeto existe pero el usuario de la integración no lo ve">
    Al crear un objeto personalizado, Salesforce deja los permisos **deshabilitados para todos los perfiles** por defecto. Confirma que el perfil del usuario con el que se conectó Treble tenga permisos de lectura y creación sobre el objeto y sus campos.
  </Accordion>

  <Accordion title="Uso multi-objeto y no sé a cuál objeto relacionarlo">
    La relación maestro-detalle apunta a **un solo** objeto. Si tu operación reparte a las personas entre varios objetos, habla con tu Customer Success Manager antes de crearlo, para definir cuál conviene y qué pasa con los registros de los demás.
  </Accordion>

  <Accordion title="Los mensajes se ven cortados">
    El campo quedó creado con una longitud menor a la máxima. Edítalo y sube la longitud a `131072`.
  </Accordion>

  <Accordion title="¿Puedo dejar de usar la Tarea o el Evento y quedarme solo con esto?">
    No desde la plataforma. Treble escribe siempre la Tarea o el Evento; el objeto personalizado es adicional. Si el duplicado te estorba, habla con tu Customer Success Manager.
  </Accordion>
</AccordionGroup>

<div class="hr" />

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Historial de conversación" icon="clock-rotate-left" href="/es/docs/integrations/salesforce/features/activities">
    Cuándo se escribe y qué campos se llenan en la Tarea o el Evento.
  </Card>

  <Card title="Ver WhatsApp dentro de Salesforce" icon="window-maximize" href="/es/docs/integrations/salesforce/embed/custom-tab">
    Responder conversaciones activas sin salir del CRM.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.