Botbaba | Composio Docs

Overview

SLUG: BOTBABA

Description

Botbaba provides APIs for building and managing chatbots, including conversational AI and messaging integrations.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Botbaba

Create an auth config

Use the dashboard to create an auth config for the Botbaba toolkit. This allows you to connect multiple Botbaba accounts to Composio for agents to use.

Select App

Navigate to Botbaba.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Botbaba Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 botbaba_auth_config_id = "ac_YOUR_BOTBABA_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Botbaba for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, botbaba_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Botbaba toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["BOTBABA"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

BOTBABA_CART_CREATION_EVENT_SIMULATOR

Tool Name: Shopify Cart Creation Simulator

Description

Tool to simulate a Shopify cart creation webhook payload. Use when generating test payloads for BOTBABA_CART_CREATION_SHOPIFY_WEBHOOK.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_CART_CREATION_SHOPIFY_WEBHOOK

Tool Name: Cart Creation Shopify Webhook

Description

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.

Action Parameters

X-Shopify-API-Version

string

X-Shopify-Hmac-SHA256

string

X-Shopify-Shop-Domain

string

X-Shopify-Topic

string

X-Shopify-Triggered-At

string

X-Shopify-Webhook-Id

string

payload

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_CART_UPDATE_SHOPIFY_WEBHOOK

Tool Name: Cart Update Shopify Webhook

Description

Tool to forward Shopify cart update events to BotBaba. Use when processing Shopify Cart Update webhook after configuring the webhook in your store.

Action Parameters

payload

objectRequired

x_shopify_api_version

string

x_shopify_hmac_sha256

string

x_shopify_shop_domain

string

x_shopify_topic

string

x_shopify_triggered_at

string

x_shopify_webhook_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOK

Tool Name: Shopify Checkout Creation Webhook Receiver

Description

Tool to receive Shopify checkout creation webhook events. Use when configuring your Shopify store to notify BotBaba of checkout creation events.

Action Parameters

X-Shopify-API-Version

string

X-Shopify-Hmac-SHA256

string

X-Shopify-Shop-Domain

string

X-Shopify-Topic

string

X-Shopify-Triggered-At

string

X-Shopify-Webhook-Id

string

payload

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOK

Tool Name: Checkout Update Shopify Webhook

Description

Tool to forward Shopify checkout/update events to Botbaba. Use when handling Shopify checkout update notifications.

Action Parameters

webhook_payload

objectRequired

x_shopify_api_version

string

x_shopify_hmac_sha256

string

x_shopify_shop_domain

string

x_shopify_topic

string

x_shopify_triggered_at

string

x_shopify_webhook_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_DELETE_BROADCAST

Tool Name: Delete a broadcast campaign

Description

Tool to delete a broadcast campaign. Use when you need to permanently remove a Botbaba broadcast by its ID after confirming it exists.

Action Parameters

broadcast_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_DELETE_CONTACT

Tool Name: Delete Contact

Description

Tool to delete a contact. Use when you have the contact ID and want to remove it from Botbaba.

Action Parameters

contact_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_DELETE_FLOW

Tool Name: Delete a conversation flow

Description

Tool to delete a conversation flow. Use when you need to permanently remove a Botbaba flow by its ID after confirming it exists.

Action Parameters

flow_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_DELETE_TAG

Tool Name: Delete Tag

Description

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.

Action Parameters

tag_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_DELETE_TEMPLATE

Tool Name: Delete Template

Description

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.

Action Parameters

template_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_DELETE_WEBHOOK

Tool Name: Delete a webhook subscription

Description

Tool to delete a webhook subscription. Use when you have the webhook ID and want to remove it from Botbaba.

Action Parameters

webhook_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_GET_BROADCAST

Tool Name: Get Broadcast

Description

Tool to retrieve details of a specific broadcast. Use when you need to confirm broadcast settings or status after creating or scheduling a broadcast.

Action Parameters

broadcast_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_GET_CONTACT

Tool Name: Get BotBaba Contact

Description

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.

Action Parameters

contact_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_GET_CONTACT_ANALYTICS

Tool Name: Get Contact Analytics

Description

Tool to retrieve analytics data for contacts. Use when you need summary metrics (e.g., new or active contacts) over a date range.

Action Parameters

end_date

string

start_date

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_GET_FLOW

Tool Name: Get Flow

Description

Tool to retrieve details of a specific flow. Use when you need the full configuration for a given flow ID.

Action Parameters

flow_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_GET_MESSAGE

Tool Name: Get Message

Description

Tool to retrieve status of a specific message. Use after sending a message to check its delivery status.

Action Parameters

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_GET_MESSAGE_ANALYTICS

Tool Name: Get Message Analytics

Description

Tool to retrieve analytics data for a specific message. Use after sending a message to analyze its delivery and engagement statistics.

Action Parameters

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_GET_TEMPLATE

Tool Name: Get Template

Description

Tool to retrieve details of a specific template. Use when you need to confirm template details before sending a message using a template.

Action Parameters

template_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_GET_WEBHOOK

Tool Name: Get Webhook

Description

Tool to retrieve details of a specific webhook. Use when you need to confirm webhook configuration before debugging event deliveries.

Action Parameters

webhook_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_LIST_BROADCASTS

Tool Name: List Broadcasts

Description

Tool to list all broadcast campaigns. Use when retrieving BotBaba broadcast campaigns with pagination.

Action Parameters

limit

integerDefaults to 50

offset

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_LIST_FLOWS

Tool Name: List Flows

Description

Tool to list all conversation flows with their IDs and metadata. Use when you need to retrieve all available flows from your BotBaba account.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_LIST_MESSAGES

Tool Name: List Messages

Description

Tool to list all messages. Use when retrieving sent/received messages with optional pagination.

Action Parameters

limit

integerDefaults to 50

offset

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_LIST_TAGS

Tool Name: List Tags

Description

Tool to list all tags. Use when you need to retrieve all tags available in your Botbaba account.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_LIST_TEMPLATES

Tool Name: List Templates

Description

Tool to retrieve a paginated list of templates. Use when you need to browse or manage existing templates; supports optional search filtering.

Action Parameters

limit

integerDefaults to 50

page

integerDefaults to 1

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_LIST_WEBHOOK_EVENT_TYPES

Tool Name: List Webhook Event Types

Description

Tool to list available webhook event types. Use before creating or updating a webhook to ensure you subscribe to valid event identifiers.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_LIST_WEBHOOKS

Tool Name: List Webhooks

Description

Tool to list all registered webhooks. Use when you need to retrieve and manage webhook subscriptions in your BotBaba account.

Action Parameters

limit

integerDefaults to 50

offset

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_ORDER_CANCELLATION_SHOPIFY_WEBHOOK

Tool Name: Receive Shopify Order Cancellation Webhook

Description

Tool to receive Shopify order cancellation webhooks. Use when handling Shopify orders/cancelled events from your store.

Action Parameters

X-Shopify-API-Version

string

X-Shopify-Hmac-SHA256

stringRequired

X-Shopify-Shop-Domain

stringRequired

X-Shopify-Topic

stringRequired

X-Shopify-Triggered-At

stringRequired

X-Shopify-Webhook-Id

stringRequired

payload

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_ORDER_FULFILLMENT_EVENT_SIMULATOR

Tool Name: Order Fulfillment Simulator

Description

Tool to simulate a Shopify order fulfillment webhook payload. Use when generating test payloads for BOTBABA_ORDER_FULFILLMENT_SHOPIFY_WEBHOOK.

Action Parameters

variant

stringDefaults to standard

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_ORDER_FULFILLMENT_SHOPIFY_WEBHOOK

Tool Name: Order Fulfillment Shopify Webhook

Description

Tool to receive Shopify Order Fulfillment webhooks. Use when configuring Shopify webhook for order fulfillment events and forwarding the payload to Botbaba. Must be called upon receiving Shopify payload.

Action Parameters

X-Shopify-API-Version

string

X-Shopify-Hmac-SHA256

string

X-Shopify-Shop-Domain

string

X-Shopify-Topic

string

X-Shopify-Triggered-At

string

X-Shopify-Webhook-Id

string

payload

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_ORDER_PAYMENT_SHOPIFY_WEBHOOK

Tool Name: Order Payment Shopify Webhook

Description

Tool to receive Shopify Order Payment webhooks. Use when configuring Shopify webhook for Order Payment events and forwarding the payload to Botbaba. Must be called upon receiving Shopify payload.

Action Parameters

X-Shopify-API-Version

string

X-Shopify-Event-Id

string

X-Shopify-Hmac-SHA256

string

X-Shopify-Shop-Domain

string

X-Shopify-Topic

string

X-Shopify-Triggered-At

string

X-Shopify-Webhook-Id

string

payload

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_SEND_WHATSAPP_TEMPLATE_MESSAGES

Tool Name: Send WhatsApp Template Message

Description

Tool to forward/send a WhatsApp template message via Botbaba. Use after copying the full message JSON from the Template UI.

Action Parameters

payload

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_SHOPIFY_CHECKOUT_CREATION_EVENT_SIMULATOR

Tool Name: Shopify Checkout Creation Simulator

Description

Tool to simulate a Shopify checkout creation webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOK.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_SHOPIFY_CHECKOUT_UPDATE_EVENT_SIMULATOR

Tool Name: Shopify Checkout Update Simulator

Description

Tool to simulate a Shopify checkout update webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOK.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_UPDATE_CONTACT

Tool Name: Update Contact

Description

Tool to update an existing contact. Use when needing to modify contact details after confirming contact_id.

Action Parameters

contact_id

stringRequired

custom_fields

object

string

first_name

string

last_name

string

phone

string

BOTBABA_UPDATE_TAG

Tool Name: Update Tag

Description

Tool to update an existing tag. Use when renaming a tag after confirming its tag ID.

Action Parameters

name

stringRequired

tag_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_UPDATE_TEMPLATE

Tool Name: Update Template

Description

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.

Action Parameters

content

string

name

string

parameters

template_id

stringRequired

type

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_UPDATE_WEBHOOK

Tool Name: Update Webhook

Description

Tool to update an existing webhook. Use when modifying webhook URL, events, or activation status after confirming the webhook ID.

Action Parameters

active

boolean

events

array

url

string

webhook_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_WA_GUPSHUP_EVENT_SIMULATOR

Tool Name: Gupshup WhatsApp Webhook Event Simulator

Description

Tool to simulate Gupshup WhatsApp webhook events. Use when testing BOTBABA_WA_GUPSHUP_MESSAGE dispatcher with different event types.

Action Parameters

event_type

stringRequired

interactive

object

message_id

string

recipient

stringRequired

sender

stringRequired

text

string

timestamp

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

BOTBABA_WA_GUPSHUP_MESSAGE

Tool Name: Forward Gupshup Webhook Message

Description

Tool to forward inbound WhatsApp webhook events from Gupshup to Botbaba. Use when handling the POST callback from Gupshup's WhatsApp integration.

Action Parameters

payload

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired