# Botbaba

```json
{
  "name": "Botbaba",
  "slug": "botbaba",
  "url": "https://composio.dev/toolkits/botbaba",
  "markdown_url": "https://composio.dev/toolkits/botbaba.md",
  "logo_url": "https://logos.composio.dev/api/botbaba",
  "categories": [
    "ai & machine learning"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-05-12T10:03:42.974Z"
}
```

![Botbaba logo](https://logos.composio.dev/api/botbaba)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Botbaba MCP or direct API to automate conversations, manage chatbot flows, send messages, and analyze chat data through natural language.

## Summary

Botbaba is a platform for building, managing, and deploying conversational AI chatbots across messaging channels. It streamlines chatbot automation, making it easier to integrate AI into customer interactions.

## Categories

- ai & machine learning

## Toolkit Details

- Tools: 42

## Images

- Logo: https://logos.composio.dev/api/botbaba

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Botbaba.
  - Setup:
    - Configure Api Key credentials for Botbaba.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Deploy new chatbot to WhatsApp channel
- Update chatbot greeting message instantly
- Fetch conversation logs for last 24 hours
- Add quick-reply buttons to main menu

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `BOTBABA_CART_CREATION_EVENT_SIMULATOR` | Shopify Cart Creation Simulator | Tool to simulate a Shopify cart creation webhook payload. Use when generating test payloads for BOTBABA_CART_CREATION_SHOPIFY_WEBHOOK. |
| `BOTBABA_CART_CREATION_SHOPIFY_WEBHOOK` | Cart Creation Shopify Webhook | Tool to receive Shopify Cart Creation webhooks. Use when configuring Shopify webhook for Cart Creation events and forwarding the payload to Botbaba. Must be called upon receiving Shopify payload. |
| `BOTBABA_CART_UPDATE_SHOPIFY_WEBHOOK` | Cart Update Shopify Webhook | Tool to forward Shopify cart update events to BotBaba. Use when processing Shopify Cart Update webhook after configuring the webhook in your store. |
| `BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOK` | Shopify Checkout Creation Webhook Receiver | Tool to receive Shopify checkout creation webhook events. Use when configuring your Shopify store to notify BotBaba of checkout creation events. |
| `BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOK` | Checkout Update Shopify Webhook | Tool to forward Shopify checkout/update events to Botbaba. Use when handling Shopify checkout update notifications. |
| `BOTBABA_DELETE_BROADCAST` | Delete a broadcast campaign | Tool to delete a broadcast campaign. Use when you need to permanently remove a Botbaba broadcast by its ID after confirming it exists. |
| `BOTBABA_DELETE_CONTACT` | Delete Contact | Tool to delete a contact. Use when you have the contact ID and want to remove it from Botbaba. |
| `BOTBABA_DELETE_FLOW` | Delete a conversation flow | Tool to delete a conversation flow. Use when you need to permanently remove a Botbaba flow by its ID after confirming it exists. |
| `BOTBABA_DELETE_TAG` | Delete Tag | Tool to delete a tag. Use when you have a tag ID and want to remove it from Botbaba. Tries multiple known Botbaba endpoint variations to improve compatibility across deployments. |
| `BOTBABA_DELETE_TEMPLATE` | Delete Template | Tool to delete a message template. Use when you have the template ID and want to remove it from Botbaba. Tries multiple known Botbaba endpoint variations to improve compatibility across deployments. |
| `BOTBABA_DELETE_WEBHOOK` | Delete a webhook subscription | Tool to delete a webhook subscription. Use when you have the webhook ID and want to remove it from Botbaba. |
| `BOTBABA_EXECUTE_BOT_ACTION` | Execute Bot Action | Tool to execute a bot action or workflow. Use when triggering automated actions or workflows for a specific conversation. |
| `BOTBABA_EXECUTE_BOT_ACTION_BY_USER` | Execute Bot Action By User | Tool to execute a bot action for specific users. Use when you need to trigger actions for one or multiple bot users. |
| `BOTBABA_GET_BOT_WIDGET_SETTINGS` | Get Bot Widget Settings | Tool to retrieve widget configuration settings for a bot. Use when you need to check or verify the widget display settings, styling, or behavior configuration for a specific bot. |
| `BOTBABA_GET_BROADCAST` | Get Broadcast | Tool to retrieve details of a specific broadcast. Use when you need to confirm broadcast settings or status after creating or scheduling a broadcast. |
| `BOTBABA_GET_CONTACT` | Get BotBaba Contact | Tool to fetch a BotBaba contact by its ID. Use when you need to retrieve the full details of a contact after creation or update. |
| `BOTBABA_GET_CONTACT_ANALYTICS` | Get Contact Analytics | Tool to retrieve analytics data for contacts. Use when you need summary metrics (e.g., new or active contacts) over a date range. Note: BotBaba API does not have a dedicated contact analytics endpoint. This action aggregates data from messages and tags to provide contact interaction metrics. |
| `BOTBABA_GET_FILENAME` | Get Filename from Path | Tool to extract the filename from a file path. Use when you need to parse a file path and retrieve just the filename component. |
| `BOTBABA_GET_FLOW` | Get Flow | Tool to retrieve details of a specific flow. Use when you need the full configuration for a given flow ID. |
| `BOTBABA_GET_MESSAGE` | Get Message | Tool to retrieve status of a specific message. Use after sending a message to check its delivery status. |
| `BOTBABA_GET_MESSAGE_ANALYTICS` | Get Message Analytics | Tool to retrieve analytics data for a specific message. Use after sending a message to analyze its delivery and engagement statistics. |
| `BOTBABA_GET_TEMPLATE` | Get Template | Tool to retrieve details of a specific template. Use when you need to confirm template details before sending a message using a template. |
| `BOTBABA_GET_WEBHOOK` | Get Webhook | Tool to retrieve details of a specific webhook. Use when you need to confirm webhook configuration before debugging event deliveries. |
| `BOTBABA_LIST_BROADCASTS` | List Broadcasts | Tool to list all broadcast campaigns. Use when retrieving BotBaba broadcast campaigns with pagination. |
| `BOTBABA_LIST_FLOWS` | List Flows | Tool to list all conversation flows with their IDs and metadata. Use when you need to retrieve all available flows from your BotBaba account. |
| `BOTBABA_LIST_TAGS` | List Tags | Tool to list all tags. Use when you need to retrieve all tags available in your Botbaba account. |
| `BOTBABA_LIST_TEMPLATES` | List Templates | Tool to retrieve a paginated list of templates. Use when you need to browse or manage existing templates; supports optional search filtering. |
| `BOTBABA_LIST_WEBHOOK_EVENT_TYPES` | List Webhook Event Types | Tool to list available webhook event types. Use before creating or updating a webhook to ensure you subscribe to valid event identifiers. |
| `BOTBABA_LIST_WEBHOOKS` | List Webhooks | Tool to list all registered webhooks. Use when you need to retrieve and manage webhook subscriptions in your BotBaba account. |
| `BOTBABA_ORDER_CANCELLATION_SHOPIFY_WEBHOOK` | Receive Shopify Order Cancellation Webhook | Tool to receive Shopify order cancellation webhooks. Use when handling Shopify orders/cancelled events from your store. |
| `BOTBABA_ORDER_FULFILLMENT_EVENT_SIMULATOR` | Order Fulfillment Simulator | Tool to simulate a Shopify order fulfillment webhook payload. Use when generating test payloads for BOTBABA_ORDER_FULFILLMENT_SHOPIFY_WEBHOOK. |
| `BOTBABA_ORDER_FULFILLMENT_SHOPIFY_WEBHOOK` | Order Fulfillment Shopify Webhook | Tool to receive Shopify Order Fulfillment webhooks. Use when handling Shopify fulfillments/create or fulfillments/update events from your store. This action acknowledges receipt of the webhook and extracts key fulfillment details. |
| `BOTBABA_ORDER_PAYMENT_SHOPIFY_WEBHOOK` | Order Payment Shopify Webhook | Tool to receive Shopify Order Payment webhooks. Use when handling Shopify orders/paid events from your store. This action acknowledges receipt of the webhook and extracts key payment details from the order. |
| `BOTBABA_SEND_WHATSAPP_TEMPLATE_MESSAGES` | Send WhatsApp Template Message | Tool to forward/send a WhatsApp template message via Botbaba. Use after copying the full message JSON from the Template UI. |
| `BOTBABA_SHOPIFY_CHECKOUT_CREATION_EVENT_SIMULATOR` | Shopify Checkout Creation Simulator | Tool to simulate a Shopify checkout creation webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOK. |
| `BOTBABA_SHOPIFY_CHECKOUT_UPDATE_EVENT_SIMULATOR` | Shopify Checkout Update Simulator | Tool to simulate a Shopify checkout update webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOK. |
| `BOTBABA_UPDATE_CONTACT` | Update Contact | Tool to update an existing contact. Use when needing to modify contact details after confirming contact_id. |
| `BOTBABA_UPDATE_TAG` | Update Tag | Tool to update an existing tag. Use when renaming a tag after confirming its tag ID. |
| `BOTBABA_UPDATE_TEMPLATE` | Update Template | Tool to update an existing message template. Use when you need to modify template details after confirming its template ID. Tries multiple base URLs, HTTP methods, and path variants to be resilient across different Botbaba deployments. |
| `BOTBABA_UPDATE_WEBHOOK` | Update Webhook | Tool to update an existing webhook. Use when modifying webhook URL, events, or activation status after confirming the webhook ID. |
| `BOTBABA_WA_GUPSHUP_EVENT_SIMULATOR` | Gupshup WhatsApp Webhook Event Simulator | Tool to simulate Gupshup WhatsApp webhook events. Use when testing BOTBABA_WA_GUPSHUP_MESSAGE dispatcher with different event types. |
| `BOTBABA_WA_GUPSHUP_MESSAGE` | Forward Gupshup Webhook Message | Tool to forward inbound WhatsApp webhook events from Gupshup to Botbaba. Use when handling the POST callback from Gupshup's WhatsApp integration. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Botbaba Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Botbaba actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Create a new chatbot for customer support on WhatsApp'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a new chatbot for customer support on WhatsApp'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Botbaba tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Create a new chatbot for customer support on WhatsApp')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Create a new chatbot for customer support on WhatsApp' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Botbaba Integration

- Supports both Botbaba MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Botbaba data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Botbaba access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Botbaba
- Scoped, least privilege access to Botbaba resources
- Full audit trail of agent actions to support review and compliance

## Use Botbaba with any AI Agent Framework

Choose a framework you want to connect Botbaba with:

- [OpenAI Agents SDK](https://composio.dev/toolkits/botbaba/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/botbaba/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/botbaba/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/botbaba/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/botbaba/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/botbaba/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/botbaba/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/botbaba/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/botbaba/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/botbaba/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/botbaba/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/botbaba/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/botbaba/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/botbaba/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/botbaba/framework/autogen)

## Related Toolkits

- [Composio](https://composio.dev/toolkits/composio) - Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed.
- [Composio search](https://composio.dev/toolkits/composio_search) - Composio search is a unified web search toolkit spanning travel, e-commerce, news, financial markets, images, and more. It lets you and your apps tap into up-to-date web data from a single, easy-to-integrate service.
- [Perplexityai](https://composio.dev/toolkits/perplexityai) - Perplexityai delivers natural, conversational AI models for generating human-like text. Instantly get context-aware, high-quality responses for chat, search, or complex workflows.
- [Browser tool](https://composio.dev/toolkits/browser_tool) - Browser tool is a virtual browser integration that lets AI agents interact with the web programmatically. It enables automated browsing, scraping, and action-taking from any AI workflow.
- [Ai ml api](https://composio.dev/toolkits/ai_ml_api) - Ai ml api is a suite of AI/ML models for natural language and image tasks. It provides fast, scalable access to advanced AI capabilities for your apps and workflows.
- [Aivoov](https://composio.dev/toolkits/aivoov) - Aivoov is an AI-powered text-to-speech platform offering 1,000+ voices in over 150 languages. Instantly turn written content into natural, human-like audio for any application.
- [All images ai](https://composio.dev/toolkits/all_images_ai) - All-Images.ai is an AI-powered image generation and management platform. It helps you create, search, and organize images effortlessly with advanced AI capabilities.
- [Anthropic administrator](https://composio.dev/toolkits/anthropic_administrator) - Anthropic administrator is an API for managing Anthropic organizational resources like members, workspaces, and API keys. It helps you automate admin tasks and streamline resource management across your Anthropic organization.
- [Api labz](https://composio.dev/toolkits/api_labz) - Api labz is a platform offering a suite of AI-driven APIs and workflow tools. It helps developers automate tasks and build smarter, more efficient applications.
- [Apipie ai](https://composio.dev/toolkits/apipie_ai) - Apipie ai is an AI model aggregator offering a single API for accessing top AI models from multiple providers. It helps developers build cost-efficient, latency-optimized AI solutions without juggling multiple integrations.
- [Astica ai](https://composio.dev/toolkits/astica_ai) - Astica ai provides APIs for computer vision, NLP, and voice synthesis. Integrate advanced AI features into your app with a single API key.
- [Bigml](https://composio.dev/toolkits/bigml) - BigML is a machine learning platform that lets you build, train, and deploy predictive models from your data. Its intuitive interface and robust API make machine learning accessible and efficient.
- [Botpress](https://composio.dev/toolkits/botpress) - Botpress is an open-source platform for building, deploying, and managing chatbots. It helps teams automate conversations and deliver rich, interactive messaging experiences.
- [Chatbotkit](https://composio.dev/toolkits/chatbotkit) - Chatbotkit is a platform for building and managing AI-powered chatbots using robust APIs and SDKs. It lets you easily add conversational AI to your apps for better user engagement.
- [Cody](https://composio.dev/toolkits/cody) - Cody is an AI assistant built for businesses, trained on your company's knowledge and data. It delivers instant answers and insights, tailored for your team.
- [Context7 MCP](https://composio.dev/toolkits/context7_mcp) - Context7 MCP delivers live, version-specific code docs and examples right from the source. It helps developers and AI agents instantly retrieve authoritative programming info—no more out-of-date docs.
- [Customgpt](https://composio.dev/toolkits/customgpt) - CustomGPT.ai lets you build and deploy chatbots tailored to your own data and business needs. Get precise and context-aware AI conversations without writing code.
- [Datarobot](https://composio.dev/toolkits/datarobot) - Datarobot is a machine learning platform that automates model development, deployment, and monitoring. It empowers organizations to quickly gain predictive insights from large datasets.
- [Deepgram](https://composio.dev/toolkits/deepgram) - Deepgram is an AI-powered speech recognition platform for accurate audio transcription and understanding. It enables fast, scalable speech-to-text with advanced audio intelligence features.
- [DeepImage](https://composio.dev/toolkits/deepimage) - DeepImage is an AI-powered image enhancer and upscaler. Get higher-quality images with just a few clicks.

## Frequently Asked Questions

### Do I need my own developer credentials to use Botbaba with Composio?

Yes, Botbaba requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)