# Create your custom integration

BotPenguin `My Integrations` feature enables you to make a custom integration with your App and BotPenguin. Here are detailed instructions for you.

### Custom Integration Guide <a href="#custom-integration-guide" id="custom-integration-guide"></a>

Follow below steps to create the integration between your app and BotPenguin

#### 1. Navigate to the BotPenguin My Integration Section <a href="#id-1.-navigate-to-the-botpenguin-my-integration-section" id="id-1.-navigate-to-the-botpenguin-my-integration-section"></a>

* Login to [BotPenguin Dashboard](https://app.botpenguin.com/) and open the `Third-Party Apps Integrations` .

You can find the integration setting in center under highlighted bot

<figure><img src="/files/lAOB4oCN0Gyl39DiVpTT" alt=""><figcaption></figcaption></figure>

* Navigate to the `My Integration` tab under `Third-party Apps Integration` and click on `Add Integration` button.

#### 2. Create New Integration <a href="#id-2.-create-new-integration" id="id-2.-create-new-integration"></a>

* Filled the basic integration details such as
  * Name of the integration
  * Logo of your app
  * Description
* Once you have filled in basic details, Enter the API URL which creates the lead, tasks, or ticket in your app, depending on your use case.
* Define API Method and enter the request body, or you can also define the API parameter and header one by one.
* Add the header keys if there is a need to do so. You can find option in the bottom to add the
* Validate your request using the `Validate` button.

#### 3. Map your bot questions with API body parameter <a href="#id-3.-map-your-bot-questions-with-api-body-parameter" id="id-3.-map-your-bot-questions-with-api-body-parameter"></a>

* Once you have filled in all the details, You will require to map your bot questions to the API Parameters. You can add new parameters from the option available on top.

For example, you select a question from `Question`: 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 your app’s **Name** field in the leads. Similarly, for integration to work correctly, you will require to map all other questions/ components of your Bot to your app's field.

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.

* Once done, Save your integration and run a test.

#### 4. Test your Integration Set up with Data <a href="#x3dzdlz6r1mf" id="x3dzdlz6r1mf"></a>

Once you have established a connection between **BotPenguin** and **your app**, you are ready to go for your first test lead. You can test your integration setup by creating a dummy lead on the bot. This lead should appear in your BotPenguin dashboard as well as in the app you have integrated.

### Not Working, Let’s Troubleshoot! <a href="#kv3gzu3jags5" id="kv3gzu3jags5"></a>

If you are not getting dummy leads from your Bot to your app, 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 API Token, API key, and/or URL, have been entered correctly.
* Free plan- You are not subscribed to the paid plan on BotPenguin, as integration works only in a paid plan.

#### Need Help?

Please feel free to reach out to us at <mark style="color:$primary;"><support@botpenguin.com></mark>, in case of any questions or concerns.


---

# 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/chatflow-setup/3rd-party-api-in-chatflows/create-your-custom-integration.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.