Skip to main content
Botbaba logo
  • Category: ai chatbots
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 42
  • Triggers: 0
  • Slug: BOTBABA
  • Version: 20261101_00

Tools

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_CART_CREATION_SHOPIFY_WEBHOOKTool 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.

Input Parameters

object
required
Full JSON payload sent by Shopify for Cart Creation event
string
Webhook topic
string
Webhook delivery ID
string
API version
string
HMAC-SHA256 signature
string
Shop domain
string
Trigger timestamp

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_CART_UPDATE_SHOPIFY_WEBHOOKTool to forward Shopify cart update events to BotBaba. Use when processing Shopify Cart Update webhook after configuring the webhook in your store.

Input Parameters

object
required
Full JSON object received from Shopify when a cart is updated
string
Webhook topic, typically ‘carts/update’
string
Webhook delivery ID
string
API version
string
HMAC-SHA256 signature
string
Shop domain
string
Trigger timestamp (ISO 8601)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOKForward a Shopify checkout creation webhook payload to BotBaba.

Input Parameters

object
required
JSON payload of Shopify Checkout Creation event sent by Shopify
string
Webhook topic
string
Webhook delivery ID
string
API version
string
HMAC-SHA256 signature
string
Shop domain
string
Trigger timestamp

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOKTool to forward Shopify checkout/update events to Botbaba. Use when handling Shopify checkout update notifications.

Input Parameters

object
required
The full JSON payload received from Shopify’s ‘checkout/update’ webhook
string
Webhook topic, typically ‘checkouts/update’
string
Webhook delivery ID
string
API version
string
HMAC-SHA256 signature
string
Shop domain
string
Trigger timestamp (ISO 8601)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_DELETE_BROADCASTTool to delete a broadcast campaign. Use when you need to permanently remove a Botbaba broadcast by its ID after confirming it exists.

Input Parameters

string
required
Unique identifier of the broadcast campaign to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_DELETE_CONTACTTool to delete a contact. Use when you have the contact ID and want to remove it from Botbaba.

Input Parameters

string
required
ID of the contact to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_DELETE_FLOWTool to delete a conversation flow. Use when you need to permanently remove a Botbaba flow by its ID after confirming it exists.

Input Parameters

string
required
Unique identifier of the conversation flow to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_DELETE_TAGTool 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.

Input Parameters

string
required
ID of the tag to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_DELETE_TEMPLATETool 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.

Input Parameters

string
required
Unique identifier of the message template to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_DELETE_WEBHOOKTool to delete a webhook subscription. Use when you have the webhook ID and want to remove it from Botbaba.

Input Parameters

string
required
Unique identifier of the webhook subscription to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_EXECUTE_BOT_ACTIONRequest execution of a bot action or workflow, optionally for a specific conversation. The returned success flag reflects an accepted HTTP response and does not necessarily confirm action execution.

Input Parameters

string
Name or identifier of the action to execute
string
Conversation ID where the action should be executed
string
Comma-separated tag IDs to associate with the action execution
integer
ID of the bot action to execute

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_EXECUTE_BOT_ACTION_BY_USERTool to execute a bot action for specific users. Use when you need to trigger actions for one or multiple bot users.

Input Parameters

string
The action name or type to execute
integer
The unique identifier of the bot
integer
The unique identifier of the action to execute
array
List of bot user IDs to execute the action for
string
Additional JSON payload for the action execution

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_GET_BOT_WIDGET_SETTINGSRetrieve widget configuration settings for a bot by ID. Use this to inspect its widget display, styling, or behavior; the result can contain only the bot ID when settings are not available in the response.

Input Parameters

integer
required
Unique identifier of the bot to retrieve widget settings for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_GET_BROADCASTRetrieve details of a broadcast by ID. Non-JSON responses may be returned as raw HTML with the requested ID rather than broadcast details.

Input Parameters

string
required
Unique identifier of the broadcast to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_GET_CONTACTFetch a BotBaba contact by ID, returning available normalized contact fields. Results can be incomplete and may not be matched to the requested ID.

Input Parameters

string
required
ID of the BotBaba contact to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_GET_CONTACT_ANALYTICSAggregate contact interaction metrics from messages, along with tag and broadcast counts. Supplied dates are echoed but do not filter the data; unavailable source data may yield zero counts.

Input Parameters

string
End date for analytics in ISO 8601 format (e.g., ‘2023-01-31’).
string
Start date for analytics in ISO 8601 format (e.g., ‘2023-01-01’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_GET_FILENAMETool to extract the filename from a file path. Use when you need to parse a file path and retrieve just the filename component.

Input Parameters

string
required
Full file path from which to extract the filename

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_GET_FLOWRetrieve a flow by ID, including by matching a returned list. The result may be empty if no list item matches or the response is not JSON.

Input Parameters

string
required
Unique identifier for the flow

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_GET_MESSAGERetrieve a specific message by ID to check its delivery status after sending. When the source does not provide a status, the returned status defaults to sent and does not confirm delivery.

Input Parameters

string
required
Unique identifier of the message to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_GET_MESSAGE_ANALYTICSRetrieve analytics for a specific message to help assess its delivery and engagement. The result may instead contain message details or response text.

Input Parameters

string
required
Unique identifier of the message to retrieve analytics for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_GET_TEMPLATETool to retrieve details of a specific template. Use when you need to confirm template details before sending a message using a template.

Input Parameters

string
required
Unique identifier of the template to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_GET_WEBHOOKRetrieve details of a Botbaba webhook by ID to inspect its configuration, for example when investigating event deliveries.

Input Parameters

string
required
Unique identifier of the webhook to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_LIST_BROADCASTSTool to list all broadcast campaigns. Use when retrieving BotBaba broadcast campaigns with pagination.

Input Parameters

integer
Number of broadcasts to retrieve per request (1-100)
integer
Offset for pagination (starting index, zero-based)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_LIST_FLOWSTool to list all conversation flows with their IDs and metadata. Use when you need to retrieve all available flows from your BotBaba account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_LIST_TAGSTool to list all tags. Use when you need to retrieve all tags available in your Botbaba account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_LIST_TEMPLATESTool to retrieve a paginated list of templates. Use when you need to browse or manage existing templates; supports optional search filtering.

Input Parameters

integer
Page number to retrieve, must be ≥ 1
integer
Number of templates per page
Search term to filter templates by name or content

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_LIST_WEBHOOK_EVENT_TYPESList webhook event type identifiers to help choose events when creating or updating a Botbaba webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_LIST_WEBHOOKSTool to list all registered webhooks. Use when you need to retrieve and manage webhook subscriptions in your BotBaba account.

Input Parameters

integer
Number of webhooks to retrieve per request (1-100)
integer
Offset for pagination (starting index, zero-based)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_ORDER_CANCELLATION_SHOPIFY_WEBHOOKAcknowledge a supplied Shopify orders/cancelled webhook payload by returning success; the action does not verify the signature or process the order.

Input Parameters

object
required
JSON payload of the Shopify order cancellation event
string
required
Webhook topic header; expected ‘orders/cancelled’
string
required
Unique webhook delivery ID
string
Admin API version used to serialize the payload
string
required
HMAC-SHA256 signature to verify the webhook origin
string
required
Shop domain sending the webhook, e.g., store.myshopify.com
string
required
ISO-8601 timestamp when Shopify triggered the webhook

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_ORDER_FULFILLMENT_EVENT_SIMULATORTool to simulate a Shopify order fulfillment webhook payload. Use when generating test payloads for BOTBABA_ORDER_FULFILLMENT_SHOPIFY_WEBHOOK.

Input Parameters

string ("standard" | "with_tracking" | "partial" | "missing_location")
Variant of the fulfillment payload to simulate: ‘standard’, ‘with_tracking’, ‘partial’, or ‘missing_location’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_ORDER_FULFILLMENT_SHOPIFY_WEBHOOKAcknowledge a supplied Shopify fulfillment webhook payload and extract its fulfillment ID, order ID and status. The action does not verify the webhook signature.

Input Parameters

object
required
Full JSON payload sent by Shopify for Order Fulfillment event
string
Webhook topic
string
Webhook delivery ID
string
API version
string
HMAC-SHA256 signature
string
Shop domain
string
Trigger timestamp

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_ORDER_PAYMENT_SHOPIFY_WEBHOOKAcknowledge a supplied Shopify order payment webhook payload and extract order and payment details. The action does not verify the webhook signature.

Input Parameters

object
required
Full JSON payload sent by Shopify for the Order Payment event
string
Webhook topic
string
Event identifier
string
Webhook delivery ID
string
API version
string
HMAC-SHA256 signature
string
Shop domain
string
Trigger timestamp

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_SEND_WHATSAPP_TEMPLATE_MESSAGESSend a WhatsApp template message via Botbaba using the full message JSON from the Template UI. The returned raw response may contain an HTTP 400 error rather than a successful send.

Input Parameters

object
required
Full JSON payload for the template message, as generated by Botbaba’s Template UI. Use the ‘Copy Send Message Request’ button to obtain this JSON.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_SHOPIFY_CHECKOUT_CREATION_EVENT_SIMULATORTool to simulate a Shopify checkout creation webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOK.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_SHOPIFY_CHECKOUT_UPDATE_EVENT_SIMULATORTool to simulate a Shopify checkout update webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOK.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_UPDATE_CONTACTTool to update an existing contact. Use when needing to modify contact details after confirming contact_id.

Input Parameters

array
List of tags associated with the contact
string
Email address of the contact
string
Phone number of the contact
string
Last name of the contact
string
required
The unique identifier of the contact to update
string
First name of the contact
object
Custom fields to update for the contact

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_UPDATE_TAGTool to update an existing tag. Use when renaming a tag after confirming its tag ID.

Input Parameters

string
required
New name for the tag
string
required
Unique identifier of the tag to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_UPDATE_TEMPLATEUpdate an existing Botbaba message template by ID, specifying the name, content, type or placeholder definitions to change. Returns the updated template details when available.

Input Parameters

string
New name for the template
string
Type of the template, e.g., text or media
string
Updated content of the template with placeholders
array
List of parameters/placeholders definitions, if updating
string
required
Unique identifier of the template to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_UPDATE_WEBHOOKUpdate an existing webhook by ID, changing its callback URL, subscribed events, or activation status. A returned record does not necessarily confirm that the update was applied.

Input Parameters

string
New callback URL for the webhook
boolean
Whether the webhook is active or not
array
List of event types to subscribe to (e.g., [‘message.incoming’, ‘contact.created’])
string
required
Unique identifier of the webhook to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_WA_GUPSHUP_EVENT_SIMULATORTool to simulate Gupshup WhatsApp webhook events. Use when testing BOTBABA_WA_GUPSHUP_MESSAGE dispatcher with different event types.

Input Parameters

string
Text body for ‘message’ events
string
required
Phone number of the message sender including country code, e.g., ‘919876543210’
string
required
Phone number of the message recipient including country code
integer
Unix timestamp in milliseconds. Defaults to current time if not provided
string ("message" | "delivery" | "read" | "opt-in" | "opt-out" | "interactive")
required
Type of Gupshup webhook event to simulate
string
Unique message identifier. Required for delivery or read events
object
Interactive message payload for ‘interactive’ events

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTBABA_WA_GUPSHUP_MESSAGETool to forward inbound WhatsApp webhook events from Gupshup to Botbaba. Use when handling the POST callback from Gupshup’s WhatsApp integration.

Input Parameters

object
required
Entire JSON payload sent by Gupshup for the WhatsApp message/event

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not