# Integrate BotPenguin with Salesforce CRM

#### Step 1 of 5: Login to BotPenguin Account and Select Application to Integrate <a href="#step-1-of-5-login-to-botpenguin-account-and-select-application-to-integrate" id="step-1-of-5-login-to-botpenguin-account-and-select-application-to-integrate"></a>

a. Login to your BotPenguin account. Now, select and click the Bot you want to integrate with Salesforce. Click on the **‘Third-Party Apps Integration tab.’**

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FJICfr2VXiW2f8jB8OeCp%252F0%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=1009be26&#x26;sv=1" alt=""><figcaption><p>Bots</p></figcaption></figure>

b. The Integrate window will Open up. Select the **‘Third-Party Apps’** Tab.

c. A list of all native integrations for BotPenguin will be available in this window.

d. Now find Salesforce by:-

* Either by scrolling down the list or,
* by typing **‘Salesforce’** in the Search Box with the placeholder “Search Integration By Name”

e. Now click on the **‘Connect’** button as shown

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FqtLDrPElANLIDSgrFEfr%252F1%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=d1f709b1&#x26;sv=1" alt=""><figcaption><p>Third Party Integration</p></figcaption></figure>

f. An Interface, as shown below, will open up. Here, you will asked to submit the following details

* Domain
* Client ID
* Client Secret

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FEtvYLoydKJhXS7pktAuJ%252F2%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=5fa79edd&#x26;sv=1" alt=""><figcaption><p>Third Party Integration</p></figcaption></figure>

#### Step 2 of 5: Find your Authorization Key/Client Secret in Salesforce CRM Account <a href="#step-2-of-5-find-your-authorization-key-client-secret-in-salesforce-crm-account" id="step-2-of-5-find-your-authorization-key-client-secret-in-salesforce-crm-account"></a>

a. To get the Client ID and Client Secret, login to your Salesforce developer account.

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252F3joXv1Oqvh2enNnNd41i%252F3%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=5130bcd0&#x26;sv=1" alt=""><figcaption><p>Salesforce CRM</p></figcaption></figure>

b. Click on the Settings icon on the top-right. Quick find “connected apps”. Click ‘Manage Connected  Apps’ tab.

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FPNI1ULljDasfyawsnyFY%252F4%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=fbca666a&#x26;sv=1" alt=""><figcaption><p>Salesforce CRM</p></figcaption></figure>

c. Click on the pre-created App

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FWMnQNVFY5S4JMnLosqIp%252F5%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=82a5dbef&#x26;sv=1" alt=""><figcaption><p>Salesforce CRM</p></figcaption></figure>

d. Go to ‘Apps Manager’ and click on your App

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FKaVffXxZ76yZA03GaxaQ%252F6%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=a2d517b5&#x26;sv=1" alt=""><figcaption><p>Salesforce CRM</p></figcaption></figure>

e. Verify the Salesforce account again.

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FfXEFVWtB7aZgu6XceVmv%252F7%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=36134b29&#x26;sv=1" alt=""><figcaption><p>Salesforce CRM</p></figcaption></figure>

f. You will find the Client ID and Client Secret Token. The Domain will be the URL here.

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FzXxiWvBrkrhS6HaaaCJV%252F8%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=8f867ea5&#x26;sv=1" alt=""><figcaption><p>Salesforce CRM</p></figcaption></figure>

#### Step 3 of 5: Enter Authorization Details and establish connection with your CRM <a href="#step-3-of-5-enter-authorization-details-and-establish-connection-with-your-crm" id="step-3-of-5-enter-authorization-details-and-establish-connection-with-your-crm"></a>

a. Enter the Salesforce Domain, Client ID and Client Secret and click the ‘Connect’ button to complete integration of BotPenguin with Salesforce..

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FZ7YmwTqQEGTh5uOrbEgp%252F9%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=d28cddc3&#x26;sv=1" alt=""><figcaption><p>Third Party Integration</p></figcaption></figure>

b. If you have entered all the details correctly, you will be redirected to Salesforce login to verify again.

#### Step 4 of 5: Set up Mapping Parameters <a href="#step-4-of-5-set-up-mapping-parameters" id="step-4-of-5-set-up-mapping-parameters"></a>

a. Now, as the connection of the BotPenguin and Salesforce CRM is established, you need to map **parameters(fields) of Salesforce CRM** to the user response to the BotPenguin question.

You can use the **+Add Parameters** button to add more fields.

For example, you select a question from All bot questions/components: Please provide your name. Then, you map it with the parameter -Name

As a result, this mapping will enable integration to send the user's response from BotPenguin to the Salesforce CRM’s **Name** field in the leads. Similarly, in order for integration to work properly, you will require to map all other questions/ components of your Bot to Salesforce CRM fields.

Please note that these queries/questions options will be auto-fetched from your bot chat flow, So, make sure you configure your chat flow first.

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252F8KjP7hPwwg9msCaEXZdb%252F10%3Falt%3Dmedia&#x26;width=300&#x26;dpr=4&#x26;quality=100&#x26;sign=12cc9a3f&#x26;sv=1" alt=""><figcaption><p>Third Party Integration</p></figcaption></figure>

b. If you have entered all the details correctly, you will see a notification that says “**Mapping successfully.”**

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FJHXuT1VBPGUYMtjSfUwE%252F11%3Falt%3Dmedia&#x26;width=300&#x26;dpr=4&#x26;quality=100&#x26;sign=ffadd2fd&#x26;sv=1" alt=""><figcaption><p>Third Party Integration</p></figcaption></figure>

c. Also, your Salesforce integration will show the message **Connected** in the Integration List.

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FHfdqYIXerfM5tWHrrVK8%252F12%3Falt%3Dmedia&#x26;width=300&#x26;dpr=4&#x26;quality=100&#x26;sign=5e7986a2&#x26;sv=1" alt=""><figcaption><p>Third Party Integration</p></figcaption></figure>

#### Step 5 of 5: Test your Integration Set up with Data <a href="#step-5-of-5-test-your-integration-set-up-with-data" id="step-5-of-5-test-your-integration-set-up-with-data"></a>

Once you have established a connection between **BotPenguin** and **Salesforce CRM**, and the mapping is complete, you are ready to go for your first test lead. Click the ‘Test Lead’ tab to test your integration setup by creating a dummy lead on the bot. This lead should appear in your Salesforce CRM that you have integrated.

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FNmbRx99Nu9ilS9qv366C%252F13%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=1b08727e&#x26;sv=1" alt=""><figcaption><p>Third Party Integration</p></figcaption></figure>

**Still Not Working, Let’s Troubleshoot!**

If you are not getting dummy leads from your Bot to Salesforce CRM, it may be due to multiple reasons:

* Wrong Authorization Details added- You will be required to check and see if all the authorization credentials such as Domain, Client ID and Client Secret have been entered correctly.
* Wrong Mapping Set up - Your mapping with BotPenguin Question and CRM parameter is either incorrect or you haven’t added any mandatory parameter.
* Free plan- You are not subscribed to the paid plan on BotPenguin as integration works only in paid plan.

If everything is correct and you are still unable to move forward, write to us at [contact@BotPenguin.com](mailto:contact@botpenguin.com). We will respond back within 48 business hours.

[<br>](https://help.botpenguin.com/botpenguin-resource-centre/how-botpenguin-works/3rd-party-apps-integrations/botpenguin-integrations/integrate-botpenguin-with-zingtree)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://partners.botpenguin.com/customer-platform-guidelines/3rd-party-app-integrations/integrate-botpenguin-with-salesforce-crm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
