# Botbaba

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

- **Category:** ai chatbots
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 43
- **Triggers:** 0
- **Slug:** `BOTBABA`
- **Version:** 20260227_00

## Tools

### Shopify Cart Creation Simulator

**Slug:** `BOTBABA_CART_CREATION_EVENT_SIMULATOR`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cart Creation Shopify Webhook

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | Full JSON payload sent by Shopify for Cart Creation event |
| `X-Shopify-Topic` | string | No | Webhook topic |
| `X-Shopify-Webhook-Id` | string | No | Webhook delivery ID |
| `X-Shopify-API-Version` | string | No | API version |
| `X-Shopify-Hmac-SHA256` | string | No | HMAC-SHA256 signature |
| `X-Shopify-Shop-Domain` | string | No | Shop domain |
| `X-Shopify-Triggered-At` | string | No | Trigger timestamp |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cart Update Shopify Webhook

**Slug:** `BOTBABA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | Full JSON object received from Shopify when a cart is updated |
| `x_shopify_topic` | string | No | Webhook topic, typically 'carts/update' |
| `x_shopify_webhook_id` | string | No | Webhook delivery ID |
| `x_shopify_api_version` | string | No | API version |
| `x_shopify_hmac_sha256` | string | No | HMAC-SHA256 signature |
| `x_shopify_shop_domain` | string | No | Shop domain |
| `x_shopify_triggered_at` | string | No | Trigger timestamp (ISO 8601) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Shopify Checkout Creation Webhook Receiver

**Slug:** `BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOK`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | JSON payload of Shopify Checkout Creation event sent by Shopify |
| `X-Shopify-Topic` | string | No | Webhook topic |
| `X-Shopify-Webhook-Id` | string | No | Webhook delivery ID |
| `X-Shopify-API-Version` | string | No | API version |
| `X-Shopify-Hmac-SHA256` | string | No | HMAC-SHA256 signature |
| `X-Shopify-Shop-Domain` | string | No | Shop domain |
| `X-Shopify-Triggered-At` | string | No | Trigger timestamp |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Checkout Update Shopify Webhook

**Slug:** `BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOK`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_payload` | object | Yes | The full JSON payload received from Shopify's 'checkout/update' webhook |
| `x_shopify_topic` | string | No | Webhook topic, typically 'checkouts/update' |
| `x_shopify_webhook_id` | string | No | Webhook delivery ID |
| `x_shopify_api_version` | string | No | API version |
| `x_shopify_hmac_sha256` | string | No | HMAC-SHA256 signature |
| `x_shopify_shop_domain` | string | No | Shop domain |
| `x_shopify_triggered_at` | string | No | Trigger timestamp (ISO 8601) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete a broadcast campaign

**Slug:** `BOTBABA_DELETE_BROADCAST`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `broadcast_id` | string | Yes | Unique identifier of the broadcast campaign to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Contact

**Slug:** `BOTBABA_DELETE_CONTACT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | ID of the contact to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete a conversation flow

**Slug:** `BOTBABA_DELETE_FLOW`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `flow_id` | string | Yes | Unique identifier of the conversation flow to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Tag

**Slug:** `BOTBABA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_id` | string | Yes | ID of the tag to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Template

**Slug:** `BOTBABA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | Unique identifier of the message template to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete a webhook subscription

**Slug:** `BOTBABA_DELETE_WEBHOOK`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Unique identifier of the webhook subscription to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Execute Bot Action

**Slug:** `BOTBABA_EXECUTE_BOT_ACTION`

Tool to execute a bot action or workflow. Use when triggering automated actions or workflows for a specific conversation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action` | string | No | Name or identifier of the action to execute |
| `conv_id` | string | No | Conversation ID where the action should be executed |
| `tag_ids` | string | No | Comma-separated tag IDs to associate with the action execution |
| `action_id` | integer | No | ID of the bot action to execute |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Execute Bot Action By User

**Slug:** `BOTBABA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action` | string | No | The action name or type to execute |
| `bot_id` | integer | No | The unique identifier of the bot |
| `action_id` | integer | No | The unique identifier of the action to execute |
| `bot_user_id` | array | No | List of bot user IDs to execute the action for |
| `json_payload` | string | No | Additional JSON payload for the action execution |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Bot Widget Settings

**Slug:** `BOTBABA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bot_id` | integer | Yes | Unique identifier of the bot to retrieve widget settings for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Broadcast

**Slug:** `BOTBABA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `broadcast_id` | string | Yes | Unique identifier of the broadcast to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get BotBaba Contact

**Slug:** `BOTBABA_GET_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | ID of the BotBaba contact to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact Analytics

**Slug:** `BOTBABA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | No | End date for analytics in ISO 8601 format (e.g., '2023-01-31'). |
| `start_date` | string | No | Start date for analytics in ISO 8601 format (e.g., '2023-01-01'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Filename from Path

**Slug:** `BOTBABA_GET_FILENAME`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Full file path from which to extract the filename |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Flow

**Slug:** `BOTBABA_GET_FLOW`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `flow_id` | string | Yes | Unique identifier for the flow |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Message

**Slug:** `BOTBABA_GET_MESSAGE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message_id` | string | Yes | Unique identifier of the message to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Message Analytics

**Slug:** `BOTBABA_GET_MESSAGE_ANALYTICS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message_id` | string | Yes | Unique identifier of the message to retrieve analytics for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Template

**Slug:** `BOTBABA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | Unique identifier of the template to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhook

**Slug:** `BOTBABA_GET_WEBHOOK`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Unique identifier of the webhook to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Broadcasts

**Slug:** `BOTBABA_LIST_BROADCASTS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of broadcasts to retrieve per request (1-100) |
| `offset` | integer | No | Offset for pagination (starting index, zero-based) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Flows

**Slug:** `BOTBABA_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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tags

**Slug:** `BOTBABA_LIST_TAGS`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Templates

**Slug:** `BOTBABA_LIST_TEMPLATES`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve, must be ≥ 1 |
| `limit` | integer | No | Number of templates per page |
| `search` | string | No | Search term to filter templates by name or content |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhook Event Types

**Slug:** `BOTBABA_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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhooks

**Slug:** `BOTBABA_LIST_WEBHOOKS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of webhooks to retrieve per request (1-100) |
| `offset` | integer | No | Offset for pagination (starting index, zero-based) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Receive Shopify Order Cancellation Webhook

**Slug:** `BOTBABA_ORDER_CANCELLATION_SHOPIFY_WEBHOOK`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | JSON payload of the Shopify order cancellation event |
| `X-Shopify-Topic` | string | Yes | Webhook topic header; expected 'orders/cancelled' |
| `X-Shopify-Webhook-Id` | string | Yes | Unique webhook delivery ID |
| `X-Shopify-API-Version` | string | No | Admin API version used to serialize the payload |
| `X-Shopify-Hmac-SHA256` | string | Yes | HMAC-SHA256 signature to verify the webhook origin |
| `X-Shopify-Shop-Domain` | string | Yes | Shop domain sending the webhook, e.g., store.myshopify.com |
| `X-Shopify-Triggered-At` | string | Yes | ISO-8601 timestamp when Shopify triggered the webhook |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Order Fulfillment Simulator

**Slug:** `BOTBABA_ORDER_FULFILLMENT_EVENT_SIMULATOR`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `variant` | string ("standard" | "with_tracking" | "partial" | "missing_location") | No | Variant of the fulfillment payload to simulate: 'standard', 'with_tracking', 'partial', or 'missing_location'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Order Fulfillment Shopify Webhook

**Slug:** `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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | Full JSON payload sent by Shopify for Order Fulfillment event |
| `X-Shopify-Topic` | string | No | Webhook topic |
| `X-Shopify-Webhook-Id` | string | No | Webhook delivery ID |
| `X-Shopify-API-Version` | string | No | API version |
| `X-Shopify-Hmac-SHA256` | string | No | HMAC-SHA256 signature |
| `X-Shopify-Shop-Domain` | string | No | Shop domain |
| `X-Shopify-Triggered-At` | string | No | Trigger timestamp |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Order Payment Shopify Webhook

**Slug:** `BOTBABA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | Full JSON payload sent by Shopify for the Order Payment event |
| `X-Shopify-Topic` | string | No | Webhook topic |
| `X-Shopify-Event-Id` | string | No | Event identifier |
| `X-Shopify-Webhook-Id` | string | No | Webhook delivery ID |
| `X-Shopify-API-Version` | string | No | API version |
| `X-Shopify-Hmac-SHA256` | string | No | HMAC-SHA256 signature |
| `X-Shopify-Shop-Domain` | string | No | Shop domain |
| `X-Shopify-Triggered-At` | string | No | Trigger timestamp |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send WhatsApp Template Message

**Slug:** `BOTBABA_SEND_WHATSAPP_TEMPLATE_MESSAGES`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Shopify Checkout Creation Simulator

**Slug:** `BOTBABA_SHOPIFY_CHECKOUT_CREATION_EVENT_SIMULATOR`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Shopify Checkout Update Simulator

**Slug:** `BOTBABA_SHOPIFY_CHECKOUT_UPDATE_EVENT_SIMULATOR`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Contact

**Slug:** `BOTBABA_UPDATE_CONTACT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | List of tags associated with the contact |
| `email` | string | No | Email address of the contact |
| `phone` | string | No | Phone number of the contact |
| `last_name` | string | No | Last name of the contact |
| `contact_id` | string | Yes | The unique identifier of the contact to update |
| `first_name` | string | No | First name of the contact |
| `custom_fields` | object | No | Custom fields to update for the contact |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Tag

**Slug:** `BOTBABA_UPDATE_TAG`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | New name for the tag |
| `tag_id` | string | Yes | Unique identifier of the tag to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Template

**Slug:** `BOTBABA_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the template |
| `type` | string | No | Type of the template, e.g., text or media |
| `content` | string | No | Updated content of the template with placeholders |
| `parameters` | string | No | List of parameters/placeholders definitions, if updating |
| `template_id` | string | Yes | Unique identifier of the template to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Webhook

**Slug:** `BOTBABA_UPDATE_WEBHOOK`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | New callback URL for the webhook |
| `active` | boolean | No | Whether the webhook is active or not |
| `events` | array | No | List of event types to subscribe to (e.g., ['message.incoming', 'contact.created']) |
| `webhook_id` | string | Yes | Unique identifier of the webhook to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Gupshup WhatsApp Webhook Event Simulator

**Slug:** `BOTBABA_WA_GUPSHUP_EVENT_SIMULATOR`

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

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Forward Gupshup Webhook Message

**Slug:** `BOTBABA_WA_GUPSHUP_MESSAGE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | Entire JSON payload sent by Gupshup for the WhatsApp message/event |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |