> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# BotPenguin

> BotPenguin is an AI chatbot platform for managing contacts, conversations, bot integrations, and cross-platform customer messaging.

![BotPenguin logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/botpenguin.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=4a3121f91d3bdbe7335d9289bbdb6ced)

* **Category:** ai chatbots
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 6
* **Triggers:** 0
* **Slug:** `BOTPENGUIN`
* **Version:** 20261030\_00

## Tools

> [accordion] Get Template Dynamic Fields
>
> **Slug:** `BOTPENGUIN_GET_TEMPLATE_DYNAMIC_FIELDS`
>
> Return the dynamic key-value fields required by a BotPenguin WhatsApp template.
>
> #### Input Parameters
>
> **template\_id** `string` *required*
>
> Template ID returned by List WhatsApp Templates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Import Contacts
>
> **Slug:** `BOTPENGUIN_IMPORT_CONTACTS`
>
> Import contacts in bulk into BotPenguin. Existing contacts may be updated, and the operation does not return contact IDs.
>
> #### Input Parameters
>
> **contacts** `array` *required*
>
> Contacts to import; each item accepts a name, optional email and phone details, tags, and custom attributes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Inbox Contacts
>
> **Slug:** `BOTPENGUIN_LIST_INBOX_CONTACTS`
>
> Return one page of BotPenguin inbox contacts filtered by whether the contact has interacted with a bot.
>
> #### Input Parameters
>
> **page** `integer`
>
> One-based result page to return; increase it until contacts is empty.
>
> **user\_interacted** `boolean`
>
> Return contacts whose bot-interaction state matches this value; this is the filter verified live.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Segments
>
> **Slug:** `BOTPENGUIN_LIST_SEGMENTS`
>
> List the contact segments configured in the connected BotPenguin account, including each segment's filter definition and contact count.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List WhatsApp Bots
>
> **Slug:** `BOTPENGUIN_LIST_WHATSAPP_BOTS`
>
> List WhatsApp bots available to the connected BotPenguin account for use with plugin template tools.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List WhatsApp Templates
>
> **Slug:** `BOTPENGUIN_LIST_WHATSAPP_TEMPLATES`
>
> List WhatsApp templates available to a BotPenguin bot.
>
> #### Input Parameters
>
> **bot\_id** `string` *required*
>
> WhatsApp bot ID returned by List WhatsApp Bots.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
