Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
38 tools available
DocsBot AI enables the creation of custom chatbots trained on your documentation, facilitating automated customer support and content generation.
Connect DocsBot AI to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call DocsBot AI's 38 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Every DocsBot AI action below is a callable tool any Definable persona can invoke.
Tool to capture lead information by updating conversation metadata and saving the lead. Works whether or not the conversation has been created yet.
Tool to create a new bot within a team. Use when you have a valid team ID and want to provision a new bot.
Tool to create a new source for a bot. Sources can be URLs, files, sitemaps, and other types. Use when you have content to add to a bot's knowledge base. For file-based sources, first upload the file using the Upload File to Cloud Storage action.
Tool to create a new webhook subscription for a bot. Use when you want to receive real-time notifications for specific events (lead.created, deep_research.done, conversation.escalated, conversation.rated). The target URL must be publicly accessible and support HTTPS.
Tool to delete a specific bot by its ID. Use after confirming the bot ID is correct to permanently remove a bot from the system.
Tool to delete a specific conversation by its ID. Use after confirming the conversation ID is correct to permanently remove a conversation. Requires edit permission.
Tool to delete a specific lead by ID. Use after confirming the lead ID to permanently remove a lead record from the system.
Tool to delete a specific question from history. Use after confirming the question ID to permanently remove a question log entry from the system.
Tool to delete a specific source from a bot by its ID. Use after confirming the source ID is correct to permanently remove a source from the bot's knowledge base.
Tool to delete a webhook (unsubscribe) by its ID. Use after confirming the webhook ID is correct to permanently remove a webhook subscription.
Generates a structured support ticket from a Chat Agent conversation. Use this tool to convert an existing bot conversation into a formatted helpdesk ticket containing a subject line and message body written from the user's perspective. Prerequisites: - Requires a conversation created via the Chat Agent API (not the legacy Chat API) - Requires Standard plan or higher - The conversation must exist and be accessible with the provided credentials
Tool to fetch details of a specific bot by ID within a team. Use after confirming valid team and bot IDs.
Tool to retrieve monthly statistical reports for a bot. Returns question resolution metrics for a selected month. Use this to analyze bot performance and track question resolution trends over time.
Tool to retrieve comprehensive statistics and analytics for a bot over a time period or date range. Returns key metrics (resolution rate, deflection rate, time saved), time series data for questions and ratings, distribution data for feedback and escalations, and agent mode conversation analytics. Use after confirming valid team and bot IDs from List Teams and List Bots actions.
Tool to retrieve detailed information about a specific source by its ID. Use when you need complete metadata about a source including indexed URLs, FAQs, and processing status.
Tool to fetch details of a specific team by its ID. Use when you need full team info including members and settings after confirming the team ID.
Get a presigned upload URL for uploading files as sources. Use this before uploading large files to DocsBot. The workflow is: 1) Get upload URL, 2) Upload file to the URL, 3) Create source with the file path.
Tool to retrieve details of a specific webhook by ID. Use when you need webhook configuration, delivery status, or subscription details.
List all bots for a given team. Returns detailed information about each bot including configuration, statistics, and status. Use this action to discover available bots before performing operations like getting bot details or listing sources.
Tool to list conversation history for a bot with pagination. Returns a limited subset of conversation properties including titles, timestamps, sentiment, and status. Use this to discover conversations before retrieving full details.
Tool to list captured leads for a bot with pagination and date filtering. Use after confirming valid team and bot IDs. Example: "List leads for bot abc123 starting from 2024-01-01."
Tool to list all questions asked of a specific bot. Use after confirming the bot's identifier. Example: "List questions for bot abc123 with status 'unanswered'."
Tool to list all deep research jobs for a bot with pagination support. Use after confirming valid team and bot IDs. Returns details about each research job including status, question, and timestamps.
Retrieves a paginated list of all sources for a specific bot within a team. Sources are the content (URLs, files, sitemaps, etc.) that have been indexed for the bot's knowledge base. Use this to see what data sources a bot has been trained on.
Tool to list all members of a team including their roles. Use when you need to see who has access to a team and their permission levels.
Tool to list all teams. Use when you need to retrieve every team associated with the authenticated user.
List all registered webhooks for a bot. Returns webhook configurations including target URLs, subscribed events, and status. Use this action to discover configured webhooks before creating, updating, or deleting them.
Tool to rate an answer from chat APIs as positive (1), neutral (0), or negative (-1). Use when recording user feedback on bot responses for statistics shown in chat logs.
Tool to refresh a source to re-index its content. Use when a source needs to be updated with the latest content from its origin. Only works with failed sources for retry purposes.
Tool to perform semantic search on a bot's indexed content. Returns the most relevant source chunks for a query. Use when you need to search the bot's knowledge base without triggering a full conversation.
Tool to trigger a test delivery of the conversation.escalated webhook. Use to verify webhook configuration is working correctly.
Tool to trigger a test lead webhook delivery. Use when you need to test webhook integration for lead capture events. Requires owner or admin permissions.
Tool to trigger a deep research webhook delivery test. Use to verify webhook configurations are working correctly.
Tool to trigger a conversation.rated webhook delivery test for a specific bot. Use when you need to test webhook integration for conversation rating events.
Update a bot's configuration settings such as name, description, model, temperature, and appearance. Only fields provided in the request will be modified; omitted fields remain unchanged. Requires valid team_id and bot_id. Use LIST_BOTS to find available bot IDs first.
Tool to update specific fields for a team. Use after confirming the team ID when you need to change the team's name or OpenAI API key. Returns the updated team record.
Tool to update a webhook's status, target URL, label, or expiration date. Use when you need to modify webhook configuration. Requires valid team_id, bot_id, and webhook_id. Only provided fields will be updated.
Upload a file to cloud storage via a presigned URL. Use this tool after obtaining a presigned upload URL from the DocsBot API (GET /teams/:teamId/bots/:botId/upload-url?fileName=FILENAME). The workflow is: 1. Get presigned URL from DocsBot upload-url endpoint 2. Use this tool to upload the file to the presigned URL 3. Create a source using the 'file' path returned from step 1
Anything DocsBot AI 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 38 DocsBot AI tools directly, then chain the result into another integration without you writing code.
DocsBot AI 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 38 DocsBot AI tools. You only need a separate DocsBot AI subscription if DocsBot AI itself charges per seat or per API call.
Every call from a persona to DocsBot AI 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 DocsBot AI, and connect via OAuth or API key. You can immediately attach DocsBot AI to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
Definable exposes all 38 DocsBot AI actions as callable tools — including `Capture Conversation Lead`, `Create Bot`, `Create Bot Source`, plus 35 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Wire it up in minutes. No coding required.