# 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

***


---

# 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/api-documentation/contacts-and-chats-apis.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.