Botbaba

Learn how to use Botbaba with Composio

Overview

SLUG: BOTBABA

Description

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

Authentication Details

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.

1

Select App

Navigate to Botbaba.

2

Configure Auth Config Settings

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

3

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

1from composio import Composio
2
3# Replace these with your actual values
4botbaba_auth_config_id = "ac_YOUR_BOTBABA_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def 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
27connection_id = authenticate_toolkit(user_id, botbaba_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(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

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["BOTBABA"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def 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
33invoke_llm()

Tool List

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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
search
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

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

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

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

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

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

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

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

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

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
email
string
first_name
string
last_name
string
phone
string
tags
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

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

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

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

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