> ## 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. # Conversations custom object > How to create the Treble Conversation object in Salesforce to save the WhatsApp history with rich formatting and images. In addition to the Task or Event, Treble can save each conversation's history in a Salesforce **custom object** with rich formatting: line breaks, links and images the person sent over WhatsApp. **It doesn't replace the Task or Event: it adds to them.** If you create this object, each closed conversation generates the usual activity **and also** a record in the custom object. **There's nothing to enable on Treble's side.** The object just needs to exist in your Salesforce org, with the exact name and fields described below. Treble detects it on its own and starts writing to it. If the object doesn't exist, Treble keeps working normally and only writes the Task or Event. The API names must be **exactly** the ones listed here. If you change one, Treble won't be able to write, and you won't see an error in the platform: records simply won't appear.
## What you're going to create | | API name | Type | | - | - | - | | The object | `TrebleWhatsAppConversation__c` | Custom object | | Relationship to the record | `Contact__c` | Master-detail relationship | | The transcript | `Messages__c` | Rich text area | This is done in Salesforce, with an administrator user. It takes about 10 minutes.
## 1. Create the object Click the gear icon at the top right and choose **Setup**. Open Setup in Salesforce Search for "object manager" in the Setup search bar and go to **Object Manager**. Search for Object Manager Click **Create → Custom Object**. Create a custom object Custom object definition form | Field | Value | | - | - | | **Label** | `Treble Conversation` | | **Plural Label** | `Treble Conversations` | | **Object Name** | `TrebleWhatsAppConversation` | | **Record Name** | `Treble Conversation Name` (or whatever text you prefer) | | **Data Type** | `Text` | The **Object Name** is the one that matters. Salesforce adds `__c` automatically, so the API name ends up as `TrebleWhatsAppConversation__c`. Type it exactly like this, without spaces. Save. When you're done, the **Details** screen should show the correct API name: Details of the Treble Conversation object once created
## 2. Create the relationship to the record This field is what connects each conversation to the person it belongs to. Inside the **Treble Conversation** object, open the **Fields & Relationships** tab and click **New**. Choose the Master-Detail Relationship field type In **Related To**, choose the object where your contacts live (usually `Contact`). Choose the related object Name the relationship field | Field | Value | | - | - | | **Field Label** | `Contact` | | **Field Name** | `Contact` | | **Child Relationship Name** | `TrebleWhatsAppConversations` | | **Sharing Setting** | `Read/Write` | The **Field Name** must be exactly `Contact`, because the resulting API name (`Contact__c`) is the one Treble uses when writing. Go through the remaining steps (profile visibility and page layouts) with the default values and save.
## 3. Create the messages field Choose the Text Area (Rich) field type It has to be **Text Area (Rich)**, not *Text Area (Long)*. Rich text is what lets you see the line breaks and images in the conversation. Messages field details | Field | Value | | - | - | | **Field Label** | `Messages` | | **Field Name** | `Messages` | | **Length** | `131072` (the maximum) | | **# Visible Lines** | `25` | Use the maximum length. Long conversations can take up quite a bit of space, and a short field would cause the end of the transcript to be lost. Save. Done. Starting with the next conversation that's closed, you'll see new records in **Treble Conversations**, related to each person's record.
## What each record looks like | Field | What it contains | | - | - | | **Name** | The conversation's start date and time, followed by its internal identifier. For example: `2026-10-13 14:22:05 - 8f3c...` | | **Contact** | The person's record | | **Messages** | The full transcript, formatted: each message on its own line, with the images the person sent embedded | Add the **Treble Conversations** related list to the page layout of your contacts' object. That way the advisor sees all of that person's conversations directly in the record, without having to look for them.
## Common issues Check the API names one by one. That's what fails in most cases: * The object must be `TrebleWhatsAppConversation__c` * The relationship field must be `Contact__c` * The messages field must be `Messages__c` A different name makes the write fail silently: Treble keeps creating the Task or Event, but not the custom object record. When you create a custom object, Salesforce leaves permissions **disabled for all profiles** by default. Confirm that the profile of the user Treble connected with has read and create permissions on the object and its fields. The master-detail relationship points to **a single** object. If your operation spreads people across several objects, talk to your Customer Success Manager before creating it, to define which one is best and what happens with the records of the others. The field was created with a length lower than the maximum. Edit it and raise the length to `131072`. Not from the platform. Treble always writes the Task or Event; the custom object is additional. If the duplication gets in your way, talk to your Customer Success Manager.
## Next steps When it's written and which fields are filled in on the Task or Event. Reply to active conversations without leaving the CRM. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.