> ## 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 conversas

> Como criar no Salesforce o objeto Treble Conversation para salvar o histórico do WhatsApp com formatação enriquecida e imagens.

Além da Tarefa ou do Evento, o Treble pode salvar o histórico de cada conversa em um **objeto personalizado** do Salesforce com formatação enriquecida: quebras de linha, links e imagens que a pessoa enviou pelo WhatsApp.

<Note>
  **Não substitui a Tarefa nem o Evento: soma-se a eles.** Se você criar este objeto, cada conversa encerrada gera a atividade de sempre **e também** um registro no objeto personalizado.
</Note>

<Info>
  **Não há nada para ativar do lado do Treble.** Basta que o objeto exista na sua organização do Salesforce, com o nome e os campos exatos descritos abaixo. O Treble o detecta sozinho e começa a escrever nele.

  Se o objeto não existir, o Treble continua funcionando normalmente e só escreve a Tarefa ou o Evento.
</Info>

<Warning>
  Os nomes de API precisam ser **exatamente** os indicados aqui. Se você mudar algum, o Treble não vai conseguir escrever, e você não vai ver um erro na plataforma: simplesmente não aparecerão registros.
</Warning>

<div class="hr" />

## O que você vai criar

| | Nome de API | Tipo |
| - | - | - |
| O objeto | `TrebleWhatsAppConversation__c` | Objeto personalizado |
| Relacionamento com o registro | `Contact__c` | Relacionamento mestre-detalhe |
| A transcrição | `Messages__c` | Área de texto enriquecido |

Isso é feito no Salesforce, com um usuário administrador. Leva cerca de 10 minutos.

<div class="hr" />

## 1. Criar o objeto

<Steps>
  <Step title="Entre no Setup">
    Clique no ícone de engrenagem no canto superior direito e escolha **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 o Setup no Salesforce" width="320" className="mx-auto" data-path="images/salesforce-custom-object-1.png" />
  </Step>

  <Step title="Abra o Object Manager">
    Busque "object manager" na barra de busca do Setup e entre no **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 o Object Manager" className="mx-auto" width="3456" height="370" data-path="images/salesforce-custom-object-2.png" />
  </Step>

  <Step title="Crie um objeto personalizado">
    Clique em **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="Criar um objeto personalizado" className="mx-auto" width="3442" height="528" data-path="images/salesforce-custom-object-3.png" />
  </Step>

  <Step title="Preencha a definição do 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="Formulário de definição do 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` (ou o texto que preferir) |
    | **Data Type** | `Text` |

    <Warning>
      O **Object Name** é o que importa. O Salesforce adiciona `__c` automaticamente, então o nome de API fica como `TrebleWhatsAppConversation__c`. Escreva exatamente assim, sem espaços.
    </Warning>

    Salve. Ao terminar, a tela de **Details** deve mostrar o nome de API correto:

    <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="Detalhes do objeto Treble Conversation já criado" className="mx-auto" width="3456" height="1566" data-path="images/salesforce-custom-object-5.png" />
  </Step>
</Steps>

<div class="hr" />

## 2. Criar o relacionamento com o registro

Este campo é o que conecta cada conversa à pessoa a quem ela pertence.

<Steps>
  <Step title="Entre em Fields & Relationships → New">
    Dentro do objeto **Treble Conversation**, abra a aba **Fields & Relationships** e clique em **New**.
  </Step>

  <Step title="Escolha 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="Escolher o tipo de campo Master-Detail Relationship" className="mx-auto" width="3450" height="1740" data-path="images/salesforce-custom-object-6.png" />
  </Step>

  <Step title="Relacione-o com o objeto da pessoa">
    Em **Related To**, escolha o objeto onde ficam seus contatos (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="Escolher o objeto relacionado" className="mx-auto" width="3444" height="1742" data-path="images/salesforce-custom-object-7.png" />
  </Step>

  <Step title="Nomeie o 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="Nomear o campo de relacionamento" 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>
      O **Field Name** deve ser exatamente `Contact`, porque o nome de API resultante (`Contact__c`) é o que o Treble usa ao escrever.
    </Warning>

    Avance pelos passos restantes (visibilidade por perfil e page layouts) com os valores padrão e salve.
  </Step>
</Steps>

<div class="hr" />

## 3. Criar o campo de mensagens

<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="Escolher o tipo de campo Text Area (Rich)" className="mx-auto" width="3444" height="1742" data-path="images/salesforce-custom-object-9.png" />

    Tem que ser **Text Area (Rich)**, não *Text Area (Long)*. O texto enriquecido é o que permite ver as quebras de linha e as imagens da conversa.
  </Step>

  <Step title="Preencha os detalhes do 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="Detalhes do 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` (o máximo) |
    | **# Visible Lines** | `25` |

    <Tip>
      Use o comprimento máximo. Conversas longas podem ocupar bastante espaço, e um campo curto faria com que o final da transcrição se perdesse.
    </Tip>

    Salve.
  </Step>
</Steps>

<Check>
  Pronto. A partir da próxima conversa que for encerrada, você vai ver novos registros em **Treble Conversations**, relacionados ao registro de cada pessoa.
</Check>

<div class="hr" />

## Como fica cada registro

| Campo | O que contém |
| - | - |
| **Name** | A data e a hora de início da conversa, seguidas do seu identificador interno. Por exemplo: `2026-10-13 14:22:05 - 8f3c...` |
| **Contact** | O registro da pessoa |
| **Messages** | A transcrição completa, com formatação: cada mensagem em sua linha, e as imagens que a pessoa enviou incorporadas |

<Tip>
  Adicione a lista relacionada **Treble Conversations** ao page layout do objeto dos seus contatos. Assim o assessor vê todas as conversas dessa pessoa diretamente no registro, sem precisar procurá-las.
</Tip>

<div class="hr" />

## Problemas frequentes

<AccordionGroup>
  <Accordion title="Criei o objeto, mas nenhum registro aparece">
    Revise os nomes de API um por um. É o que falha na maioria dos casos:

    * O objeto deve ser `TrebleWhatsAppConversation__c`
    * O campo de relacionamento deve ser `Contact__c`
    * O campo de mensagens deve ser `Messages__c`

    Um nome diferente faz com que a escrita falhe em silêncio: o Treble continua criando a Tarefa ou o Evento, mas não o registro do objeto personalizado.
  </Accordion>

  <Accordion title="O objeto existe, mas o usuário da integração não o vê">
    Ao criar um objeto personalizado, o Salesforce deixa as permissões **desabilitadas para todos os perfis** por padrão. Confirme que o perfil do usuário com o qual o Treble se conectou tem permissões de leitura e criação sobre o objeto e seus campos.
  </Accordion>

  <Accordion title="Uso multi-objeto e não sei a qual objeto relacioná-lo">
    O relacionamento mestre-detalhe aponta para **um único** objeto. Se a sua operação distribui as pessoas entre vários objetos, fale com o seu Customer Success Manager antes de criá-lo, para definir qual convém e o que acontece com os registros dos demais.
  </Accordion>

  <Accordion title="As mensagens aparecem cortadas">
    O campo foi criado com um comprimento menor que o máximo. Edite-o e aumente o comprimento para `131072`.
  </Accordion>

  <Accordion title="Posso deixar de usar a Tarefa ou o Evento e ficar só com isto?">
    Não a partir da plataforma. O Treble sempre escreve a Tarefa ou o Evento; o objeto personalizado é adicional. Se a duplicação atrapalhar, fale com o seu Customer Success Manager.
  </Accordion>
</AccordionGroup>

<div class="hr" />

## Próximos passos

<CardGroup cols={2}>
  <Card title="Histórico de conversa" icon="clock-rotate-left" href="/pt/docs/integrations/salesforce/features/activities">
    Quando é escrito e quais campos são preenchidos na Tarefa ou no Evento.
  </Card>

  <Card title="Ver o WhatsApp dentro do Salesforce" icon="window-maximize" href="/pt/docs/integrations/salesforce/embed/custom-tab">
    Responder conversas ativas sem sair do CRM.
  </Card>
</CardGroup>


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