Input:
{"body":{"maxTokens":2000,"messages":[{"content":"You are summarizing a text. The text is split into 1 parts, and you are currently working on part 1.\nAt every step, you will receive the current summary and a new part of the text. You need to amend the summary to include the new information (if needed).\nThe summary needs to cover the main points of the text and must be concise.\n\nIMPORTANT INSTRUCTIONS:\n- At each step, you will receive a part of the text to summarize. Make sure to reply with the new summary in the tags ■START■ and ■END■.\n- Summarize the text and make sure that the main points are included.\n- Ignore any unnecessary details and focus on the main points.\n- Use short and concise sentences to increase readability and information density.\n- When looking at the new information, focus on: Extract the Table of Contents for the Botpress Documentation. Start with a short sentence explaining what Botpress is. Pay special attention to all the different features. Focus on horizontal coverage of features rather than going in depth into one feature. The goal is to have a complete overview of what the documentation covers.\n- The current summary is empty. You need to generate a summary that covers the main points of the text.\n- This is the last part you will have to summarize. Make sure the summary is complete and covers all the main points.\n- The current summary is 0 tokens long. You need to make sure it is 2000 tokens or less.\n\nFORMAT OF THE SUMMARY:\nA normal text with multiple sentences and paragraphs. Use markdown to format the text into sections. Use headings, lists, and other markdown features to make the text more readable. Do not include links, images, or other non-text elements.","role":"system"},{"content":"■START■\n\n■END■\n\nPlease amend the summary between the ■START■ and ■END■ tags to accurately reflect the prompt and the additional text below.\n\n<|start_new_information|>\n**Botpress** is an open��source platform for building, deploying, and managing AI��powered chatbots.\n\n## Table of Contents (high��level overview)\n\n### 1. Getting Started\n- **Build** – author bots with Botpress Studio.  \n- **Deploy** – publish bots to the cloud or self��hosted servers.  \n- **Monitor** – track usage, performance and logs.\n\n### 2. Dashboard\n- **Workspace** – home, members, audits, integrations, usage, settings, profile.  \n- **Bot** – overview, integrations, webchat, logs, conversations, analytics, events, issues, configuration variables.\n\n### 3. Studio\n- **Interface** – nodes, home page, flow editor.  \n- **Knowledge Base** – tables, agents (summary, personality, policy, translator, knowledge, HITL, vision, analytics).  \n- **Development tools** – library, hooks, integrations, schemas, card hub, versions, chatbot settings, find, variables, card tray, debugger��/��logs��/��JSON, emulator, keyboard shortcuts, commands, preferences, import��/��export.\n\n### 4. Cards\n- Send messages, execute code, webchat UI, flow logic, AI utilities.\n\n### 5. Webchat\n- **Core features** – flow logic, AI (tasks, transitions, text generation), capture information, events, agents, utilities.  \n- **Versions** – v1 (deprecated) with styling & embedding options; v2 (embedded) with custom CSS, React components, and client SDK.\n\n### 6. Integrations\n- **Usage** – ready��made connectors for Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine��Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk.  \n- **Building** – guide to create custom integrations: getting started, adding messaging channels, actions��/��triggers, publishing on Botpress Hub.  \n- **Developer resources** – LLM interfaces, live��agent (HITL), CLI, SDK, key concepts (architecture, tags, channels, configuration, user, conversations, messages, events, states, actions, definitions, secrets, ZUI).  \n- **How��to** – states lifecycle, registration, integration actions/events, handlers, logging, custom integration development.\n\n### 7. Botpress APIs\n- **Files API** – manage files used by bots.  \n- **Chat API** – interact programmatically with conversations.\n\n### 8. Appendix\n- **Safety** – preventing abuse, brand safety framework.  \n- **Exporting Data** – raw conversations, conversation history, streaming analytics, compiled bot analytics.\n\n---\n\n*The documentation is organized to let developers quickly locate any topic—from initial setup, through the full Studio UI, to advanced integrations and API references—without diving deep into a single feature.*\n\n============\n\n**Botpress** is an open��source conversational AI platform that lets you design, deploy, and manage chat��bots with a visual studio, extensible integrations, and rich analytics.\n\n---  \n\n## ��� Documentation Overview  \n\n| Main Area | Key Topics |\n|-----------|------------|\n| **Getting Started** | Build, Deploy, Monitor |\n| **Dashboard** | Workspace (manage multiple bots, permissions, billing) → Home, Members, Audits, Integrations, Usage, Settings, Profile |\n| **Bot** | Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration variables |\n| **Studio** | Interface → Nodes, Home, Flows, Knowledge Base, Tables, Agents (Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics) → Library, Hooks, Integrations, Schemas, Card Hub, Versions, Chatbot Settings, Find, Variables, Card Tray, Debugger/Logs/JSON, Emulator, Keyboard Shortcuts, Commands, Preferences, Import/Export |\n| **Cards** | Send Messages, Execute, Webchat, Flow Logic, AI (Task, Transition, Generate Text) |\n| **Webchat** | • **Webchat v2** (Embedded Webchat, Custom CSS, React components, Webchat client)
• **Webchat v1 (deprecated)** – JavaScript control, styling (Button, Header, Input, Bot info), embedding (React app, React Native, iframe, full��screen) |\n| **Webchat Interaction Cards** | Configure Webchat, Send Custom Event, Get User Data, Hide/Show/Toggle Webchat |\n| **Integrations** | **Usage** – Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine��Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk
**Building** – Getting started, Adding messaging channel capabilities, Adding actions & triggers, Publishing on Botpress Hub, Custom LLM interfaces, Live��agent (HITL), Moving parts, CLI, SDK, Key concepts (Architecture, Tags, Channels, Configuration, User, Conversations, Messages, Event, States, Actions, Definitions, Secrets, ZUI) |\n| **Botpress APIs** | Files API, Chat API |\n| **Appendix** | Safety (Preventing Abuse, Brand Safety Framework), Exporting Data (Raw conversations, Conversation history, Streaming analytics, Compiled bot analytics) |\n| **Workspace (environment)** | Organize multiple bots, set permissions, track integrations, monitor analytics; billing unit for add��ons and plans |\n| **Webhook Guide** | Prerequisites, install integration, configure URL & secret, send data (Axios, Postman), use payload (`event.payload.body/query/method/path`), filters & expressions, notes on payload lifecycle |\n| **Embedding Guides** | Webflow (script insertion), WordPress (WPCode plugin, embed script), Webchat client quick��start (npm/yarn/pnpm install, obtain client ID, example code, API reference) |\n\n---  \n\n### Highlights  \n\n- **Studio** offers a full visual builder with agents, libraries, hooks, and a rich card system.  \n- **Webchat** provides both a modern embedded version (v2) and a legacy v1 with full UI customization.  \n- **Integrations** cover a wide ecosystem of SaaS tools and messaging channels; you can also build custom integrations via CLI/SDK.  \n- **API & Webhook** support real��time external updates and programmatic interaction with bots.  \n- **Safety & Export** sections ensure compliance and data portability.  \n\nThis table��of��contents style outline gives a complete, high��level view of everything the Botpress documentation covers.\n\n============\n\n**Botpress – Open��source Conversational AI Platform**\n\nBotpress provides a full��stack environment for building, deploying, and managing chatbots. The documentation is organized as a comprehensive Table of Contents covering every major area of the platform.\n\n---  \n\n### 1. Getting Started\n- **Build** – create a bot from scratch.  \n- **Deploy** – publish the bot to Botpress Cloud or self��hosted servers.  \n- **Monitor** – track bot health, usage metrics, and logs.\n\n### 2. Dashboard\n#### Workspace\n- Home, Members, Audits, Integrations, Usage, Settings, Profile.  \n\n#### Bot\n- Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration variables.\n\n### 3. Studio (Bot Design UI)\n- **Interface** – navigation panels and shortcuts.  \n- **Nodes & Flows** – visual flow editor.  \n- **Knowledge Base** – searchable docs.  \n- **Tables** – data storage for bots.  \n- **Agents** – built��in AI agents (Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics).  \n- **Library & Hooks** – reusable code snippets and lifecycle hooks.  \n- **Integrations** – connect external services.  \n- **Schemas & Card Hub** – data models and UI cards.  \n- **Versions** – version history, compare, revert.  \n- **Chatbot Settings** – global bot configuration.  \n- **Variables, Find, Debugger/Logs/JSON, Emulator** – runtime inspection tools.  \n- **Keyboard Shortcuts, Commands, Preferences** – productivity options.  \n- **Import & Export** – backup and move bots.\n\n### 4. Cards (Reusable Flow Elements)\n- Send Messages, Execute code, Webchat UI, Flow Logic, AI actions.\n\n### 5. Webchat (Embedding Widget)\n- **Flow Logic** – decide conversation paths.  \n- **AI** – tasks, transitions, text generation.  \n- **Capture Information** – forms & user data.  \n- **Events & Agents** – trigger��based actions.  \n- **Utilities** – helper functions.  \n- **Versions** – Webchat��v1 (deprecated) and Webchat��v2 (modern embed).  \n- **Customization** – script parameters, CSS, React components, domain whitelisting.\n\n### 6. Integrations\n- **Usage** – ready��made connectors: Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft��Teams, Notion, Slack, Sunshine��Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk.  \n- **Building** – SDK, CLI, key concepts (architecture, tags, channels, configuration, users, conversations, messages, events, states, actions, definitions, secrets, ZUI), custom integration workflow, publishing to Botpress��Hub.\n\n### 7. Botpress APIs\n- **Files API** – manage assets.  \n- **Chat API** – programmatic conversation handling.\n\n### 8. Appendix\n- **Safety** – abuse prevention, brand��safety framework.  \n- **Exporting Data** – raw conversations, history, streaming analytics, compiled bot analytics.\n\n### 9. Usage & Limits\n- AI spend (token��based billing, free credit, limits), file storage, table rows, vector DB storage, incoming messages/events, collaborators, bot count, “Always��Alive” instances.\n\n### 10. Profile & Settings\n- Update profile (photo, name, password), link/unlink social accounts, generate personal access tokens.\n\n### 11. Versions (Bot History)\n- Access, create (manual or on publish), revert to prior versions, plan��based version caps.\n\n---  \n\n**Overall**, the Botpress documentation provides a *horizontal* overview of all platform features—from core bot building, through studio design tools, integration ecosystem, deployment options, to monitoring, security, and API access—allowing developers to quickly locate the relevant guide for any task.\n\n============\n\n**Botpress Overview**  \nBotpress is an open��source platform for building, deploying, and managing conversational AI bots. Its documentation provides a complete, horizontally��organized overview of all major features.\n\n---\n\n### 1. Getting Started  \n- **Build, Deploy, Monitor** – Core workflow to create bots, launch them on Botpress Cloud, and track performance.  \n\n### 2. Dashboard  \n- **Workspace** – Home, members, audits, integrations, usage, settings, profile.  \n- **Bot** – Overview, integrations, webchat, logs, conversations, analytics, events, issues, configuration variables.  \n\n### 3. Studio (Bot Designer)  \n- **Interface** – Nodes, flows, home, knowledge base, tables, agents (summary, personality, policy, translator, knowledge, HITL, vision, analytics).  \n- **Library & Hooks** – Reusable assets and lifecycle extensions.  \n- **Integrations & Schemas** – Connect external services, define data structures.  \n- **Card Hub & Versions** – Manage reusable cards, version control.  \n- **Chatbot Settings** – Global bot configuration.  \n- **Utilities** – Find, variables, debugger, emulator, keyboard shortcuts, commands, preferences, import/export.  \n\n### 4. Webchat  \n- **Webchat v1 (deprecated)** – Styling (chatbot button, header, user input, bot info), embedding (React app, React Native, iframe, full��screen).  \n- **Webchat v2** – Embedded webchat with custom CSS, React components, webchat client.  \n\n### 5. Integrations  \n- **Messaging Channels** – Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk.  \n- **Building Integrations** – Getting started, adding messaging capabilities, actions & triggers, publishing on Botpress Hub, custom LLMs, live��agent connections, CLI, SDK, key concepts (architecture, tags, channels, configuration, user, conversations, messages, events, states, actions, definitions, secrets, ZUI).  \n\n### 6. Variables  \n- **Scopes** – Workflow, User, Bot, Session, Configuration (secure).  \n- **Data Types** – String, Boolean, Number, Date (ISO��8601), Object, Array, Enum, Pattern.  \n- **Creation & Usage** – UI steps for each scope; access via `{{scope.variable}}` or `@scope.variable`.  \n- **Workflow Variables** – Local to a workflow; can be marked as inputs/outputs for inter��workflow passing.  \n- **User & Bot Variables** – Persistent per��user or global across all users; Bot variables not for secrets.  \n- **Session Variables** – Live��conversation only, created in Execute Code cards.  \n- **Configuration Variables** – Secure, managed via cloud dashboard; accessed with `env.key`.  \n- **Passing Variables** – Define inputs on target workflow, map outputs on calling workflow.  \n\n### 7. Tables (Local NoSQL Store)  \n- **Limits** – Up to��10 tables, 20 columns each, 10��000 rows (free plan).  \n- **Field Types** – String, Number, Boolean, Date, Object; searchable option for strings.  \n- **Filters & Rules** – Logical (AND/OR) and primitive operators (`$eq`, `$gt`, `$regex`, etc.) with nested groups.  \n- **CRUD Operations** – Add, update, delete records via UI, table cards, or Botpress Client API.  \n- **Client API Functions** – `listTables`, `createTableRows`, `findTableRows`, `updateTableRows`, `deleteTableRows`, `upsertTableRows`, `createTable`, `updateTable`, `renameTableColumn`, `getTable`, `deleteTable`.  \n- **AI��Generated Filters** – Write natural��language queries prefixed by `AI\\`` to auto��convert to filter objects.  \n\n### 8. Botpress APIs  \n- **Files API** – Manage file assets.  \n- **Chat API** – Programmatic interaction with bot conversations.  \n\n### 9. Appendix  \n- **Safety** – Preventing abuse, brand safety framework.  \n- **Exporting Data** – Raw conversations, conversation history, streaming analytics (hooks), compiled bot analytics.  \n\n---\n\n**Key Takeaway** – The Botpress documentation is organized to let developers quickly locate information on every major component: from the visual Studio editor, through webchat embedding options, variable management, and table storage, to integrations, APIs, and operational safety. This horizontal coverage ensures a full overview without needing deep dives into any single feature.\n\n============\n\n**Botpress** is an open��source low��code platform for building, deploying��and��managing conversational AI bots.\n\n---\n\n## ��� Documentation Overview (Table of Contents)\n\n### 1������ Getting Started\n- **Build**, **Deploy**, **Monitor** – core lifecycle steps.\n\n### 2������ Dashboard\n- Workspace overview, members, audits, usage, settings, profile.\n\n### 3������ Bot\n- Overview, integrations, webchat, logs, conversations, analytics, events, issues, configuration variables.\n\n### 4������ Studio��(central authoring UI)\n| Area | Key Features |\n|------|--------------|\n| **Interface** | Nodes, flows, knowledge base, tables, agents, library, hooks, integrations, schemas, card hub, versions, chatbot settings. |\n| **Flows** | Main, Error, Timeout, Conversation��End; flow management (add workflow, folder, knowledge base, table). |\n| **Tables** | • Create table��• Field types (searchable, computed)��• Filtering (rules, groups, logical operators)��• Operations via UI, cards, Botpress client, code (create/update/delete/upsert)��• **`upsertRecords`** – insert��or��update rows in one call��• Computed columns (AI��prompt or custom JS code, auto��compute toggle)��• Import/Export CSV��• Preferences (Snap��to��grid, theme). |\n| **Agents** | Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics. |\n| **Hooks** | Custom JS execution, streaming analytics (e.g., Mixpanel via hooks). |\n| **Preferences** | Workflow snap��to��grid (enable/disable), studio theme (system, light, dark). |\n| **Debugging** | Debugger, logs, JSON viewer, emulator, keyboard shortcuts, commands. |\n\n### 5������ Integrations (messaging & services)\n- **Core channels**: Slack, Trello, WhatsApp, Telegram, Messenger, Line, Microsoft��Teams, etc.  \n- **Common setup steps**: prerequisites, API keys/tokens, webhook URLs, enable toggle, save configuration.  \n- **Slack** – app creation, token & signing secret, event & interactivity webhooks, actions (start DM, retrieve message, add reaction, sync members, get profile).  \n- **Trello** – API key & token, board/list IDs, card operations (create, update, add comment), member retrieval.  \n- **Other integrations** – Asana, Instagram, Intercom, Zoom, Zapier, etc. (listed in docs).  \n- **Building your own** – CLI, SDK, key concepts (architecture, tags, channels, states, actions, secrets, ZUI).\n\n### 6������ Webchat\n- **v2 (embedded)** – embed script, custom CSS, React components, client API.  \n- **v1 (deprecated)** – JavaScript control, styling, embedding options (iframe, full��screen, React��Native).  \n\n### 7������ Botpress APIs\n- **Files API** – upload/download assets.  \n- **Chat API** – send/receive messages programmatically.\n\n### 8������ Appendix\n- **Safety** – abuse prevention, brand safety framework.  \n- **Exporting Data** – raw conversations, history, streaming analytics (hooks), compiled analytics.\n\n---\n\n## ��� Highlights from the New Content\n\n- **`upsertRecords`** – single��call update��or��create for table rows (example shown).  \n- **Computed Columns** – mark columns as *Computed*; select dependencies; AI��based (template prompts) or code��based (JS with `row.propertyName`, async support, 2��min timeout); enable *Auto��compute* to keep values fresh.  \n- **Import/Export Tables** – CSV import auto��detects columns; export button downloads CSV; tables travel with bot exports.  \n- **Studio Preferences** – *Snap��to��grid* aligns nodes; can be toggled; *Studio Theme* switches between system, light, dark.  \n- **Streaming Analytics** – use **Hooks** (e.g., Mixpanel) to push inbound/outbound message events via HTTP POST.  \n- **Trello Integration** – prerequisites (account, list ID, Botpress Cloud); setup (API key, token, enable); card actions (create, update, comment); member queries.  \n- **Slack Integration** – create Slack app, configure token & signing secret, set event & interactivity webhooks, then use Studio cards for proactive DM, retrieve messages, add reactions, sync members, get profiles.  \n\n---\n\n*This summary provides a high��level map of the Botpress documentation, covering all major sections and features without diving into implementation details.*\n\n============\n\n**Botpress** – an open��source, low��code platform for building, deploying, and managing AI��powered chatbots and conversational applications.\n\n---\n\n## Table of Contents (Documentation Overview)\n\n### 1������ Getting Started  \n- **Build** – author bots with the visual Studio UI.  \n- **Deploy** – publish bots to Botpress Cloud or self��hosted runtimes.  \n- **Monitor** – track usage, performance, and health.\n\n### 2������ Dashboard (Workspace)  \n- **Home, Members, Audits** – team and security management.  \n- **Your integrations, Usage, Settings, Profile** – central hub for bot configuration and monitoring.\n\n### 3������ Bot  \n- **Overview** – high��level bot info.  \n- **Integrations** – connect messaging channels.  \n- **Webchat** – embed the Botpress chat widget.  \n- **Logs, Conversations, Analytics, Events, Issues** – full observability.  \n- **Configuration variables** – environment��level settings.\n\n### 4������ Studio (Development UI)  \n- **Interface** – Nodes, Home, Flows, Knowledge Base, Tables.  \n- **Agents** – Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics.  \n- **Library & Hooks** – reusable assets and lifecycle extensions.  \n- **Integrations, Schemas, Card Hub, Versions** – extendability and version control.  \n- **Chatbot Settings, Find, Variables, Card Tray** – fine��tune bot behavior.  \n- **Debugger, Emulator, Keyboard Shortcuts, Commands, Preferences, Import/Export** – developer tooling.\n\n### 5������ Cards (Building Blocks)  \n- **Send Messages**, **Execute**, **Webchat**, **Flow Logic**.  \n- **AI** – Task, Transition, Generate Text.  \n- **Capture Information**, **Events**, **Agents**, **Utilities**.\n\n### 6������ Webchat  \n- **Webchat��v2 (Embedded)** – Embedded Webchat, Custom CSS, React components, Webchat client.  \n- **Webchat��v1 (deprecated)** – JavaScript control, styling (bot button, header, input area, bot info), embedding options (React app, React Native, iframe, full��screen).\n\n### 7������ Integrations  \n\n#### • Usage (pre��built channel connectors)  \n- Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk.  \n\n#### • Building (custom integration guide)  \n- Getting started, adding messaging capabilities, actions��&��triggers, publishing on Botpress Hub.  \n- **LLM interfaces** – use your own large language models.  \n- **Live��agent (HITL) integration**.  \n- **Moving parts, CLI, SDK**.  \n- **Key Concepts** – Architecture, Tags, Channels, Configuration, User, Conversations, Messages, Events, States, Actions, Definitions, Secrets, ZUI (beta).  \n- **How��to** – States lifecycle, register/unregister, integration actions & events, handlers, logging, building a custom integration.\n\n### 8������ Botpress APIs  \n- **Files API** – manage assets.  \n- **Chat API** – programmatic conversation handling.\n\n### 9������ Appendix  \n\n#### • Safety  \n- **Preventing Abuse** – rate limits, Web Application Firewall (WAF), billing limits.  \n- **Brand Safety Framework**.  \n\n#### • Exporting Data  \n- Raw conversations, conversation history, streaming analytics (hooks), compiled bot analytics.\n\n---\n\n### Highlighted Feature Sets  \n\n- **AI & Flow Logic** – design conversational flows with built��in AI tasks, transitions, and text generation.  \n- **Agents** – ready��to��use specialized agents (summary, personality, policy, translation, vision, analytics, etc.).  \n- **Webchat Customization** – full control over UI, CSS, and React integration.  \n- **Extensible Integrations** – over 20 pre��made channel connectors plus a complete SDK for custom channels.  \n- **Robust Observability** – logs, analytics, events, and safety controls to monitor and protect bots.  \n\nThis outline captures the breadth of the Botpress documentation, providing a quick reference to every major topic and feature covered.\n\n============\n\n**Botpress** is an open��source platform for building, deploying, and managing AI��powered chatbots and conversational assistants.\n\n---\n\n## Table of Contents (high��level)\n\n### 1. Getting Started  \n- **Build** – Create a bot, add flows, define actions.  \n- **Deploy** – Publish to cloud or on��premise.  \n- **Monitor** – Track usage, logs, and performance.\n\n### 2. Dashboard  \n- **Workspace** – Members, audits, integrations, usage, settings.  \n- **Bot** – Overview, integrations, webchat, logs, conversations, analytics, events, issues, configuration variables.\n\n### 3. Studio  \n- **Interface** – Visual editor for nodes, flows, and knowledge base.  \n- **Nodes** – Standard, autonomous, start, entry, exit, end.  \n- **Agents** – Summary, personality, policy, translator, knowledge, HITL, vision, analytics.  \n- **Library / Hooks / Schemas / Card Hub / Versions** – Reusable assets and version control.  \n- **Utilities** – Debugger, emulator, keyboard shortcuts, commands, preferences, import/export.\n\n### 4. Cards  \n- Send messages, execute actions, webchat components, flow logic, AI (tasks, transitions, text generation).\n\n### 5. Webchat (UI)  \n- **Core components** – `WebchatProvider`, `FAB`, `WebChat`, `Header`, `MessageList`, `Composer` (input, button, upload).  \n- **Features** – Full chat container, customizable header, message list, composer with input & send button.  \n- **Versions**  \n  - *v1 (deprecated)* – JavaScript control, styling (chatbot button, header, input area), embedding (React, iframe, full��screen).  \n  - *v2* – Embedded webchat with custom CSS, React components, webchat client.\n\n### 6. Integrations  \n- **Usage** – Connect to Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp, Zapier, Zendesk.  \n- **Building** – Get started, add messaging channels, actions & triggers, publish on Botpress Hub, use custom LLMs, connect live agents, CLI, SDK, key concepts (architecture, tags, channels, config, user, conversations, messages, events, states, actions, definitions, secrets, ZUI).\n\n### 7. SDK & Development  \n- **Installation** – `npm i @botpress/sdk` (or yarn/pnpm).  \n- **Bot development** – Define a `Bot` class, register message, event, and state��expired handlers.  \n- **Integration development** – Create `IntegrationDefinition` and `Integration` classes; define name, version, public flag, configuration schema, actions, events, channels, states, and handlers.\n\n### 8. APIs  \n- **Files API** – Manage bot��related files.  \n- **Chat API** – Interact programmatically with conversations and messages.\n\n### 9. Appendix  \n- **Safety** – Preventing abuse, brand��safety framework.  \n- **Exporting Data** – Raw conversations, conversation history, streaming analytics, compiled bot analytics.\n\n---\n\n## Component References (quick view)\n\n| Component | Purpose |\n|-----------|---------|\n| **`WebchatProvider`** | Supplies the Botpress client and theme to all webchat components. |\n| **`FAB`** | Floating Action Button that toggles the webchat visibility. |\n| **`WebChat`** | Main container rendering header, message list, and composer. |\n| **`Header`** | Shows bot name, refresh/close controls. |\n| **`MessageList`** | Displays the conversation flow. |\n| **`Composer`** | Holds the text input (`ComposerInput`) and send button (`ComposerButton`). |\n\n---\n\n## Notion Integration (example)\n\n- **Prerequisites** – Notion account & workspace, Botpress Cloud account.  \n- **Setup** – Install Notion integration from the Integration Hub, add webhook URL and auth token (internal integration secret).  \n- **Capabilities** – Add comments to discussions or pages, retrieve databases, add pages to a database, delete blocks (all via cards).  \n- **Usage** – Cards expose actions like “Add Comment to a Discussion”, “Get a Database”, “Add Page to a Database”, etc., requiring IDs extracted from Notion URLs.\n\n---\n\n*This summary provides a horizontal overview of Botpress documentation, covering the main sections, UI components, SDK workflow, integration ecosystem, APIs, and safety/export features.*\n\n============\n\n**Botpress** is an open��source platform for building, deploying, and managing AI��driven chatbots and virtual agents.\n\n# Documentation Table of Contents\n\n## 1. Getting Started\n- **Build** – creating a bot  \n- **Deploy** – publishing the bot  \n- **Monitor** – observing performance  \n\n## 2. Dashboard\n- **Workspace** – Home, Members, Audits, Integrations, Usage, Settings, Profile\n- **Bot** – Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration variables  \n\n## 3. Studio  \n### Interface  \n- Nodes, Home, Flows, Knowledge Base, Tables  \n### Agents (AI��powered)  \n- Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics  \n### Core Tools  \n- Library, Hooks, Integrations, Schemas, Card Hub, Versions, Chatbot Settings, Find, Variables, Card Tray, Debugger��/��Logs��/��JSON, Emulator, Keyboard Shortcuts, Commands, Studio Preferences, Import��/��Export  \n\n## 4. Cards  \n- Send Messages, Execute, Webchat, Flow Logic, AI (Task, Transition, Generate Text)  \n\n## 5. Webchat  \n- **Webchat v1 (deprecated)** – JavaScript control, styling (Bot Button, Header, Input, Bot Info), embedding (React App, React Native, Iframe, Full��screen)  \n- **Webchat v2** – Embedded Webchat, Custom CSS, React Components, Webchat Client  \n\n## 6. Integrations  \n### Usage (pre��built connectors)  \n- Asana, HITL, Instagram, Intercom, **Line**, **Messenger**, **Microsoft��Teams**, Notion, Slack, Sunshine��Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, **WhatsApp** (manual config), Zapier, Zendesk  \n\n### Building your own  \n- Getting Started, Adding Messaging Channels, Adding Actions��/��Triggers, Publishing on Botpress��Hub, Using custom LLMs, Connecting live��agent platforms, Moving Parts, CLI, SDK, Key Concepts (Architecture, Tags, Channels, Configuration, Users, Conversations, Messages, Events, States, Actions, Definitions, Secrets, ZUI��–��Zod UI components)  \n\n## 7. Botpress APIs\n- **Files API** – managing files  \n- **Chat API** – interacting with bots programmatically  \n\n## 8. Appendix  \n### Safety  \n- Policy Agent (behavior guardrails)  \n- Access Control & Permissions  \n- Data Privacy & Security (encryption, anonymization)  \n- Monitoring & Analytics  \n- Error Mitigation & Recovery  \n- Preventing Abuse, Brand Safety Framework  \n\n### Exporting Data  \n- Raw Conversations (API)  \n- Conversation History (within bot)  \n- Streaming Analytics (hooks)  \n- Compiled Bot Analytics (API)  \n\n## 9. Schemas  \n- JSON Schema basics (types, required fields, enums, nested structures)  \n- Creating & using schemas for variables, AI tasks, conditional inputs (discriminated unions)  \n- Testing schemas and integrating them into workflows  \n\n---  \n\n*This outline captures the full breadth of Botpress documentation, providing a quick��reference map of all major sections and features.*\n\n============\n\n**Botpress** is an open��source, low��code platform for building, deploying and managing AI��powered chatbots and conversational agents.\n\n---  \n\n### ��� Table of Contents (high��level)\n\n#### 1. Home & Getting Started  \n- **Home** – entry point to the docs.  \n- **Build** – creating a bot.  \n- **Deploy** – publishing & scaling.  \n- **Monitor** – observing bot performance.\n\n#### 2. Dashboard  \n- **Workspace** – Home, Members, Audits, Integrations, Usage, Settings, Profile.  \n- **Bot** – Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration variables.\n\n#### 3. Studio (the visual editor)  \n- **Interface** – Nodes, Home, Flows.  \n- **Knowledge Base** – creating and managing KBs.  \n- **Tables** – tabular data sources.  \n- **Agents** – Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics.  \n- **Library, Hooks, Schemas, Card��Hub, Versions, Settings, Find, Variables, Card��Tray**.  \n- **Debugger / Logs / JSON**, **Emulator**, **Keyboard shortcuts**, **Commands**, **Preferences**, **Import��&��Export**.\n\n#### 4. Cards (building��block actions)  \n- **Send Messages**, **Execute**, **Webchat**, **Flow Logic**, **AI** (tasks, transitions, generate��text).\n\n#### 5. Webchat  \n- **Webchat** – core component.  \n- **Webflow / Wix / WordPress** integrations.  \n- **Webchat��v1 (deprecated)** – JavaScript control, styling (button, header, input area, bot info), embedding (React app, React��Native, iframe, full��screen).  \n- **Webchat��v2** – Embedded Webchat (custom CSS), React components, Webchat client.\n\n#### 6. Integrations  \n- **Usage** – ready��to��use connectors: Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft��Teams, Notion, Slack, Sunshine��Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk.  \n- **Building** – creating custom integrations:  \n  - Getting started → Messaging channel capabilities → Actions��&��triggers → Publishing on Botpress Hub.  \n  - **Use Your Own LLM** (LLM Interfaces).  \n  - **Connect Live Agent** (HITL).  \n  - **Moving Parts** (overview of the developer experience).  \n  - **CLI**, **SDK**.  \n  - **Key Concepts** – Architecture, Tags, Channels, Configuration, User, Conversations, Messages, Event, States, Actions, Definitions, Secrets, ZUI (beta).  \n  ��- **How��to** – States, Register��&��Unregister, Integration actions/events, Handler, Logging, Building a custom integration.\n\n#### 7. Botpress APIs  \n- **Files API** – file storage & retrieval.  \n- **Chat API** – programmatic chat interactions.\n\n#### 8. Appendix  \n- **Safety** – Preventing abuse, Brand safety framework.  \n- **Exporting Data** – Raw conversations, conversation history, streaming analytics, compiled bot analytics.\n\n#### 9. Knowledge Base (centralized knowledge store)  \n- **Enabling the Knowledge Agent**.  \n- **Creating a Knowledge Base** – folders, description.  \n- **Knowledge Sources**:  \n  - **Documents** – PDF, HTML, TXT, DOC/DOCX (�����100 docs,�������50��MB each).  \n  - **Website** – add URLs or site��map.  \n  - **Search the Web** – include/exclude sites, time��filter (24��h,��7��d,��30��d).  \n  - **Text Document** – plain��text FAQs, guides.  \n  - **Tables** – searchable columns, optional manual answer mode.  \n- **Storage quota** –��5000 vectors (~200��articles or��1000��PDF pages).  \n- **Enabling/Disabling KB on Capture��Info cards**, **scoping by folders**, **handling “no answer”**, **debugging (logs, emulator)**.\n\n#### 10. Monitor (runtime insights)  \n- **Event debugger**, **Usage**, **Logs**, **Conversations**, **Analytics**, **Events**, **Issues**.\n\n#### 11. Use Your Own LLM  \n- Why bring your own model (domain expertise, control, privacy, cost, integration).  \n- Access procedure (request, validation).  \n- Steps: create & configure integration → implement `generateContent` & `listModels` actions → select LLM in Studio.\n\n#### 12. Moving Parts (developer experience)  \n- **Studio** – low��code flow builder.  \n- **Developer side** – public HTTP API, TypeScript HTTP client, SDK, CLI.  \n- Guidance on creating bots/integrations via API, using the SDK, and deploying with the CLI.\n\n#### 13. Library (shared assets) – (listed under Studio).\n\n---  \n\n**In summary**, the Botpress documentation covers everything from getting started, through the full UI of the Dashboard and Studio, to deep technical topics such as custom integrations, LLM support, APIs, Knowledge Base management, monitoring tools, safety guidelines, and data export. This provides a complete horizontal view of all features a developer or bot creator might need.\n\n============\n\n**Botpress – Overview**  \nBotpress is an open��source platform for building, deploying, and managing conversational AI agents (chatbots). Its documentation is organized as a comprehensive table of contents that covers everything from installation to advanced features.\n\n---\n\n## 1������ Getting Started\n- **Build** – Create a bot, define flows, add NLU (intents & entities).  \n- **Deploy** – Publish to cloud or on��premise, configure environment variables.  \n- **Monitor** – View logs, analytics, and health metrics.\n\n## 2������ Dashboard (Admin UI)\n- **Workspace** – Home, members, audits, integrations, usage, settings, profile.  \n- **Bot** – Overview, integrations, webchat, logs, conversations, analytics, events, issues, configuration variables.\n\n## 3������ Studio (Core Development Environment)\n| Area | Key Items |\n|------|-----------|\n| **Interface** | Nodes, home, flow editor, knowledge base, tables. |\n| **Agents** | Summary, personality, policy, translator, knowledge, HITL, vision, analytics. |\n| **Library** | Global intents & entities (NLU). |\n| **Hooks** | Server��side code triggered on events. |\n| **Integrations** | Connect to external services (Slack, WhatsApp, etc.). |\n| **Schemas & Card Hub** | Data models, reusable UI cards. |\n| **Versions & Settings** | Bot versions, chatbot settings, variables, find/search. |\n| **Debugger & Emulator** | Live testing, logs, JSON view. |\n| **Keyboard Shortcuts & Commands** | Fast navigation (Ctrl��+��B, Ctrl��+��E, etc.). |\n| **Import��&��Export** | `.bpz` archive for sharing or backup. |\n\n## 4������ Cards (Reusable Building Blocks)\n- **Send Messages** – Text, image, carousel, etc.  \n- **Execute** – Run custom code.  \n- **Webchat** – Embed chat UI.  \n- **Flow Logic** – Conditional branches, loops.  \n- **AI** – AI tasks, transitions, text generation.\n\n## 5������ Webchat (Chat UI)\n- **Webchat v2 (Embedded)** – Custom CSS, React components, webchat client.  \n- **Webchat v1 (Deprecated)** – JavaScript control, styling (button, header, input area, bot info), embedding options (React app, React Native, iframe, full��screen).  \n- **Platform��specific** – Webflow, Wix, WordPress integrations.\n\n## 6������ Integrations (Connectors)\n- **Usage** – Search, install, configure, and use integrations.  \n- **Supported Services** (partial list): Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (with manual config), Zapier, Zendesk.  \n- **Building Custom Integrations** – CLI, SDK, key concepts (architecture, tags, channels, configuration, user, conversations, messages, events, states, actions, definitions, secrets, ZUI).  \n- **Integration Lifecycle** – Install → provide API keys → configure → deploy → use via cards or channel messaging.\n\n## 7������ Botpress APIs\n- **Files API** – Manage bot assets.  \n- **Chat API** – Interact programmatically with conversations.\n\n## 8������ NLU Library (Core of Bot Understanding)\n- **Intents** – Define purpose of user messages; each intent holds many utterances.  \n- **Entities** – Extract parameters (date, size, product code, etc.).  \n- **Custom Entities** – Pattern (regex) or list types, usable across the bot.  \n- **Inline Intents** – Context��specific intents defined directly on flow transitions.\n\n## 9������ Appendix\n- **Safety** – Prevent abuse, brand��safety framework.  \n- **Exporting Data** – Raw conversations, conversation history, streaming analytics, compiled bot analytics (via APIs).  \n\n## ��� Issues & Debugging\n- **Issues Tab** – Lists persistent errors (e.g., execute��code failures).  \n- **Logs & Events** – Complementary views for troubleshooting.  \n\n## ��� Import & Export (Bot Packages)\n- **Export** – Generates a `.bpz` archive containing bot config, agents, knowledge bases, tables, intents, entities, hooks, variables, cards, etc.  \n- **Import** – Restores a bot from a `.bpz` file (overwrites existing bot).  \n- **Limits** – Export up to ~3��GB; import up to 120��MB.  \n- **Post��import** – Re��configure integrations.\n\n## ������ Keyboard Shortcuts (Studio & Admin)\n- **Studio** – Node copy/paste, panel toggles, emulator controls, session creation.  \n- **Admin Dashboard** – Quick bot/workspace access (`Ctrl��+��K`).  \n- **Tables** – Cell navigation, edit, exit.  \n\n---\n\n### How the Documentation Is Structured\nAll sections are linked through a master **Table of Contents** which mirrors the hierarchy above, allowing users to jump directly to any topic (e.g., “Intents → Creating an Intent”, “Webchat → Embedded Webchat → Custom CSS”, “Integrations → Intercom → Setup”). The layout ensures a **horizontal coverage** of Botpress capabilities without diving deep into any single feature, giving a complete overview of what the documentation covers.\n\n============\n\n**Botpress – Overview**  \nBotpress is an open��source platform for creating, deploying, and managing AI��powered chatbots. Its documentation is organized as a comprehensive table of contents that spans integrations, development tools, runtime features, and operational guidance.\n\n---  \n\n## ��� Table of Contents (High��Level)\n\n### 1. Getting Started  \n- **Build**, **Deploy**, **Monitor** – core workflow for new bots.  \n\n### 2. Dashboard & Workspace  \n- Workspace�������Home, Members, Audits, Your integrations, Usage, Settings, Profile.  \n- Bot�������Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration variables.  \n\n### 3. Studio (Bot Design)  \n- Interface�������Nodes, Home, Flows, Knowledge Base, Tables, Agents (Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics).  \n- Library, Hooks, Integrations, Schemas, Card Hub, Versions, Chatbot Settings, Find, Variables, Card Tray, Debugger��&��Logs, Emulator, Keyboard shortcuts, Commands, Preferences, Import��&��Export.  \n\n### 4. Integrations  \n\n#### 4.1 Usage (Pre��built connectors)  \n- **Messaging / Channels**: Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft��Teams, Notion, Slack, Sunshine��Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk.  \n\n#### 4.2 Building Integrations  \n- **Getting Started** – install, add messaging capabilities, add actions & triggers, publish on Botpress��Hub.  \n- **Custom LLM Interfaces** – connect your own language model.  \n- **Human��In��The��Loop (HITL)** – integrate live��agent platforms.  \n- **Moving Parts** – architecture overview.  \n- **CLI** – command��line utilities.  \n- **SDK** – development kit for new integrations.  \n- **Key Concepts** – Architecture, Tags, Channels, Configuration, User, Conversations, Messages, Events, States, Actions, Definitions, Secrets, ZUI (beta).  \n- **How��to** – States management, Register��&��Unregister, Integration actions/events, Handlers, Logging, Building a custom integration.  \n\n### 5. Key Concepts (Core data model)  \n| Concept | Purpose |\n|--------|---------|\n| **Tags** | Identify users, conversations, messages across external systems. |\n| **Channels** | Define supported communication mediums (e.g., Slack, WhatsApp). |\n| **Configuration** | Store sensitive settings (API keys, tokens). |\n| **User** | Mapping between external identities and Botpress users. |\n| **Conversation** | Bridge external conversation IDs with Botpress IDs. |\n| **Messages** | Payloads exchanged; contain routing & content data. |\n| **States** | Persist data per user, conversation, or globally. |\n| **Actions** | Operations the integration can perform (send message, add reaction, etc.). |\n| **Events** | Non��conversational triggers (e.g., new issue, chat opened). |\n| **Definition** | Blueprint of an integration (class��`IntegrationDefinition`). |\n| **Secrets** | Secure storage for credentials. |\n| **ZUI** | Beta UI components for Zod schema editing. |\n\n### 6. Webchat  \n\n#### 6.1 Webchat (Current) – v2  \n- **Embedded Webchat** – CSS reference, React components, Webchat client.  \n\n#### 6.2 Webchat v1 (Deprecated)  \n- Controlling via JavaScript, styling (Chatbot button, header, input area, bot info).  \n- Embedding options: React app, React��Native, iframe, full��screen chatbot.  \n\n### 7. Botpress APIs  \n- **Files API** – manage bot assets.  \n- **Chat API** – programmatic interaction with bots.  \n\n### 8. Appendix  \n\n#### 8.1 Safety  \n- Preventing abuse, Brand Safety Framework.  \n\n#### 8.2 Exporting Data  \n- Raw conversations, conversation history, streaming analytics, compiled bot analytics.  \n\n---  \n\n## ��� Sample Feature Highlights  \n\n### Instagram Integration (Setup)  \n1. Create a Meta app & Facebook page.  \n2. Add Messenger product, set API version�������15.0.  \n3. Fill Botpress channel config (App��ID/Secret, Page��ID, Access��Token, Verify Token, Webhook URL).  \n4. Configure webhook in Meta app and subscribe to `instagram_manage_messages`, `messages`, `messaging_postbacks`.  \n\n### Human��In��The��Loop (HITL) Flow  \n- **Tags** map Botpress users ����live��agent platform users and conversations ����tickets.  \n- **Integration definition** extends `interfaces.hitl`, adds a `hitl` channel, and custom tags.  \n- **Lifecycle methods**: `register` (set webhook), `unregister` (remove webhook).  \n- **Actions**: `createUser`, `startHitl`, `stopHitl`.  \n- **Message handling**: user → agent (via `hitl` channel `text` handler) and agent → user (via webhook `handler`).  \n- **Events**: `hitlAssigned`, `hitlStopped` emitted to inform the bot of escalation status.  \n\n---  \n\n### ��� Quick Reference  \n\n- **Integrations menu** – manage installed connectors; all configuration now lives in Studio.  \n- **SDK** – start with the Slack integration example to learn the integration class pattern.  \n- **Hooks** – customizable points (after incoming, before incoming, before outgoing) for logging, NLU tweaks, or external calls.  \n\n---  \n\n**Bottom line:** The Botpress documentation is structured to give you a complete, horizontally��spanning view of every major capability—from core concepts and UI (Studio, Webchat) to integrations, custom development (SDK, CLI, Hooks), APIs, and operational topics (Safety, Data export). Use the table of contents as a roadmap to dive into any area without getting lost in depth��first details.\n\n============\n\n**Botpress**��is an open��source platform for building, deploying, and managing conversational AI bots.  \n\n---  \n\n## ��� Documentation Overview  \n\n### 1������ Getting Started  \n- **Build** – Create bots; **Deploy** – Publish to channels; **Monitor** – Observe performance.  \n\n### 2������ Dashboard (Workspace)  \n- **Home**, **Members**, **Audits**, **Integrations**, **Usage**, **Settings**, **Profile**.  \n\n### 3������ Bot (Core features)  \n- **Overview**, **Integrations**, **Webchat**, **Logs**, **Conversations**, **Analytics**, **Events**, **Issues**, **Configuration variables**.  \n\n### 4������ Studio (Design & Logic)  \n- **Interface** – Nodes, Home, Flows, Knowledge Base, Tables.  \n- **Agents** – Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics.  \n- **Library**, **Hooks**, **Integrations**, **Schemas**, **Card��Hub**, **Versions**, **Chatbot Settings**, **Find**, **Variables**, **Card��Tray**, **Debugger/Logs/JSON**, **Emulator**, **Keyboard shortcuts**, **Commands**, **Studio preferences**, **Import��&��Export**.  \n\n### 5������ Cards (Reusable building blocks)  \n- **Send Messages**, **Execute**, **Webchat**, **Flow Logic**, **AI** (tasks, transitions, text generation).  \n\n### 6������ Webchat (Embedding & customization)  \n- **Flow Logic**, **AI** (tasks, transitions, generate text), **Capture Information**, **Events**, **Agents**, **Utilities**.  \n- **Webflow**, **Wix**, **WordPress**.  \n- **v1 (deprecated)** – controlling via JS, styling, embedding (React, iframe, full��screen).  \n- **v2** – Embedded Webchat, custom CSS, React components, Webchat client.  \n\n### 7������ Integrations  \n- **Usage** – Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft��Teams, Notion, Slack, Sunshine��Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk.  \n- **Building** – Getting started, adding channel capabilities, actions��&��triggers, publishing on Botpress��Hub, custom LLMs, live��agent connections, moving parts, CLI, SDK, key concepts (architecture, tags, channels, configuration, user, conversations, messages, events, states, actions, definitions, secrets, ZUI), “How��to” guides (states, registration, integration actions, handlers, logging, custom integrations).  \n\n### 8������ Botpress��APIs  \n- **Files��API** – upload/download/manage files, tags, public vs integration access, indexing for semantic search, file��metadata retrieval, pagination, update/delete, search (RAG).  \n- **Chat��API** – (not detailed here).  \n\n### 9������ Appendix  \n- **Safety** – Preventing abuse, Brand safety framework.  \n- **Exporting Data** –  \n  - **Raw Conversations** – API to list conversations, paginate, fetch messages, format history.  \n  - **Conversation History** – Summary Agent (summary��+��transcript), Hooks (custom full��history), sending via Execute��Code.  \n  - **Streaming Analytics**, **Compiled Bot Analytics**.  \n\n---  \n\n### ��� Key Practical Guides  \n\n- **Raw Conversations** – Use `GET /chat/conversations` (Axios or Botpress��Client) with `Authorization`��Bearer token and `x-bot-id`. Paginate via `nextToken`. Retrieve messages per conversation with `listMessages`. Format messages into readable strings.  \n- **Files��API** – Create/upload files (content, URL, Buffer) via `client.uploadFile`. Manage tags, access policies (`public_content`, `integrations`), indexing (`index:true`), list/filter files, update metadata, delete, and run semantic searches for RAG.  \n- **Find Function** – Quick search across nodes, actions, intents, variables; shows contextual results, navigation, keyword highlighting.  \n- **Conversation History** – Export via Summary Agent (summary��+��transcript) or Hooks (custom `fullHistory`). Send history with Execute��Code (e.g., `axios.post`).  \n\n---  \n\n**Bottom line:** The Botpress documentation provides a complete, horizontally��structured overview covering bot creation, UI studio, agents, card system, webchat embedding, a wide range of native integrations, API endpoints (files & chat), safety guidelines, and data��export options (raw conversations, history, analytics).\n\n============\n\n**Botpress Overview**  \nBotpress is a low��code platform for building, deploying, and monitoring LLM��powered AI agents and chatbots across many communication channels.\n\n---\n\n## Table of Contents (Documentation Overview)\n\n### 1. Getting Started  \n- **Build** – design bots in Botpress��Studio.  \n- **Deploy** – push bots to production or embed them.  \n- **Monitor** – analytics, logs, and performance dashboards.\n\n### 2. Dashboard  \n- **Workspace** – Home, Members, Audits, Integrations, Usage, Settings, Profile.  \n- **Bot** – Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Config variables.\n\n### 3. Studio  \n- **Interface** – Nodes, Home, Flows, Knowledge Base, Tables.  \n- **Agents** – Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics.  \n- **Library & Hooks** – reusable assets & custom code.  \n- **Integrations** – manage external services.  \n- **Schemas & Card Hub** – data models & reusable cards.  \n- **Versions, Settings, Variables** – version control, bot��wide config, runtime vars.  \n- **Card Tray** – drag��and��drop cards (Send Messages, Execute, Webchat, Flow Logic, AI).  \n- **Debugger, Logs & JSON** – event debugging, log viewer, raw payloads.  \n- **Emulator, Keyboard Shortcuts, Commands, Preferences** – testing and UI tweaks.  \n- **Import & Export** – move bots between environments.\n\n### 4. Cards (Core Building Blocks)  \n- **Send Messages** – text, media, quick replies.  \n- **Execute** – run custom JavaScript.  \n- **Webchat** – embed, style, and control the chat UI.  \n- **Flow Logic** – *Intent* (route on recognized intents) & *Expression* (JS��based conditions).  \n- **AI** – AI Task, AI Transition, AI Generate Text.\n\n### 5. Webchat  \n- **Webchat v1 (deprecated)** – JavaScript control, styling (Chatbot Button, Header, Input, Bot Info), embedding (React, React��Native, Iframe, Full��Screen).  \n- **Webchat v2** – Embedded Webchat with custom CSS, React components, Webchat client.  \n- **Platforms** – Webflow, Wix, WordPress.\n\n### 6. Integrations (Messaging & Services)  \n- **Channels** – Asana, Instagram, Intercom, Line, Messenger, Microsoft��Teams, Notion, Slack, Sunshine��Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk.  \n- **Building Integrations** – Getting Started, Messaging channel capabilities, Actions & Triggers, Publish to Botpress��Hub, Use your own LLM, Connect live��agent (HITL), Moving Parts, CLI, SDK, Key Concepts (Architecture, Tags, Channels, Configuration, User, Conversations, Messages, Event, States, Actions, Definitions, Secrets, ZUI).\n\n### 7. Human��in��the��Loop (HITL)  \n- Real��time escalation, decision gates, audit trail, customizable triggers, only for Team/Enterprise plans.\n\n### 8. Events  \n- **Fixed Schedule** – cron��based triggers.  \n- **Webchat Triggers** – custom events, conversation start, message in channel.  \n- **Lifecycle Events** – LOADED, READY, UI.OPENED/CLOSED/RESIZE, CONFIG.SET, MESSAGE.SENT/RECEIVED/SELECTED, USER.CONNECTED.  \n- **Filtering & Statuses** – processed, failed, pending, ignored.\n\n### 9. Botpress APIs  \n- **Files API** – manage assets.  \n- **Chat API** – programmatic conversation handling.\n\n### 10. Appendix  \n- **Safety** – Preventing Abuse, Brand Safety Framework.  \n- **Exporting Data** – Raw conversations, conversation history, streaming analytics, compiled bot analytics.\n\n---\n\n*This condensed TOC gives a horizontal snapshot of every major documentation section, enabling quick navigation to any feature of the Botpress platform.*\n\n============\n\n**Botpress**��is an open��source platform for creating, deploying and managing conversational AI bots. Its documentation is organized as a comprehensive, horizontally��structured table of contents that covers every major feature without going deep into any single one.\n\n---\n\n## ��� Overview of the Documentation\n\n### 1. Getting Started  \n- **Build** – develop bots with the visual Studio or code��first.  \n- **Deploy** – publish bots to production, share via link, Webchat or integrations.  \n- **Monitor** – track usage, analytics and health.\n\n### 2. Dashboard  \n- **Workspace** – manage members, audits, usage, settings.  \n- **Bot** – overview, integrations, Webchat, **Logs**, **Conversations**, **Analytics**, **Events**, **Issues**, configuration variables.  \n- **Logs** – view all generated logs for a deployed bot.  \n- **Conversations** – list, filter (by ID, user, integration), inspect messages and JSON payloads.  \n- **Analytics** – user/session/message counters with date��range filters.  \n\n### 3. Studio (the visual editor)  \n- **Interface** – nodes, flows, home view.  \n- **Knowledge Base** – add searchable content.  \n- **Tables** – store persistent data.  \n- **Agents** – Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics.  \n- **Library & Hooks** – reusable components and custom code.  \n- **Integrations** – connect third��party services.  \n- **Schemas & Card Hub** – define data models and reusable cards.  \n- **Versions & Settings** – versioning, chatbot settings, variables.  \n- **Debugger, Logs & JSON** – inspect event properties, state, raw payloads.  \n- **Emulator** – test conversations locally; shortcuts for new conversation, timeout simulation, etc.  \n- **Keyboard Shortcuts & Commands** – speed up authoring.  \n- **Import��&��Export** – move bots between environments.\n\n### 4. Cards (building blocks)  \n- **Send Messages** – text, media, quick replies.  \n- **Execute** – run custom JavaScript, perform table CRUD (Get, Insert, Update, Delete, Find).  \n- **Webchat** – control embedded chat UI.  \n- **Flow Logic** – decision nodes, transitions.  \n- **AI** – AI Task, AI Transition, AI��Generate��Text.  \n- **Capture Information** – extract slots into variables.  \n\n### 5. Execute Cards – Deep Dive (overview)  \n- Run custom logic, dynamic interactions, API calls, access/modify bot state, error handling.  \n- Table operations let bots read/write persistent records (records identified by IDs, results stored in variables).\n\n### 6. Webchat  \n- **Webchat��v1 (deprecated)** – JS control, styling via CSS classes, embedding options (iframe, React, full��screen).  \n- **Webchat��v2** – modern Embedded Webchat with custom CSS, React components, Webchat client.  \n- **Quick��start** – copy embed code from the Bot tab, paste into HTML.  \n- **Styling** – add custom CSS to the *Styles* section.  \n- **Controls API** – `botpress` object exposing properties (`initialized`, `version`, `state`, …) and methods (`open`, `close`, `toggle`, `init`, `config`, `sendEvent`, `sendMessage`, `getUser`, `updateUser`, `on`).  \n- **Live demos** – interactive examples.\n\n### 7. Integrations  \n- **Usage** – ready��made connectors for Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft��Teams, Notion, Slack, Sunshine��Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk.  \n- **Building** – guide to create custom integrations: Getting Started, add messaging channels, actions��&��triggers, publish on Botpress Hub.  \n- **SDK & CLI** – programmatic access, extend platform.  \n- **Key Concepts** – architecture, tags, channels, configuration, user, conversations, messages, events, states, actions, definitions, secrets, ZUI (Zod UI components).  \n\n### 8. Botpress APIs  \n- **Files API** – manage assets.  \n- **Chat API** – interact with bots programmatically (send messages, fetch analytics, etc.).\n\n### 9. Appendix  \n- **Safety** – preventing abuse, brand��safety framework.  \n- **Exporting Data** – raw conversations, conversation history, streaming analytics, compiled bot analytics.\n\n---\n\n## ��� Core Functionalities Highlighted\n\n- **Event Debugger** – three tabs: **Logs**, **State** (global conversation state), **JSON** (raw event payload with properties such as type, channel, direction, payload, userId, botId, timestamps, IDs, suggestions, NLU, decision).  \n- **Publishing & Sharing** – *Publish* button, shareable link, embed Webchat, deploy via integrations, or use Botpress SDK to embed in apps.  \n- **Conversations Management** – real��time view of user��bot interactions, AI��generated summaries, message inspection, filtering.  \n- **Execute Cards & Table Operations** – custom code execution, data persistence, CRUD on bot tables.  \n- **Embedded Webchat** – quick embed, styling, control API for open/close, event listeners, custom user updates.\n\n---  \n\n*This summary provides a horizontal map of all documentation sections, giving a quick��reference guide to the breadth of Botpress features without diving into detailed implementations.*\n\n============\n\n**Botpress** – a cloud��native platform for creating, deploying and managing AI��powered chatbots with a visual studio, extensible integrations and built��in analytics.\n\n---\n\n## ��� Documentation Overview (Table of Contents)\n\n### 1. Getting Started\n- **Build** – create a bot project.  \n- **Deploy** – publish to Botpress Cloud.  \n- **Monitor** – observe health and usage.\n\n### 2. Dashboard\n- **Workspace** – Home, Members, Audits, Integrations, Usage, Settings, Profile.  \n- **Bot** – Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, **Configuration Variables**.\n\n### 3. Studio (visual flow editor)\n- **Interface** – Nodes, Home, Flows, Knowledge Base, Tables.  \n- **Agents** – Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics.  \n- **Library**, **Hooks**, **Integrations**, **Schemas**, **Card Hub**, **Versions**, **Chatbot Settings**, **Variables**, **Debugger/Logs/JSON**, **Emulator**, **Keyboard Shortcuts**, **Commands**, **Preferences**, **Import��&��Export**.\n\n### 4. Cards (building��block actions)\n- **Send Messages** – text, image, carousel, etc.  \n- **Execute** – run custom code.  \n- **Webchat** – embed the chat widget.  \n- **Flow Logic** – conditional routing.  \n- **AI** – tasks, transitions, text generation.\n\n### 5. Webchat\n- **Core features** – Flow Logic, AI, Capture Information, Events, Agents, Utilities.  \n- **Version��1 (deprecated)** – controlling via JavaScript, styling (button, header, input area, bot info), embedding (React, React��Native, iframe, full��screen).  \n- **Version��2** – Embedded Webchat, Custom CSS, React components, Webchat client.\n\n### 6. Integrations\n#### Usage (pre��built channels)\n- Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine��Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk.\n\n#### Building your own\n- **Getting Started** – add messaging capabilities, actions & triggers, publish to Botpress Hub.  \n- **LLM Interfaces** – use your own large language model.  \n- **Live��agent (HITL)** – connect human agents.  \n- **Moving Parts**, **CLI**, **SDK**.  \n- **Key Concepts** – Architecture, Tags, Channels, Configuration, User, Conversations, Messages, Event, States, Actions, Definitions, Secrets, ZUI (beta).  \n- **How��to** – States (register/unregister), Integration actions/events, Handlers, Logging, Custom integration.\n\n### 7. Botpress APIs\n- **Files API** – manage assets.  \n- **Chat API** – interact with bots programmatically.\n\n### 8. Appendix\n- **Safety** – Preventing Abuse, Brand Safety Framework.  \n- **Exporting Data** –  \n  - *Raw Conversations* (API)  \n  - *Conversation History* (in��bot)  \n  - *Streaming Analytics* (Hooks)  \n  - *Compiled Bot Analytics* (API)  \n\n---\n\n## ��� Core Features Highlighted in the Docs\n\n### Exporting & Analytics\n- Obtain a **personal access token** from the dashboard.  \n- Example Axios request to `/admin/{botId}/analytics` returns JSON records with `startDateTimeUtc`, `endDateTimeUtc`, `returningUsers`, `newUsers`, `sessions`, `messages`.  \n- Use the data to build internal dashboards or stream real��time events via **Hooks** to services like Mixpanel, Hotjar, Segment, Amplitude.\n\n### Configuration Variables\n- Store secrets (API keys, DB credentials).  \n- **Development** – set in Studio (emulator only).  \n- **Production** – set in the Dashboard → Configuration Variables tab.  \n- Access in flows: `{{env.KEY}}` or `env.KEY` in Execute Code cards.\n\n### Capture Information Cards\n- Prompt users and extract typed data into workflow variables.  \n- **Supported field types** (each maps to a variable type):  \n  - **SingleChoice**, **MultipleChoice**, **Boolean**, **Confirmation**, **Number**, **EmailAddress**, **PhoneNumber**, **FullAddress**, **Price**, **RawInput**, **Percentage**, **Quantity**, **Color**, **TimeMeasurement**, **WeightMeasurement**, **CronSchedule**, **OperatingSystem**, **QuantityofPeople**, **VolumeMeasurement**, **TemperatureMeasurement**, **Person**, **DateTime**.  \n- Example: a *SingleChoice* card asking “Preferred transport?” stores the answer in `preferredTransportation`.\n\n### Controlling the Webchat Widget (JavaScript SDK)\n```js\nwindow.botpressWebChat = { init, mergeConfig, onEvent, sendPayload, sendEvent };\n```\n- **init** – set `botId`, `hostUrl`, `messagingUrl`, `clientId`, optional `userData`.  \n- **mergeConfig** – update widget options (e.g., `showTimestamp`).  \n- **sendEvent** – show/hide/toggle chat, load specific conversation, etc.  \n- **sendPayload** – send a text or custom message to the bot.  \n- **onEvent** – listen for lifecycle events (e.g., `MESSAGE.RECEIVED`).  \n\n---\n\n### Summary\nThe Botpress documentation covers the full lifecycle of a chatbot:\n\n1. **Starting** a project → **building** flows in Studio.  \n2. **Enriching** interactions with Cards, AI, and Capture Information.  \n3. **Deploying** via the Dashboard, configuring variables, and monitoring analytics.  \n4. **Integrating** with dozens of third��party channels or creating custom connectors via the SDK/CLI.  \n5. **Embedding** the Webchat widget and controlling it programmatically.  \n6. **Exporting** conversation and analytics data for BI or compliance needs.  \n\nAll sections are organized hierarchically as shown above, giving a complete, high��level map of the Botpress docs without diving into any single feature.\n\n============\n\n**Botpress** is an open��source platform that lets developers design, run, and monitor AI��powered chatbots through a visual studio, a rich set of reusable cards, and extensible integrations.\n\n### Documentation Table of Contents – High��Level Overview\n- **Getting Started**\n  - Build, Deploy, Monitor\n- **Dashboard**\n  - Workspace, Bot, Members, Audits, Integrations, Usage, Settings, Profile\n- **Bot**\n  - Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration variables\n- **Studio**\n  - Interface, Nodes, Flows, Knowledge Base, Tables, Agents (Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics), Library, Hooks, Integrations, Schemas, Card Hub, Versions, Chatbot Settings, Find, Variables, Card Tray, Debugger/Logs/JSON, Emulator, Keyboard Shortcuts, Commands, Preferences, Import��&��Export\n- **Cards**\n  - Send Messages, Execute, Webchat, Flow Logic, AI (Task, Transition, Generate Text)\n- **Webchat**\n  - Flow Logic, AI, Capture Information, Events, Agents, Utilities\n  - Webchat v1 (deprecated) – Controlling, Styling, Embedding\n  - Webchat v2 – Embedded Webchat, Custom CSS, React components, Client\n- **Integrations**\n  - Usage (Asana, HITL, Instagram, Intercom, Line, Messenger, Teams, Notion, Slack, Sunshine, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp, Zapier, Zendesk)\n  **Building** – Getting Started, Channel capabilities, Actions��&��Triggers, Publishing, LLM interfaces, Live��agent connection, CLI, SDK, Key Concepts (Architecture, Tags, Channels, Configuration, Users, Conversations, Messages, Events, States, Actions, Definitions, Secrets, ZUI)\n- **Botpress APIs**\n  - Files API, Chat API\n- **Appendix**\n  - Safety (Preventing Abuse, Brand Safety Framework)\n  - Exporting Data (Raw conversations, Conversation history, Streaming analytics, Compiled analytics)\n\n### Prompt Field Types (Capture Information)\n- **Basic**: Single Choice, Multi Choice, Boolean, Confirmation, Number, Email Address, Phone Number, FullAddress, Price, Raw Input, Percentage\n- **Specialized**: Quantity, Color, Time Measurement, Weight Measurement, Cron Schedule, Operating System, Quantity of People, Volume Measurement, Temperature Measurement, Person, DateTime, Wait for User Input\n\n### Custom Prompt Fields\n- **Entity – Regex** – extract patterns (e.g., credit��card numbers) with optional masking\n- **Entity – List** – match user input against a curated list with fuzzy��matching options (Strict, Medium, Loose)\n\n### Advanced Configuration\n- **Retries** – number of attempts, custom retry messages, failure transition handling\n- **Validation** – label��based or code��based rules, custom failure messages\n- **Extract from History** – reuse values from previous messages\n- **Cancellation** – user��initiated abort with optional confirmation\n- **Choices** – present predefined options (buttons or dropdowns) for single/multiple choice, boolean, confirmation, raw input\n- **Advanced Flags** – add failure transition, skip already��filled variables\n\n### Prompt Chaining\n- Sequence multiple capture cards to pull several values from a single user message; each card can fall back to a prompt if the value isn’t found, then store results in `{{workflow.<variableName>}}`.\n\n### CLI (Command��Line Interface)\n- Install via npm/yarn/pnpm, commands for login, bot management, integration handling, project init, generate typings, bundle, build, serve, deploy, and adding integrations.\n\n### Additional Docs Highlights\n- **Formatting Date** – using Luxon for human��readable date strings\n- **Wait for User Input** – pause flow until user replies\n- **Card Tray** – drag��and��drop toolbox for building workflows\n\nThis summary provides a horizontal snapshot of all major sections and features covered in the Botpress documentation, giving a quick reference to the platform’s capabilities and where to find detailed guidance.\n\n============\n\n**Botpress**��is an open��source platform for building, deploying, and managing AI��powered chatbots and conversational agents.\n\n### Table of Contents (overview)\n\n#### 1. Getting Started\n- Build  \n- Deploy  \n- Monitor  \n\n#### 2. Dashboard\n- **Workspace** – Home, Members, Audits, Integrations, Usage, Settings, Profile  \n- **Bot** – Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration variables  \n\n#### 3. Studio (core authoring UI)\n- Interface, Nodes, Home, Flows, Knowledge Base, Tables  \n- **Agents** – Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics  \n- Library, Hooks, Integrations, Schemas  \n- **Card Hub** – browse/install pre��built workflows  \n- Versions, **Chatbot Settings**, Find, Variables, **Card Tray**, Debugger��/��Logs��/��JSON, Emulator, Keyboard Shortcuts, Commands, Studio Preferences, Import��&��Export  \n\n#### 4. Cards (building��block actions)\n- Send Messages  \n- Execute  \n- Webchat  \n- Flow Logic  \n- **AI** – AI Task, AI Transition, AI Generate Text  \n\n#### 5. Webchat\n- Flow Logic, AI (Task/Transition/Generate Text)  \n- Capture Information, Events, Agents, Utilities  \n- **Webchat v1 (deprecated)** – JavaScript control, styling, embedding (React, Iframe, fullscreen)  \n- **Webchat v2** – Embedded Webchat, custom CSS, React components, Webchat client  \n\n#### 6. Integrations\n- **Usage** – Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual config), Zapier, Zendesk  \n- **Building** – Getting Started, Adding Messaging Channel Capabilities, Adding Actions��&��Triggers, Publishing on Botpress Hub, Using your own LLM, Connecting live��agent platforms, Moving Parts, CLI, SDK, Key Concepts (Architecture, Tags, Channels, Configuration, User, Conversations, Messages, Events, States, Actions, Definitions, Secrets, ZUI)  \n\n#### 7. Botpress APIs\n- Files API  \n- Chat API  \n\n#### 8. Appendix\n- **Safety** – Preventing Abuse, **Brand Safety Framework** (LLM Transparency, Policy Agent, RAG Safety, LLM Inspector, HITL)  \n- **Exporting Data** – Raw Conversations, Conversation History, Streaming Analytics, Compiled Bot Analytics  \n\n#### 9. Audits\n- Chronological log of workspace and bot changes (member, action, timestamp)  \n\n### Key Features (horizontal coverage)\n\n- **Card Tray** – searchable panel of reusable Cards (e.g., authentication, data collection, conditional logic); drag��and��drop into flows; configurable per��node.  \n- **Card Hub** – central library to download/install complete pre��made workflows; cards can be customized or shared publicly.  \n- **Agents** – modular extensions that add specialized capabilities (summary, translation, knowledge retrieval, human��in��the��loop, vision, analytics, etc.).  \n- **AI Cards** – direct access to large language models for tasks, transitions, and text generation; integrated throughout Botpress.  \n- **Brand Safety Framework** – tools for LLM transparency, policy enforcement, retrieval��augmented generation safety, inspection of decision trees, and human��in��the��loop handoff.  \n- **Chatbot Settings** – global bot controls (inactivity timeout, node repetition limit, client access, default LLM selections��—��Fast, Best, Autonomous, LLMz version, global variables).  \n\n### Navigation shortcuts\n- **Card Tray** (right��hand side in Studio) → drag cards into flows.  \n- **Card Hub** (globe icon) → search/install cards → appear in Card Tray.  \n- **Agents** & **AI** sections in the Card Tray provide ready��made intelligence components.  \n\nThis summary captures the full breadth of the Botpress documentation, highlighting each major section and the principal features without delving into deep implementation details.\n\n============\n\n**Botpress** is an all��in��one platform for building, deploying and monitoring LLM��powered AI agents and chat��bots.  \n\n## Table of Contents (Documentation Overview)\n\n### 1. Home & Getting Started  \n- **Home** – entry point to the docs.  \n- **Build** – design bots in the Studio.  \n- **Deploy** – launch bots to users or teams.  \n- **Monitor** – analytics, logs and performance tracking.\n\n### 2. Dashboard  \n- **Workspace** – Home, Members, Audits, Integrations, Usage, Settings, Profile.  \n- **Bot** – Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration variables.\n\n### 3. Studio  \n- **Interface** – Nodes, Home, Flows, Knowledge Base, Tables.  \n- **Agents** – Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics.  \n- **Library & Hooks** – reusable assets and custom code hooks.  \n- **Integrations & Schemas** – connect external services, define data models.  \n- **Card Hub & Versions** – manage UI cards, version history.  \n- **Chatbot Settings, Variables, Card Tray** – configure bot behavior.  \n- **Debugger, Emulator, Logs & JSON** – inspect runtime data.  \n- **Keyboard Shortcuts, Commands, Preferences** – productivity tools.  \n- **Import & Export** – move bots between environments.\n\n### 4. Cards (building blocks)  \n- **Send Messages**, **Execute**, **Webchat**, **Flow Logic**, **AI** (tasks, transitions, text generation).\n\n### 5. Webchat  \n- Core **Flow Logic** and **AI** features.  \n- **Capture Information**, **Events**, **Agents**, **Utilities**.  \n- **Webchat v1 (deprecated)** – JavaScript control, styling, embedding options.  \n- **Webchat v2** – Embedded Webchat, custom CSS, React components, client SDK.\n\n### 6. Integrations  \n- **Usage** – ready��made connectors (Asana, HITL, Instagram, Intercom, Line, Messenger, Teams, Notion, Slack, Sunshine, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp, Zapier, Zendesk, etc.).  \n- **Building** – create custom integrations:  \n  - Getting started, adding messaging channels, actions & triggers, publishing to Botpress Hub.  \n  - Use your own LLM, connect live��agent platforms, CLI, SDK.  \n  **Key Concepts** – Architecture, Tags, Channels, Configuration, User, Conversations, Messages, Events, States, Actions, Definitions, Secrets, ZUI (beta).  \n  **How��to** – managing states, registering/unregistering, integration actions & events, handlers, logging, custom integration development.\n\n### 7. Botpress APIs  \n- **Files API** – manage file assets.  \n- **Chat API** – programmatic chat interactions.\n\n### 8. Appendix  \n- **Safety** – Preventing abuse, Brand safety framework.  \n- **Exporting Data** – raw conversations, conversation history, streaming analytics, compiled bot analytics.\n\n### 9. Analytics (Dashboard tab)  \n- **Default Layout** – pre��configured charts (users, sessions, messages, etc.).  \n- **Custom Boards** – create/edit charts, choose time periods, event types, chart styles (area, donut, bar, pie, metric, spark).  \n- **Analytics Agent** (Team plan) – track custom events via “Track Event” card.\n\n### 10. Platform Features (high��level)  \n- **Agent Studio** – rapid bot creation.  \n- **Autonomous Engine** – LLM��driven conversations.  \n- **Knowledge Bases & Tables** – import & store external knowledge, manage conversation data.  \n- **Hub** – browse integrations, LLM providers, templates.  \n- **Solutions** – Enterprise, Freelancers & Agencies, Developers.  \n- **Resources** – guides, videos, API reference, SDK, CLI, community support.  \n\n*All sections are linked from the left��hand navigation in the Botpress documentation site, providing a comprehensive overview of the platform’s capabilities.*\n<|new_information|>","role":"user","type":"text"}],"meta":{"integrationName":"zai","promptCategory":"zai:summarize","promptSource":"zai:summarize:default"},"model":"fast","signal":{},"stopSequences":["■END■"]},"method":"POST","url":"https://api.botpress.cloud/v2/cognitive/generate-text"}

Output:
**Botpress – Open‑source platform for building, deploying and managing AI‑powered chatbots**

---

## 1. Getting Started
- **Build** – author bots in the visual Botpress Studio (flows, nodes, agents).
- **Deploy** – publish to Botpress Cloud or self‑hosted runtimes.
- **Monitor** – view usage, performance metrics and logs.

## 2. Dashboard (Workspace)
- **Workspace** – Home, Members, Audits, Integrations, Usage, Settings, Profile.
- **Bot view** – Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration Variables.

## 3. Studio – Core authoring UI
| Area | Key items |
|------|-----------|
| **Interface** | Nodes, Flow editor, Home, Knowledge Base, Tables. |
| **Agents** | Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics. |
| **Reusable assets** | Library, Hooks, Schemas, Card Hub, Versions, Chatbot Settings. |
| **Runtime tools** | Variables, Find, Card Tray, Debugger / Logs / JSON, Emulator, Keyboard shortcuts, Commands, Preferences. |
| **Project management** | Import / Export, version control. |

## 4. Cards – Building blocks for flows
- **Send Messages** – text, media, quick‑replies, carousel.
- **Execute** – custom JavaScript / table CRUD.
- **Webchat** – embed, style, control the chat widget.
- **Flow Logic** – conditional routing, intents, expressions.
- **AI** – AI Task, AI Transition, AI Generate Text.
- **Capture Information** – prompt users and store values in workflow variables.

## 5. Webchat (chat widget)
- **Core capabilities** – flow logic, AI tasks/transitions, data capture, events, agents, utilities.
- **Version 1 (deprecated)** – JavaScript control, full UI styling, embedding via React, React‑Native, iframe or full‑screen.
- **Version 2** – modern embedded widget, custom CSS, React components, client SDK, quick‑start script.

## 6. Integrations
### 6.1 Usage – ready‑made connectors
Asana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual), Zapier, Zendesk, etc.

### 6.2 Building custom integrations
- **Getting started** → add messaging channel → define actions / triggers → publish on Botpress Hub.
- **Developer resources** – CLI, SDK, LLM interfaces, live‑agent (HITL) support.
- **Key concepts** – Architecture, Tags, Channels, Configuration, Users, Conversations, Messages, Events, States, Actions, Definitions, Secrets, ZUI (beta).
- **How‑to guides** – state lifecycle, registration, handlers, logging.

## 7. Botpress APIs
- **Files API** – upload, list, update, delete, tag and search assets (including semantic RAG).
- **Chat API** – programmatic interaction with conversations (send/receive messages, fetch analytics).

## 8. Appendix
- **Safety** – abuse‑prevention limits, Web‑Application Firewall, brand‑safety framework (policy agent, LLM guardrails, HITL fallback).
- **Exporting Data** – raw conversations, conversation history, streaming analytics (hooks), compiled bot analytics.

## 9. Additional notable sections
- **Variables** – scopes (Workflow, User, Bot, Session, Configuration), types (string, boolean, number, date, object, array, enum, pattern).
- **Tables** – up to 10 tables, 20 columns, 10 000 rows; CRUD via UI, cards or client API; AI‑generated filters (`AI\`` syntax).
- **Analytics Dashboard** – pre‑configured charts (users, sessions, messages) + custom boards; “Track Event” card for custom metrics.
- **Usage & limits** – token‑based AI spend, storage quotas, collaborator counts, “Always‑Alive” instances.
- **Profile & Settings** – personal info, social‑account linking, personal access tokens.
- **Versioning** – create, list, revert bot versions; plan‑based caps.

---

**Bottom line:** The Botpress documentation is organized as a high‑level Table of Contents that gives a *horizontal* view of every major capability—getting started, UI (Dashboard + Studio), reusable Cards, Webchat embedding, a wide ecosystem of integrations (both ready‑made and custom), API access, safety, and data‑export—so developers can quickly locate the topic they need without drilling deep into any single feature.


Input: {"body":{"input":{"messages":[{"content":"\"**Botpress – Open‑source platform for building, deploying and managing AI‑powered chatbots**  \\n\\n---  \\n\\n## 1. Getting Started  \\n- **Build** – author bots in the visual Botpress Studio (flows, nodes, agents).  \\n- **Deploy** – publish to Botpress Cloud or self‑hosted runtimes.  \\n- **Monitor** – view usage, performance metrics and logs.\\n\\n## 2. Dashboard (Workspace)  \\n- **Workspace** – Home, Members, Audits, Integrations, Usage, Settings, Profile.  \\n- **Bot view** – Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration Variables.\\n\\n## 3. Studio – Core authoring UI  \\n| Area | Key items |\\n|------|-----------|\\n| **Interface** | Nodes, Flow editor, Home, Knowledge Base, Tables. |\\n| **Agents** | Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics. |\\n| **Reusable assets** | Library, Hooks, Schemas, Card Hub, Versions, Chatbot Settings. |\\n| **Runtime tools** | Variables, Find, Card Tray, Debugger / Logs / JSON, Emulator, Keyboard shortcuts, Commands, Preferences. |\\n| **Project management** | Import / Export, version control. |\\n\\n## 4. Cards – Building blocks for flows  \\n- **Send Messages** – text, media, quick‑replies, carousel.  \\n- **Execute** – custom JavaScript / table CRUD.  \\n- **Webchat** – embed, style, control the chat widget.  \\n- **Flow Logic** – conditional routing, intents, expressions.  \\n- **AI** – AI Task, AI Transition, AI Generate Text.  \\n- **Capture Information** – prompt users and store values in workflow variables.  \\n\\n## 5. Webchat (chat widget)  \\n- **Core capabilities** – flow logic, AI tasks/transitions, data capture, events, agents, utilities.  \\n- **Version 1 (deprecated)** – JavaScript control, full UI styling, embedding via React, React‑Native, iframe or full‑screen.  \\n- **Version 2** – modern embedded widget, custom CSS, React components, client SDK, quick‑start script.  \\n\\n## 6. Integrations  \\n### 6.1 Usage – ready‑made connectors  \\nAsana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual), Zapier, Zendesk, etc.  \\n\\n### 6.2 Building custom integrations  \\n- **Getting started** → add messaging channel → define actions / triggers → publish on Botpress Hub.  \\n- **Developer resources** – CLI, SDK, LLM interfaces, live‑agent (HITL) support.  \\n- **Key concepts** – Architecture, Tags, Channels, Configuration, Users, Conversations, Messages, Events, States, Actions, Definitions, Secrets, ZUI (beta).  \\n- **How‑to guides** – state lifecycle, registration, handlers, logging.  \\n\\n## 7. Botpress APIs  \\n- **Files API** – upload, list, update, delete, tag and search assets (including semantic RAG).  \\n- **Chat API** – programmatic interaction with conversations (send/receive messages, fetch analytics).  \\n\\n## 8. Appendix  \\n- **Safety** – abuse‑prevention limits, Web‑Application Firewall, brand‑safety framework (policy agent, LLM guardrails, HITL fallback).  \\n- **Exporting Data** – raw conversations, conversation history, streaming analytics (hooks), compiled bot analytics.  \\n\\n## 9. Additional notable sections  \\n- **Variables** – scopes (Workflow, User, Bot, Session, Configuration), types (string, boolean, number, date, object, array, enum, pattern).  \\n- **Tables** – up to 10 tables, 20 columns, 10 000 rows; CRUD via UI, cards or client API; AI‑generated filters (`AI\\\\`` syntax).  \\n- **Analytics Dashboard** – pre‑configured charts (users, sessions, messages) + custom boards; “Track Event” card for custom metrics.  \\n- **Usage & limits** – token‑based AI spend, storage quotas, collaborator counts, “Always‑Alive” instances.  \\n- **Profile & Settings** – personal info, social‑account linking, personal access tokens.  \\n- **Versioning** – create, list, revert bot versions; plan‑based caps.  \\n\\n---  \\n\\n**Bottom line:** The Botpress documentation is organized as a high‑level Table of Contents that gives a *horizontal* view of every major capability—getting started, UI (Dashboard + Studio), reusable Cards, Webchat embedding, a wide ecosystem of integrations (both ready‑made and custom), API access, safety, and data‑export—so developers can quickly locate the topic they need without drilling deep into any single feature.\"","role":"user"}],"model":{"id":"gpt-4o-mini-2024-07-18"},"responseFormat":"json_object","systemPrompt":"Check that the value meets the condition: The text has some information about HITL (human in the loop)\n\n---\nPlease generate a JSON response with the following format:\n```typescript\n{ \n/** A human-readable explanation of the result */\nreason: string\n; \n/** Your best guess at the output according to the instructions provided, rooted in the context of the input and the reason above */\nresult: boolean\n }\n```","temperature":0},"type":"openai:generateContent"},"method":"POST","url":"https://api.botpress.cloud/v1/chat/actions"}

{
  "reason": "The text contains multiple references to HITL (Human In The Loop), specifically mentioning it in the context of agents, integrations, and safety measures, indicating that it is a relevant topic within the content.",
  "result": true
}


Input: {"body":{"input":{"messages":[{"content":"\"**Botpress – Open‑source platform for building, deploying and managing AI‑powered chatbots**  \\n\\n---  \\n\\n## 1. Getting Started  \\n- **Build** – author bots in the visual Botpress Studio (flows, nodes, agents).  \\n- **Deploy** – publish to Botpress Cloud or self‑hosted runtimes.  \\n- **Monitor** – view usage, performance metrics and logs.\\n\\n## 2. Dashboard (Workspace)  \\n- **Workspace** – Home, Members, Audits, Integrations, Usage, Settings, Profile.  \\n- **Bot view** – Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration Variables.\\n\\n## 3. Studio – Core authoring UI  \\n| Area | Key items |\\n|------|-----------|\\n| **Interface** | Nodes, Flow editor, Home, Knowledge Base, Tables. |\\n| **Agents** | Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics. |\\n| **Reusable assets** | Library, Hooks, Schemas, Card Hub, Versions, Chatbot Settings. |\\n| **Runtime tools** | Variables, Find, Card Tray, Debugger / Logs / JSON, Emulator, Keyboard shortcuts, Commands, Preferences. |\\n| **Project management** | Import / Export, version control. |\\n\\n## 4. Cards – Building blocks for flows  \\n- **Send Messages** – text, media, quick‑replies, carousel.  \\n- **Execute** – custom JavaScript / table CRUD.  \\n- **Webchat** – embed, style, control the chat widget.  \\n- **Flow Logic** – conditional routing, intents, expressions.  \\n- **AI** – AI Task, AI Transition, AI Generate Text.  \\n- **Capture Information** – prompt users and store values in workflow variables.  \\n\\n## 5. Webchat (chat widget)  \\n- **Core capabilities** – flow logic, AI tasks/transitions, data capture, events, agents, utilities.  \\n- **Version 1 (deprecated)** – JavaScript control, full UI styling, embedding via React, React‑Native, iframe or full‑screen.  \\n- **Version 2** – modern embedded widget, custom CSS, React components, client SDK, quick‑start script.  \\n\\n## 6. Integrations  \\n### 6.1 Usage – ready‑made connectors  \\nAsana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual), Zapier, Zendesk, etc.  \\n\\n### 6.2 Building custom integrations  \\n- **Getting started** → add messaging channel → define actions / triggers → publish on Botpress Hub.  \\n- **Developer resources** – CLI, SDK, LLM interfaces, live‑agent (HITL) support.  \\n- **Key concepts** – Architecture, Tags, Channels, Configuration, Users, Conversations, Messages, Events, States, Actions, Definitions, Secrets, ZUI (beta).  \\n- **How‑to guides** – state lifecycle, registration, handlers, logging.  \\n\\n## 7. Botpress APIs  \\n- **Files API** – upload, list, update, delete, tag and search assets (including semantic RAG).  \\n- **Chat API** – programmatic interaction with conversations (send/receive messages, fetch analytics).  \\n\\n## 8. Appendix  \\n- **Safety** – abuse‑prevention limits, Web‑Application Firewall, brand‑safety framework (policy agent, LLM guardrails, HITL fallback).  \\n- **Exporting Data** – raw conversations, conversation history, streaming analytics (hooks), compiled bot analytics.  \\n\\n## 9. Additional notable sections  \\n- **Variables** – scopes (Workflow, User, Bot, Session, Configuration), types (string, boolean, number, date, object, array, enum, pattern).  \\n- **Tables** – up to 10 tables, 20 columns, 10 000 rows; CRUD via UI, cards or client API; AI‑generated filters (`AI\\\\`` syntax).  \\n- **Analytics Dashboard** – pre‑configured charts (users, sessions, messages) + custom boards; “Track Event” card for custom metrics.  \\n- **Usage & limits** – token‑based AI spend, storage quotas, collaborator counts, “Always‑Alive” instances.  \\n- **Profile & Settings** – personal info, social‑account linking, personal access tokens.  \\n- **Versioning** – create, list, revert bot versions; plan‑based caps.  \\n\\n---  \\n\\n**Bottom line:** The Botpress documentation is organized as a high‑level Table of Contents that gives a *horizontal* view of every major capability—getting started, UI (Dashboard + Studio), reusable Cards, Webchat embedding, a wide ecosystem of integrations (both ready‑made and custom), API access, safety, and data‑export—so developers can quickly locate the topic they need without drilling deep into any single feature.\"","role":"user"}],"model":{"id":"gpt-4o-mini-2024-07-18"},"responseFormat":"json_object","systemPrompt":"Check that the value meets the condition: The text has some information about integrations\n\n---\nPlease generate a JSON response with the following format:\n```typescript\n{ \n/** A human-readable explanation of the result */\nreason: string\n; \n/** Your best guess at the output according to the instructions provided, rooted in the context of the input and the reason above */\nresult: boolean\n }\n```","temperature":0},"type":"openai:generateContent"},"method":"POST","url":"https://api.botpress.cloud/v1/chat/actions"}

{
  "reason": "The text contains a dedicated section on 'Integrations' that lists various ready-made connectors and describes how to build custom integrations, indicating that it provides information about integrations.",
  "result": true
}


Input: {"body":{"input":{"messages":[{"content":"\"**Botpress – Open‑source platform for building, deploying and managing AI‑powered chatbots**  \\n\\n---  \\n\\n## 1. Getting Started  \\n- **Build** – author bots in the visual Botpress Studio (flows, nodes, agents).  \\n- **Deploy** – publish to Botpress Cloud or self‑hosted runtimes.  \\n- **Monitor** – view usage, performance metrics and logs.\\n\\n## 2. Dashboard (Workspace)  \\n- **Workspace** – Home, Members, Audits, Integrations, Usage, Settings, Profile.  \\n- **Bot view** – Overview, Integrations, Webchat, Logs, Conversations, Analytics, Events, Issues, Configuration Variables.\\n\\n## 3. Studio – Core authoring UI  \\n| Area | Key items |\\n|------|-----------|\\n| **Interface** | Nodes, Flow editor, Home, Knowledge Base, Tables. |\\n| **Agents** | Summary, Personality, Policy, Translator, Knowledge, HITL, Vision, Analytics. |\\n| **Reusable assets** | Library, Hooks, Schemas, Card Hub, Versions, Chatbot Settings. |\\n| **Runtime tools** | Variables, Find, Card Tray, Debugger / Logs / JSON, Emulator, Keyboard shortcuts, Commands, Preferences. |\\n| **Project management** | Import / Export, version control. |\\n\\n## 4. Cards – Building blocks for flows  \\n- **Send Messages** – text, media, quick‑replies, carousel.  \\n- **Execute** – custom JavaScript / table CRUD.  \\n- **Webchat** – embed, style, control the chat widget.  \\n- **Flow Logic** – conditional routing, intents, expressions.  \\n- **AI** – AI Task, AI Transition, AI Generate Text.  \\n- **Capture Information** – prompt users and store values in workflow variables.  \\n\\n## 5. Webchat (chat widget)  \\n- **Core capabilities** – flow logic, AI tasks/transitions, data capture, events, agents, utilities.  \\n- **Version 1 (deprecated)** – JavaScript control, full UI styling, embedding via React, React‑Native, iframe or full‑screen.  \\n- **Version 2** – modern embedded widget, custom CSS, React components, client SDK, quick‑start script.  \\n\\n## 6. Integrations  \\n### 6.1 Usage – ready‑made connectors  \\nAsana, HITL, Instagram, Intercom, Line, Messenger, Microsoft Teams, Notion, Slack, Sunshine Conversations, Telegram, Trello, Twilio, Viber, Vonage, Webhook, WhatsApp (manual), Zapier, Zendesk, etc.  \\n\\n### 6.2 Building custom integrations  \\n- **Getting started** → add messaging channel → define actions / triggers → publish on Botpress Hub.  \\n- **Developer resources** – CLI, SDK, LLM interfaces, live‑agent (HITL) support.  \\n- **Key concepts** – Architecture, Tags, Channels, Configuration, Users, Conversations, Messages, Events, States, Actions, Definitions, Secrets, ZUI (beta).  \\n- **How‑to guides** – state lifecycle, registration, handlers, logging.  \\n\\n## 7. Botpress APIs  \\n- **Files API** – upload, list, update, delete, tag and search assets (including semantic RAG).  \\n- **Chat API** – programmatic interaction with conversations (send/receive messages, fetch analytics).  \\n\\n## 8. Appendix  \\n- **Safety** – abuse‑prevention limits, Web‑Application Firewall, brand‑safety framework (policy agent, LLM guardrails, HITL fallback).  \\n- **Exporting Data** – raw conversations, conversation history, streaming analytics (hooks), compiled bot analytics.  \\n\\n## 9. Additional notable sections  \\n- **Variables** – scopes (Workflow, User, Bot, Session, Configuration), types (string, boolean, number, date, object, array, enum, pattern).  \\n- **Tables** – up to 10 tables, 20 columns, 10 000 rows; CRUD via UI, cards or client API; AI‑generated filters (`AI\\\\`` syntax).  \\n- **Analytics Dashboard** – pre‑configured charts (users, sessions, messages) + custom boards; “Track Event” card for custom metrics.  \\n- **Usage & limits** – token‑based AI spend, storage quotas, collaborator counts, “Always‑Alive” instances.  \\n- **Profile & Settings** – personal info, social‑account linking, personal access tokens.  \\n- **Versioning** – create, list, revert bot versions; plan‑based caps.  \\n\\n---  \\n\\n**Bottom line:** The Botpress documentation is organized as a high‑level Table of Contents that gives a *horizontal* view of every major capability—getting started, UI (Dashboard + Studio), reusable Cards, Webchat embedding, a wide ecosystem of integrations (both ready‑made and custom), API access, safety, and data‑export—so developers can quickly locate the topic they need without drilling deep into any single feature.\"","role":"user"}],"model":{"id":"gpt-4o-mini-2024-07-18"},"responseFormat":"json_object","systemPrompt":"Check that the value meets the condition: The text is a summary of the Botpress documentation\n\n---\nPlease generate a JSON response with the following format:\n```typescript\n{ \n/** A human-readable explanation of the result */\nreason: string\n; \n/** Your best guess at the output according to the instructions provided, rooted in the context of the input and the reason above */\nresult: boolean\n }\n```","temperature":0},"type":"openai:generateContent"},"method":"POST","url":"https://api.botpress.cloud/v1/chat/actions"}

{
  "reason": "The provided text is a detailed summary of the Botpress documentation, outlining its features, functionalities, and organization, which aligns with the request for a summary of the documentation.",
  "result": true
}