# Contacts & Chats APIs

The **Contacts & Chats APIs** in BotPenguin allow developers and businesses to programmatically manage contacts, access chat conversations, and sync conversation data with external systems such as CRMs, analytics tools, or internal dashboards.

***

### 📌 What Are Contacts & Chats APIs?

These APIs provide secure access to:

* Contact (visitor) details collected by bots
* Chat conversations between users and bots/agents
* Message history, metadata, and conversation status

They are commonly used for CRM integration, reporting, automation, and custom workflows.

***

### 🔑 Key Capabilities

#### Contacts API

Use the Contacts API to:

* Fetch all contacts created by bots
* Retrieve contact details (name, email, phone, channel, tags)
* Sync contacts with CRMs or databases
* Identify leads generated through bots

#### Chats API

Use the Chats API to:

* Fetch chat conversations
* Access message history (bot + user messages)
* Track chat status (Open / Closed)
* Identify assigned agents and bots
* Analyze conversation timelines

***

### 🧩 Common Use Cases

* Sync BotPenguin leads with CRM systems (HubSpot, Zoho, Salesforce)
* Build custom analytics dashboards
* Store chat transcripts for compliance or QA
* Trigger workflows based on chat events
* Monitor agent or bot performance externally

***