# Botsonic

Botsonic is a no-code AI chatbot builder that enables users to create and integrate AI chatbots into their websites without any coding knowledge.

- **Category:** ai chatbots
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `BOTSONIC`
- **Version:** 20260312_00

## Tools

### Bulk Upload Bot URLs

**Slug:** `BOTSONIC_BULK_UPLOAD_URLS`

Tool to bulk upload URLs for bot training. Use when you need to upsert multiple document URLs into a bot in one request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `urls` | array | Yes | List of valid URLs to be upserted into the bot's data source. |
| `ability_id` | string | No | UUID for ability association (optional). |
| `is_crawled` | boolean | No | Whether URLs have been pre-crawled (default: false). |
| `is_sitemap` | boolean | No | Set to true if uploading from a sitemap (default: false). |
| `sitemap_id` | string | No | Associated sitemap identifier (optional). |
| `sitemap_root` | string | No | Root URL of the sitemap (optional). |

#### 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 |

### Create Starter Question

**Slug:** `BOTSONIC_CREATE_STARTER_QUESTION`

Tool to create a new starter question for the bot. Use when you need to add a preset question-answer pair that users can quickly select.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | integer | No | Set order in which this question appears. Default: 0 |
| `answer` | string | Yes | Answer for the given question. |
| `question` | string | Yes | A starter question that will be displayed to users. |

#### 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 Starter Question

**Slug:** `BOTSONIC_DELETE_STARTER_QUESTION`

Deletes a specific starter question from a bot using its unique identifier. This operation is destructive and permanent. First retrieve available starter questions using the Get All Starter Questions action to obtain valid IDs before deletion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the starter question to delete. Obtain this ID from the Get All Starter Questions action. |

#### 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 Uploaded File

**Slug:** `BOTSONIC_DELETE_UPLOADED_FILE`

Delete a specific uploaded file/bot data entry by its unique identifier. This permanently removes the file from the bot's training data. Use this action when you need to clean up outdated content, remove incorrect data, or manage bot training materials. The file ID can be obtained using the Get All Bot Data action. Returns the full deleted object details including metadata, status, and timestamps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | The unique identifier (data_id) of the uploaded file to delete. This ID can be obtained from the Get All Bot Data action. |

#### 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 All Bot Data

**Slug:** `BOTSONIC_GET_ALL_BOT_DATA`

Tool to retrieve all data associated with the bot, including files and resources. Use when you need a comprehensive export of bot assets for backup or inspection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number, minimum 1 |
| `size` | integer | No | Page size between 1 and 100 |
| `sort_by` | string | No | Attribute to sort by |
| `sort_order` | string ("asc" | "desc") | No | Sort order for results |
| `search_query` | string | No | Search for data matching a particular query |

#### 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 All Bots

**Slug:** `BOTSONIC_GET_ALL_BOTS`

Retrieve all bots associated with your account. Supports pagination, search, and sorting to efficiently manage and query bot configurations. Use this when you need to list, search, or filter existing bots.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Defaults to 1. |
| `size` | integer | No | Number of results per page (1-100). Defaults to 50. |
| `sort_by` | string | No | Field to sort by. Options include: id, owner_id, vectorstore_index_id, is_deleted, is_shared, created_at, updated_at. Defaults to 'created_at'. |
| `sort_order` | string | No | Sort order: 'asc' or 'desc'. Defaults to 'desc'. |
| `search_query` | string | No | Search for bots matching a particular query. |
| `workspace_id` | string | No | Filter bots by workspace ID. |

#### 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 All Conversations

**Slug:** `BOTSONIC_GET_ALL_CONVERSATIONS`

Tool to retrieve all conversations related to the bot. Use after authentication when you need a paginated list of conversation threads for review or analytics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number, minimum 1 |
| `size` | integer | No | Page size between 1 and 100 |
| `sort_by` | string ("recent" | "negative" | "positive") | No | Conversation sorting type: recent, negative, or positive sentiment |
| `sort_order` | string ("asc" | "desc") | No | Sort order for results: ascending (asc) or descending (desc) |
| `search_query` | string | No | Search for conversations matching a particular query |
| `updated_after` | string | No | Filter conversations updated after this datetime (ISO 8601 format) |
| `updated_before` | string | No | Filter conversations updated before this datetime (ISO 8601 format) |

#### 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 All Conversations With Source

**Slug:** `BOTSONIC_GET_ALL_CONVERSATIONS_WITH_SOURCE`

Tool to retrieve all conversations with source information. Use when you need detailed conversation data including source tracking, user form data, and comprehensive metadata for analytics or conversation management.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Minimum 1 |
| `size` | integer | No | Number of results per page. Minimum 1, maximum 20 |
| `sort_by` | string | No | Conversation sorting type: recent, negative, or positive sentiment |
| `chat_ids` | array | No | List of specific chat IDs to retrieve. Leave empty to retrieve all conversations. |
| `sort_order` | string ("asc" | "desc") | No | Sort order for results: ascending (asc) or descending (desc) |
| `search_query` | string | No | Search for conversations matching a particular query |
| `updated_after` | string | No | Filter conversations updated after this datetime (ISO 8601 format). Example: 2024-01-01T00:00:00Z |
| `updated_before` | string | No | Filter conversations updated before this datetime (ISO 8601 format). Example: 2024-12-31T23:59:59Z |

#### 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 All FAQs

**Slug:** `BOTSONIC_GET_ALL_FAQS`

Retrieve all frequently asked questions (FAQs) associated with your bot in paginated format. Returns a list of FAQ entries with their questions, answers, status, and metadata. Supports filtering by search query, sorting by various attributes, and pagination controls. Use this when you need to list, review, or manage bot FAQ entries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number, minimum 1 |
| `size` | integer | No | Page size between 1 and 100 |
| `sort_by` | string ("id" | "bot_id" | "question" | "answer" | "error_reason" | "status" | "characters" | "migration_status" | "created_at" | "updated_at") | No | Attribute to sort by. Valid options: id, bot_id, question, answer, error_reason, status, characters, migration_status, created_at, updated_at |
| `sort_order` | string ("asc" | "desc") | No | Sort order for results: 'asc' for ascending or 'desc' for descending |
| `search_query` | string | No | Search for FAQs matching a particular query string. Filters FAQs by text match in question or answer fields. |

#### 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 All Starter Presets

**Slug:** `BOTSONIC_GET_ALL_STARTER_PRESETS`

Tool to retrieve all starter presets for a bot by bot ID. Use when you need to fetch the bot's welcome message and starter questions configured for user interactions.

#### 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 All Starter Questions

**Slug:** `BOTSONIC_GET_ALL_STARTER_QUESTIONS`

Tool to retrieve all starter questions. Use after authenticating when you need to list the bot’s opening prompts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Minimum: 1. Default: 1 |
| `size` | integer | No | Number of results per page. Maximum: 100. Default: 50 |
| `sort_by` | string | No | Field to sort by. Options: id, bot_id, question, answer, order, created_at, updated_at. Default: order |
| `sort_order` | string | No | Sort order. Options: asc (ascending), desc (descending). Default: asc |
| `search_query` | string | No | Search for starter questions matching a particular query. |

#### 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 Starter Question

**Slug:** `BOTSONIC_UPDATE_STARTER_QUESTION`

Tool to update an existing starter question by its unique identifier. Use after confirming the ID and desired updates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the starter question to update. |
| `order` | integer | No | Set the display order/position of this starter question. |
| `answer` | string | No | Updated answer for the starter question. |
| `question` | string | No | Updated text for the starter question. |

#### 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 |