# Integrations

### 📌 Overview

BotPenguin’s AI Agents can connect with a wide range of external applications to automate workflows, enrich agent capabilities, synchronize data, and surface real-time responses across platforms. 

**Benefits of Integrations**

* Push and pull data between your AI agent and tools like CRMs, calendars, spreadsheets, support desks, and more. 
* Automate repetitive business processes based on user interactions. 
* Provide real-time, data-driven responses during conversations. 
* Centralize operations across support, marketing, sales, productivity, and analytics. 

***

### 🔌 1. Integration Types

BotPenguin supports integrations in **three main ways**:

#### 🧩 A. **Native Integrations**

These are built-in connectors in the BotPenguin dashboard where you authenticate and link your account directly. 

**Common categories include:**

* **CRM Systems:** Salesforce, Zoho CRM, HubSpot, Pipedrive, Agile CRM, Nimble, Nutshell, Copper, EngageBay, Salesflare, No CRM, and more.
* **Customer Support Tools:** Freshdesk, HelpDesk, Helpcrunch, LiveAgent, Helprace. 
* **Task & Project Management:** Zoho Projects. 
* **Marketing & Automation:** GetResponse, Drip CRM, Groove. 
* **E-Commerce & Analytics:** Shopify, Razorpay, Google Analytics. 
* **Productivity Apps:** Google Drive, Google Sheets, Outlook, Google Contacts. 
* **Automation Platforms:** Zapier, Make (Integromat). 

*Note:* For a full, up-to-date list, check the BotPenguin integrations page inside the documentation or dashboard.

***

#### 🔄 B. **Workflow Tools**

Use automation platforms like **Zapier** or **Make.com** to connect BotPenguin with thousands of other apps. [Zapier+1](https://zapier.com/apps/botpenguin/integrations?utm_source=chatgpt.com)

Examples:

* Trigger workflows when a lead is created and send data to CRM/Sheets/Slack. [Zapier](https://zapier.com/apps/botpenguin/integrations?utm_source=chatgpt.com)
* Enrich incoming messages with AI and update support tickets. [Zapier](https://zapier.com/apps/botpenguin/integrations?utm_source=chatgpt.com)
* Sync bot events with project management tools like Trello, Jira, or Asana. [Zapier](https://zapier.com/apps/botpenguin/integrations?utm_source=chatgpt.com)

***

#### ⚙️ C. **Custom API Integrations**

If an app isn’t natively supported, you can build a custom integration using:

* **BotPenguin API** integration (custom REST API calls in chatflows or automation). 
* The **“My Integration” builder** in the Integrations tab to register third-party APIs with headers, parameters, and payloads. [partners.botpenguin.com](https://partners.botpenguin.com/customer-platform-guidelines/chatflow-setup/3rd-party-api-in-chatflows/create-your-custom-integration?utm_source=chatgpt.com)

***

### 🛠 2. How to Enable Integrations

#### Step 1 — **Access Integrations**

1. Log into your **BotPenguin dashboard**.
2. Go to your **AI Agent** or chosen bot.
3. Open the **Integrations** tab (or *Third-Party Apps Integrations*).
4. Browse or search for the tool you want to connect. 

***

#### Step 2 — **Connect a Native Integration**

General pattern (for CRMs, support tools, etc.):

1. Click **Connect** next to the integration.
2. **Authenticate** with the third-party platform (OAuth or API key).
3. Provide required credentials like API Token, Client ID/Secret, Domain, or Redirect URL.
4. Click **Authorize / Connect**.

**Example: Salesforce**

* Click *Salesforce* → *Connect*.
* Enter **Domain, Client ID, Client Secret, Redirect URL** from Salesforce Developer setup.
* Complete OAuth flow and grant permissions. 

***

#### Step 3 — **Test the Integration**

Once connected:

* Create a test conversation with your AI Agent that should trigger the integration (e.g., lead capture, support ticket creation).
* Verify that data appears correctly in the external app. 

***

### 📋 3. Custom API Integration (Use Case)

If a specific app is not listed:

#### A. **Using My Integration**

1. Go to **Third-Party Apps Integrations → My Integration**.
2. Add **Integration Name, Description, API Endpoint, Method** (GET/POST), headers and body.
3. Save and use in your bot flows. [partners.botpenguin.com](https://partners.botpenguin.com/customer-platform-guidelines/chatflow-setup/3rd-party-api-in-chatflows/create-your-custom-integration?utm_source=chatgpt.com)

***

#### B. **Using the 3rd Party Apps API**

1. In the BotPenguin **Developer** section, select *3rd Party Apps API*.
2. Create a new API config with URL, parameters, headers, body, etc.
3. Map dynamic attributes to pass user inputs in calls.
4. Save and test the API integration. 

***

### 📦 4. Best Practices

#### 🔑 Security

* Use **OAuth where possible** over API key.
* Store credentials securely and rotate keys when compromised.
* Implement rate-limit handling on API calls. [BotPenguin](https://botpenguin.com/glossary/api-integration?utm_source=chatgpt.com)

#### 🔄 Data Mapping

* Define clear mapping between BotPenguin fields and external API payload fields.
* Validate mapping with test data. 

#### 🧪 Testing

* Always **test with dummy interactions** before production use.
* Log and monitor integration activity for errors.

#### 🔄 Maintainability

* Centralize webhook or automation logic when possible.
* Keep documentation of credentials and flows.
* Use workflow tool logs (Zapier/Make) for auditing.


---

# 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://help.botpenguin.com/settings/integrations.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.