# 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.