Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
42 tools available
Botbaba provides APIs for building and managing chatbots, including conversational AI and messaging integrations.
Connect Botbaba to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Botbaba's 42 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Every Botbaba action below is a callable tool any Definable persona can invoke.
Tool to simulate a Shopify cart creation webhook payload. Use when generating test payloads for BOTBABA_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.
Tool to forward Shopify cart update events to BotBaba. Use when processing Shopify Cart Update webhook after configuring the webhook in your store.
Tool to receive Shopify checkout creation webhook events. Use when configuring your Shopify store to notify BotBaba of checkout creation events.
Tool to forward Shopify checkout/update events to Botbaba. Use when handling Shopify checkout update notifications.
Tool to delete a broadcast campaign. Use when you need to permanently remove a Botbaba broadcast by its ID after confirming it exists.
Tool to delete a contact. Use when you have the contact ID and want to remove it from Botbaba.
Tool to delete a conversation flow. Use when you need to permanently remove a Botbaba flow by its ID after confirming it exists.
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.
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.
Tool to delete a webhook subscription. Use when you have the webhook ID and want to remove it from Botbaba.
Tool to execute a bot action or workflow. Use when triggering automated actions or workflows for a specific conversation.
Tool to execute a bot action for specific users. Use when you need to trigger actions for one or multiple bot users.
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.
Tool to retrieve details of a specific broadcast. Use when you need to confirm broadcast settings or status after creating or scheduling a broadcast.
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.
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.
Tool to extract the filename from a file path. Use when you need to parse a file path and retrieve just the filename component.
Tool to retrieve details of a specific flow. Use when you need the full configuration for a given flow ID.
Tool to retrieve status of a specific message. Use after sending a message to check its delivery status.
Tool to retrieve analytics data for a specific message. Use after sending a message to analyze its delivery and engagement statistics.
Tool to retrieve details of a specific template. Use when you need to confirm template details before sending a message using a template.
Tool to retrieve details of a specific webhook. Use when you need to confirm webhook configuration before debugging event deliveries.
Tool to list all broadcast campaigns. Use when retrieving BotBaba broadcast campaigns with pagination.
Tool to list all conversation flows with their IDs and metadata. Use when you need to retrieve all available flows from your BotBaba account.
Tool to list all tags. Use when you need to retrieve all tags available in your Botbaba account.
Tool to retrieve a paginated list of templates. Use when you need to browse or manage existing templates; supports optional search filtering.
Tool to list available webhook event types. Use before creating or updating a webhook to ensure you subscribe to valid event identifiers.
Tool to list all registered webhooks. Use when you need to retrieve and manage webhook subscriptions in your BotBaba account.
Tool to receive Shopify order cancellation webhooks. Use when handling Shopify orders/cancelled events from your store.
Tool to simulate a Shopify order fulfillment webhook payload. Use when generating test payloads for BOTBABA_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.
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.
Tool to forward/send a WhatsApp template message via Botbaba. Use after copying the full message JSON from the Template UI.
Tool to simulate a Shopify checkout creation webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOK.
Tool to simulate a Shopify checkout update webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOK.
Tool to update an existing contact. Use when needing to modify contact details after confirming contact_id.
Tool to update an existing tag. Use when renaming a tag after confirming its tag ID.
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.
Tool to update an existing webhook. Use when modifying webhook URL, events, or activation status after confirming the webhook ID.
Tool to simulate Gupshup WhatsApp webhook events. Use when testing BOTBABA_WA_GUPSHUP_MESSAGE dispatcher with different event types.
Tool to forward inbound WhatsApp webhook events from Gupshup to Botbaba. Use when handling the POST callback from Gupshup's WhatsApp integration.
Anything Botbaba exposes through its API. Common ai chatbots workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 42 Botbaba tools directly, then chain the result into another integration without you writing code.
Botbaba uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Yes — every Definable plan, including Starter, includes access to all 42 Botbaba tools. You only need a separate Botbaba subscription if Botbaba itself charges per seat or per API call.
Every call from a persona to Botbaba is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
Sign up for Definable, open the integrations page, find Botbaba, and connect via OAuth or API key. You can immediately attach Botbaba to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
Definable exposes all 42 Botbaba actions as callable tools — including `Shopify Cart Creation Simulator`, `Cart Creation Shopify Webhook`, `Cart Update Shopify Webhook`, plus 39 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Wire it up in minutes. No coding required.