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

# Salesforce

> How to connect to Salesforce and manage your integration

Integrating Salesforce with your Coral account is simple and quick. One set up, your Coral WhatsApp integration supports the following:

* **Daily chat sync** - Transcripts from all chats will be uploaded in a daily batch to Salesforce, at midnight according to a timezone of your choosing.
* **Automatic association with Contacts and Opportunities** - Your chat transcripts can sync to both Contact records and Opportunity records.
* **Contacts sync** - Your new contacts in WhatsApp can be added to Salesforce automatically, and details about your Salesforce Contacts can be added to your Coral account.

<img src="https://mintcdn.com/coralmessaginginc/IjAzzrsuV8-5SntV/images/en/SF-transcript.png?fit=max&auto=format&n=IjAzzrsuV8-5SntV&q=85&s=07f4d630594d4732f8816466a925c80f" alt="Salesforce transcript example" width="825" height="482" data-path="images/en/SF-transcript.png" />

## Integration Requirements

* **Active Salesforce account** - Ensure your Salesforce account is set up.  Only Enterprise tier Salesforce plans, or Professional tier plans with the Web Services API add-on, support the Coral integration.
* **Required Coral permissions** - Only a Coral Admin user can set up Coral integrations.

## Set up the Integration

You must take action in both your Coral account and your Salesforce account to set up the integration.

<AccordionGroup>
  <Accordion title="Ensure Salesforce fields are set up correctly">
    You must have your Contact's phone number used in WhatsApp entered into the Mobile Phone Number, Home Phone Number, Other Phone Number, or Phone Number field in order for the integration to see that your Contact is in an active Coral chat and attach the chat transcript.
  </Accordion>

  <Accordion title="Launch the integration in Coral">
    Log in to your Coral dashboard as an Admin, go to the Integrations tab, click Connect, and follow the prompts.
  </Accordion>

  <Accordion title="Complete the integration in Salesforce">
    As a final step, you need to adjust the default display for your Contact records and/or Opportunities records for all users or your Salesforce account so that the chat transcripts can be viewed.

    1. Go to your Contact page, and on the top-right corner, click on the Cog icon, and select “Edit Page”
           <img src="https://mintcdn.com/coralmessaginginc/1mBtvOgQycHdZdEy/images/en/SF_image1.png?fit=max&auto=format&n=1mBtvOgQycHdZdEy&q=85&s=31afd5706d4d2acfaec03f8d7aea9729" alt="Edit Page" width="1458" height="910" data-path="images/en/SF_image1.png" />

    2. On the left-hand side, you’ll see a list of available components. Search for Chat Transcripts component. Grab and drop it anywhere on the page that you want it to appear to your users, and click Save.
           <img src="https://mintcdn.com/coralmessaginginc/1mBtvOgQycHdZdEy/images/en/SF_image2.png?fit=max&auto=format&n=1mBtvOgQycHdZdEy&q=85&s=3b153e34ff305310f20c2143cd4aba77" alt="Select components" width="1458" height="916" data-path="images/en/SF_image2.png" />

    3. OPTIONAL - If you want to place the component as a new tab on the Contact page, click on the main Tabs component, and add a new Tab. Grab and drag the component in the content section of the new tab you just created.
           <img src="https://mintcdn.com/coralmessaginginc/1mBtvOgQycHdZdEy/images/en/SF_image3.png?fit=max&auto=format&n=1mBtvOgQycHdZdEy&q=85&s=ad556d0d441e184ab16ea70d102bb2a4" alt="Add new tab" width="1458" height="916" data-path="images/en/SF_image3.png" />
           <img src="https://mintcdn.com/coralmessaginginc/1mBtvOgQycHdZdEy/images/en/SF_image4.png?fit=max&auto=format&n=1mBtvOgQycHdZdEy&q=85&s=6e8088451a80a30fe3eaf4fc177dc1e2" alt="Add new tab" width="1458" height="913" data-path="images/en/SF_image4.png" />

    Repeat for Opportunities if you want the transcripts to appear on Opportunity records as well.
  </Accordion>

  <Accordion title="Optional steps">
    * Your Coral WhatsApp chat transcripts will be uploaded to Salesforce daily around midnight, according to the timezone that you choose.  To select your timezone, navigate to the Controls tab in your Coral Admin account.
    * To sync Coral chats to Opportunities in addition to Contacts, please provide your Coral rep with your Salesforce pipeline or Record Type names.
  </Accordion>
</AccordionGroup>
