BubblaV AI Chatbot

Permanently delete a Help Center article. This cannot be undone; consider status "draft" via bubblav_update_help_center_article to hide it instead. Use bubblav_get_help_center to get the article_id.

bubblav_delete_help_center_article

Permanently delete a Help Center group AND all articles inside it. This cannot be undone. To keep the articles, move them first with bubblav_update_help_center_article (group_id) or unpublish the group instead. Use bubblav_get_help_center to get the group_id.

bubblav_delete_help_center_group

Delete 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_delete_knowledge

Return 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_answerable_questions

Return visitor questions that the AI struggled to answer. A question qualifies when a bot reply has a low confidence score (<0.7), a visitor rated it thumbs-down, or Conversation QA judged that the chatbot lacked the information (Pro and higher). Each entry includes the question, how often it appeared, and the reasons (low_confidence, bad_rating, not_resolved). Use this to prioritise knowledge base improvements.

bubblav_get_content_gaps

Get 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_conversation

Check 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_crawl_status

Get a single flow with its full node/edge definition and webhook secret. Use bubblav_list_flows to get the flow_id.

bubblav_get_flow

Read the Help Center content of this website: all groups and articles, including drafts, in display order, with their ids. The Help Center is a tab in the chat widget where visitors browse groups (one folder level, no nesting) and articles and search them. Call this first to get the group_id / article_id values the other Help Center tools need. The tab itself is switched on with bubblav_update_widget_appearance (show_help_center_tab, help_center_tab_label).

bubblav_get_help_center

Get 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_hourly_activity

Return 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_most_asked_questions

Read 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_config

Get 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_search_widget_snippet

Read 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_website_settings

Read 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, chat disclaimer, product card button labels, branding toggle, logo/avatar URLs, avatar shape, widget language, and Home/Messages/Help Center tab labels. Use this before customizing the widget look.

bubblav_get_widget_appearance

Get 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_get_widget_snippet

List conversations for this website with optional filters. Returns conversation metadata (id, title, state, platform, visitor 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_conversations

List 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_crawl_urls

List 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_custom_tools

List flows (visual scenario-builder automations) for this website with their trigger type, active state, and run counts. Requires Pro plan or higher.

bubblav_list_flows

List 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_forms

List 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_knowledge_sources

Find 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_list_unanswered_questions

Read 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 in USD (estimated_cost_savings_currency; $8 per AI-resolved conversation), total leads, top countries (aggregate counts), most visited links, and a previous-period comparison. Rates are null when the period has no conversations. Defaults to the current calendar month. Pass date_range to query any period; a missing start means the first day of this month and a missing end means today. The start must not be in the future or after the end.

bubblav_read_report

Set the display order of Help Center groups, or of articles. kind "group": ids = all group ids in the new order. kind "article": ids = article ids in the new order (articles that share the same group, or all top-level ones). Get ids from bubblav_get_help_center.

bubblav_reorder_help_center

Full-text search across all conversation messages for this website. Returns matching message excerpts with surrounding context and conversation metadata. Use this to find patterns (e.g. "Find all conversations mentioning billing errors"), audit specific topics, or locate individual customer conversations.

bubblav_search_conversations

Search 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_search_knowledge

Sync 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_sync_ticket_to_knowledge

Enable 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_toggle_custom_tool

Update 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_custom_tool

Update an existing AI form. Only the fields you provide are changed. Use bubblav_list_forms to get the form_id.

bubblav_update_form

Update a Help Center article. Only the fields you provide change; the result is validated as a whole, so switching type needs the matching url or content_md. Change group_id to move it to another group (null = top level); it is appended at the end there. Set status to publish or unpublish. Use bubblav_get_help_center to get the article_id.

bubblav_update_help_center_article

Rename a Help Center group or publish/unpublish it. Only the fields you provide change. Use bubblav_get_help_center to get the group_id. Setting status "draft" hides the group and its articles from the widget.

bubblav_update_help_center_group

Update 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_search_widget_config

Set 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_sitemaps

Update 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." The new custom_instructions text replaces the stored text in full. Text over 5000 chars is rejected with an error and is never truncated.

bubblav_update_website_settings

Update 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. Use disclaimer_text for a longer notice (e.g. "AI can make mistakes. Not legal advice. Email ... to confirm") that stays visible under the message input in the chat and on the AI Page. widget_language sets the language of the built-in widget texts (buttons, form texts, timestamps, rating prompt); custom texts such as greeting_message stay as written. home_tab_label / messages_tab_label rename the footer tabs. Use file_upload_enabled to let visitors attach files (images, PDF, Word, text) to chat messages. show_help_center_tab toggles a third Help Center tab in the widget footer, where visitors browse the help articles; help_center_tab_label renames that tab. The Help Center content itself (groups, articles) is managed with the bubblav_*_help_center_* tools. Hiding "Powered by" branding requires a paid plan.

bubblav_update_widget_appearance

Upload 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, or reference a file attached in a BubblaV dashboard chat with attachment_id. Subject to plan page limits. Processing is asynchronous — use bubblav_get_crawl_status to track progress.

bubblav_upload_knowledge_file