bubblav_add_crawl_url
ChatGPTAdd a single public URL to be crawled and indexed into the knowledge base, then queue an incremental crawl. Use for individual pages (docs, product pages) not covered by the main site. Subject to plan page limits.
bubblav_add_knowledge
ChatGPTAdd a new text knowledge entry to this website's knowledge base. The content is split into chunks, queued for embedding, and becomes searchable via bubblav_search_knowledge once processed. Subject to plan page limits.
bubblav_create_custom_tool
ChatGPTCreate a new custom webhook tool for the chatbot. Define the tool name, AI description (instructions for when to use it), endpoint URL, authentication type, and argument schema. The tool is activated for the current website by default. Requires Pro plan or higher.
bubblav_create_form
ChatGPTCreate an AI-powered form to collect structured data from visitors (e.g. "Request a quote", "Book a demo"). Each field needs id, type, and label. Valid types: text, email, textarea, select, radio, checkbox, number, rating. Present it in chat via a flow's show_form node, or notify on submit via a form_submitted trigger with data.formId.
bubblav_delete_crawl_url
ChatGPTDelete a previously added manual crawl URL (by id from bubblav_list_crawl_urls). Stops re-indexing that page.
bubblav_delete_custom_tool
ChatGPTPermanently delete a custom webhook tool. This removes the tool and deactivates it from all websites. This action cannot be undone. Use bubblav_list_custom_tools to get the tool ID.
bubblav_delete_flow
ChatGPTPermanently delete a flow and its run history. Use bubblav_list_flows to get the flow_id.
bubblav_delete_form
ChatGPTPermanently delete an AI form and its submissions. Use bubblav_list_forms to get the form_id.
bubblav_delete_knowledge
ChatGPTDelete a text knowledge entry from the knowledge base. Removes the entry and all associated chunks/embeddings. Use this to remove outdated or incorrect information. Requires the knowledge entry ID (from bubblav_list_knowledge_sources).
bubblav_get_answerable_questions
ChatGPTReturn AI-generated questions that the chatbot can confidently answer from its knowledge base. Questions are generated and cached automatically when knowledge is indexed. Each entry includes the question text and a short category label (e.g. Pricing, Support, Product). Use this to understand the chatbot's coverage and showcase capabilities.
bubblav_get_content_gaps
ChatGPTReturn visitor questions that the AI struggled to answer — bot replies with low confidence score (<0.7) or a thumbs-down rating. Each entry includes the question, how often it appeared, and the reasons (low_confidence, bad_rating). Use this to prioritise knowledge base improvements.
bubblav_get_conversation
ChatGPTGet the full details of a single conversation including all messages. Returns conversation metadata plus a chronological list of messages with sender type, content, confidence score, thumbs rating, and response latency. Useful for QA review, debugging AI responses, and customer support analysis.
bubblav_get_crawl_status
ChatGPTCheck crawl/indexing progress: website status, total pages indexed, and pending/processing chunk counts. Use after add_crawl_url, update_sitemaps, recrawl, or upload_knowledge_file to see when new content becomes searchable.
bubblav_get_flow
ChatGPTGet a single flow with its full node/edge definition and webhook secret. Use bubblav_list_flows to get the flow_id.
bubblav_get_hourly_activity
ChatGPTGet hourly activity breakdown showing conversation and support ticket counts per hour (UTC). Returns 24 data points (one per hour), total counts, and peak hour. Use this to identify peak support times and optimize staffing. Defaults to today. Pass date_range for custom periods.
bubblav_get_most_asked_questions
ChatGPTReturn the most frequently asked visitor questions over a date range (default: last 30 days). Questions are aggregated and deduplicated — each entry includes the question text and how many times it was asked. Use this to understand what topics visitors care about most.
bubblav_get_search_widget_config
ChatGPTRead the AI search widget (search box) settings from the Search page: whether AI search / AI overview is on or off, default mode (icon, compact, full), theme (light/dark), placeholder text, result count, keyboard shortcut hint, suggested searches, and icon/compact sizes. This is the search box, NOT the chat widget (use bubblav_get_widget_appearance for the chat bubble). Use before changing search settings.
bubblav_get_search_widget_snippet
ChatGPTGet the ready-to-paste HTML (container div + script tag) to add the BubblaV AI search widget / search box to a website, plus the website id, name, and url. Use this when a user asks how to add, install, or embed the search widget or search box on their site. For the chat widget use bubblav_get_widget_snippet instead.
bubblav_get_website_settings
ChatGPTRead the current website settings: name, URL, status, crawl discovery mode, allowed domains, custom_instructions (the chatbot persona / system prompt — edited on the Behavior page in the dashboard), yolo_mode (unrestricted-knowledge toggle), and auto_apply_learning (publish strong-evidence self-learned answers without manual review; Pro only). Use this before editing the chatbot behaviour or persona.
bubblav_get_widget_appearance
ChatGPTRead the chatbot widget appearance: bot name, greeting/welcome messages, chat suggestions, colors (launcher bubble_color + bubble_icon_color, brand accent, center pill), widget position, the launcher (style, icon, label), greeting bubble toggle, AI disclosure label, product card button labels, branding toggle, logo/avatar URLs, and avatar shape. Use this before customizing the widget look.
bubblav_get_widget_snippet
ChatGPTGet the ready-to-paste HTML snippet to embed the BubblaV chat widget on a website, plus the website id, name, and url. Use this when a user wants to install, add, or embed the BubblaV chat widget on their site.
bubblav_list_conversations
ChatGPTList conversations for this website with optional filters. Returns conversation metadata (id, title, state, platform, visitor email/country, rating). Supports filtering by status (bot/live_support/resolved), platform, and date range. Use bubblav_get_conversation to fetch full message history for a specific conversation.
bubblav_list_crawl_urls
ChatGPTList all configured knowledge sources of type URL: manual crawl URLs, sub-websites, sitemap URLs, and llms.txt URLs. Use this to audit what is being indexed.
bubblav_list_custom_tools
ChatGPTList all custom webhook tools for this website with their activation status. Returns tool id, name, display name, description for AI, endpoint URL, authentication type, HTTP method, and whether the tool is currently active for this website. Use this to review existing tools before creating new ones.
bubblav_list_flows
ChatGPTList flows (visual scenario-builder automations) for this website with their trigger type, active state, and run counts. Requires Pro plan or higher.
bubblav_list_forms
ChatGPTList AI forms for this website with their fields, AI instructions, enabled state, and submission counts. Use the returned form ids for a flow's show_form node or a form_submitted trigger's data.formId filter.
bubblav_list_knowledge_sources
ChatGPTList all knowledge sources for this website. Returns sources from: text entries, Notion pages, Google Docs, Zendesk articles/tickets, and crawled website pages. Each entry includes type, title, sync status, and last sync time. Use this to audit knowledge coverage or find source IDs for deletion.
bubblav_list_leads
ChatGPTList conversations where the visitor provided their email address (captured leads). Returns email, country, platform, conversation state, and timestamp. Supports filtering by platform and date range with pagination. Use this to feed leads into a CRM, export for email campaigns, or monitor lead capture rate.
bubblav_list_unanswered_questions
ChatGPTFind visitor questions that the AI could not answer well — i.e. bot replies with low confidence score, fallback responses, or messages rated thumbs-down by the visitor. Returns the original visitor question, confidence score, and whether it was rated negatively. Use this to identify knowledge gaps and improve your knowledge base.
bubblav_read_report
ChatGPTRead the full analytics report for this website — the same data shown on the Reports page. Returns: total conversations & messages, AI resolution rate (containment_rate), agent transfer rate, avg response time, avg conversation depth, message rating, avg confidence score, estimated cost savings, total leads, top countries, most visited links, and a previous-period comparison. Defaults to the current calendar month. Pass date_range to query any period.
bubblav_search_conversations
ChatGPTFull-text search across all conversation messages for this website. Returns matching message excerpts with surrounding context, conversation metadata, and visitor email if available. Use this to find patterns (e.g. "Find all conversations mentioning billing errors"), audit specific topics, or locate individual customer conversations.
bubblav_search_knowledge
ChatGPTSearch ALL indexed knowledge for this website using full-text search. Covers: crawled pages, Q&A pairs, uploaded files (PDF/DOCX/TXT), Notion pages, Zendesk help-center articles, and Zendesk tickets. Returns matching chunks with source_type so you know where each result came from.
bubblav_sync_ticket_to_knowledge
ChatGPTSync a resolved support ticket to the knowledge base. Formats the ticket conversation as a searchable article, splits into chunks, and queues for embedding. This turns resolved support interactions into reusable knowledge. Requires Pro plan or higher.
bubblav_toggle_custom_tool
ChatGPTEnable or disable a custom tool for this specific website. Tools must be activated per-website before the chatbot can use them. Use bubblav_list_custom_tools to see current activation status.
bubblav_update_custom_tool
ChatGPTUpdate an existing custom webhook tool. Only the fields you provide will be changed. Use bubblav_list_custom_tools to get the tool ID first. Switching authentication_type to "none" permanently clears the stored secret.
bubblav_update_form
ChatGPTUpdate an existing AI form. Only the fields you provide are changed. Use bubblav_list_forms to get the form_id.
bubblav_update_search_widget_config
ChatGPTUpdate the AI search widget (search box) settings on the Search page. Use this to turn AI search / the AI overview on or off (ai_enabled; off shows only instant keyword + semantic results and uses no chat message quota — each AI search uses one message from the plan quota), change the search box mode, theme, placeholder, number of results, keyboard shortcut hint, or suggested searches. Only the fields you provide are changed; everything else is preserved. This is the search box, NOT the chat widget (use bubblav_update_widget_appearance for the chat bubble).
bubblav_update_sitemaps
ChatGPTSet the sitemap and/or llms.txt URLs used to discover pages for crawling. Provide the full replacement array for each list you pass; an incremental crawl is queued automatically. Omit a field to leave it unchanged.
bubblav_update_website_settings
ChatGPTUpdate website settings. Only the fields you provide are changed. Set custom_instructions to change the chatbot persona / system prompt (max 5000 chars; edited on the Behavior page in the dashboard) — e.g. "You are a friendly support agent for Acme. Be concise. Always offer to escalate to a human for refunds." When rewriting custom_instructions, first show the user the complete final text you will save (not a summary) so they can review it before approving. Never shorten or truncate the owner's text to fit the limit — if it would exceed 5000 chars, ask the user what to cut or suggest moving factual content into Q&A / text knowledge.
bubblav_update_widget_appearance
ChatGPTUpdate the chatbot widget appearance (Design page). Only the fields you provide are changed; all other appearance settings are preserved. set primary_color to retheme the brand accent (visitor bubble + send button + CTA). Use product_card_view_label / product_card_view_detail_label to localize the product card buttons. Set avatar_shape to "square" to show the bot avatar and home logo without the circular crop. The closed launcher depends on the position: at bottom-right / bottom-left, launcher_style picks the round "bubble" or a "labeled" pill with launcher_icon and launcher_label; both use bubble_color (background) and bubble_icon_color (icon + label text). At bottom-center the launcher is the center pill, colored by the center_pill_* fields (launcher_style does not apply). Use show_greeting_message to toggle the greeting bubble above the closed launcher, and show_ai_disclosure / ai_disclosure_text for the EU AI Act "AI assistant" label. Hiding "Powered by" branding requires a paid plan.
bubblav_upload_knowledge_file
ChatGPTUpload a file (PDF, DOCX, DOC, TXT, or Markdown, max 10MB) to be extracted and indexed into the knowledge base. Pass the raw bytes as base64_content. Subject to plan page limits. Processing is asynchronous — use bubblav_get_crawl_status to track progress.
bubblav_add_crawl_url
Claudebubblav_add_knowledge
Claudebubblav_create_api_key
Claudebubblav_create_custom_tool
Claudebubblav_create_flow
Claudebubblav_create_form
Claudebubblav_delete_crawl_url
Claudebubblav_delete_custom_tool
Claudebubblav_delete_flow
Claudebubblav_delete_form
Claudebubblav_delete_knowledge
Claudebubblav_get_answerable_questions
Claudebubblav_get_content_gaps
Claudebubblav_get_conversation
Claudebubblav_get_crawl_status
Claudebubblav_get_flow
Claudebubblav_get_hourly_activity
Claudebubblav_get_most_asked_questions
Claudebubblav_get_search_widget_config
Claudebubblav_get_search_widget_snippet
Claudebubblav_get_visitor_insights
Claudebubblav_get_website_settings
Claudebubblav_get_widget_appearance
Claudebubblav_get_widget_snippet
Claudebubblav_list_api_keys
Claudebubblav_list_connected_tools
Claudebubblav_list_conversations
Claudebubblav_list_crawl_urls
Claudebubblav_list_custom_tools
Claudebubblav_list_flow_runs
Claudebubblav_list_flows
Claudebubblav_list_forms
Claudebubblav_list_knowledge_sources
Claudebubblav_list_leads
Claudebubblav_list_tool_logs
Claudebubblav_list_unanswered_questions
Claudebubblav_read_report
Claudebubblav_revoke_api_key
Claudebubblav_scrape_url
Claudebubblav_search_conversations
Claudebubblav_search_knowledge
Claudebubblav_sync_ticket_to_knowledge
Claudebubblav_toggle_custom_tool
Claudebubblav_update_custom_tool
Claudebubblav_update_flow
Claudebubblav_update_form
Claudebubblav_update_search_widget_config
Claudebubblav_update_sitemaps
Claudebubblav_update_website_settings
Claudebubblav_update_widget_appearance
Claudebubblav_upload_knowledge_file
Claude