Team
Shared credential for production and unattended runs.
Connect Chatbotkit with Hookshot™ and your stack
ChatBotKit is a platform that enables developers to build and manage AI-powered chatbots, offering comprehensive APIs and SDKs for seamless integration into applications.
Tools and triggers
What Agents can do in Chatbotkit
Available tools and events after Chatbotkit is connected.
-
Attach Dataset File
Tool to attach a file to a dataset as a source. Use when you need to link a specific file to a dataset to provide knowledge content.
-
Authenticate Secret
Tool to authenticate a secret by its ID. Use when you need to generate an authentication URL for a specific secret.
-
Clone Blueprint
Tool to clone an existing blueprint. Use when you need to create a duplicate of a blueprint with all its associated resources.
-
Clone Bot
Tool to clone an existing bot. Use when you need to create a duplicate copy of a bot with all its settings and configurations.
-
Clone Platform Example
Tool to clone a platform example. Use when you need to create instances of all resources defined in a platform example template.
-
Clone Widget Integration
Tool to clone an existing widget integration. Use when you need to duplicate a widget integration while preserving its tested configurations.
-
Complete Conversation
Send a message to a ChatBotKit conversation and receive the bot's AI-generated reply. This is the primary action for interacting with a chatbot. It sends user text to an existing conversation and returns the bot's…
-
Create Blueprint
Tool to create a new blueprint in ChatBotKit. Use when you need to create a reusable template or configuration blueprint.
-
Create Blueprint (GraphQL)
Tool to create a new blueprint template via GraphQL mutation. Use when you need to create a reusable bot configuration template via the GraphQL API.
-
Create Bot
Tool to create a new AI bot with configurable settings. Use when you need to create a new chatbot with specific name, personality, model, and connected resources like datasets or skillsets.
-
Create Bot (GraphQL)
Tool to create a new bot using GraphQL mutation. Use when you need to create a bot with specified name, description, and other configuration via the GraphQL API.
-
Create Bot Session
Creates a new bot session with an associated conversation and authentication token. Use this when you need to start a new chat session with a bot, optionally with pre-populated messages.
-
Create Contact
Tool to create a new contact. Use when you need to track users interacting with bots. Contacts can have associated memories, secrets, and conversations.
-
Create Conversation
Tool to create a new conversation. Use when you need to start a new chat session with a bot. Conversations store message history between users and bots. You can either reference an existing bot by ID or configure a new…
-
Create Conversation Message
Tool to create a new message in an existing conversation. Use this to add user messages, bot messages, or other message types to a conversation.
-
Create Conversation Message Batch
Tool to create multiple messages in a conversation in a single batch operation. Use this when you need to add multiple messages at once, which is more efficient than creating them individually.
-
Create Conversation Session
Tool to create a new conversation session with an authentication token. Use when you need to generate a temporary access token for a conversation.
-
Create Dataset (GraphQL)
Tool to create a new dataset using GraphQL mutation. Use when you need to create a dataset to store knowledge and information for bots.
-
Create Dataset Record
Tool to create a new record in a dataset. Use when you need to add text data to an existing dataset for knowledge retrieval by bots.
-
Create Discord Integration
Tool to create a Discord integration for a ChatBotKit bot. Use when you need to connect a bot to Discord by providing Discord Application ID, Bot Token, and Public Key.
-
Create Email Integration
Tool to create a new email integration for a ChatBotKit bot. Email integrations enable your bot to receive and respond to emails, making it accessible through email communication channels. Use when you need to connect…
-
Create Extract Integration
Tool to create a new Extract integration for a ChatBotKit bot. Extract integrations enable your chatbot to automatically pull and extract structured data from conversations based on a predefined JSON schema. Use when…
-
Create File
Tool to create a new file resource in ChatBotKit. Use when you need to create a file that can be attached to datasets for processing and indexing. Note: This creates the file record; use the upload action to add actual…
-
Create Instagram Integration
Tool to create an Instagram integration for a ChatBotKit bot. Use when you need to connect a bot to Instagram by providing an Instagram access token.
-
Create MCP Server Integration
Tool to create a new MCP Server integration for ChatBotKit. Use when you need to set up an MCP (Model Context Protocol) Server integration to extend bot capabilities with custom server-side functionality.
-
Create Memory
Tool to create a new memory entry. Use when you need to store information for later retrieval, such as user preferences, conversation context, or important facts associated with a bot or contact.
-
Create Messenger Integration
Tool to create a Facebook Messenger integration for a ChatBotKit bot. Use when you need to connect a bot to Facebook Messenger by providing a Facebook Page Access Token.
-
Create Notion Integration
Tool to create a Notion integration for a ChatBotKit dataset. Use when you need to connect a dataset to Notion for syncing content between Notion pages and ChatBotKit.
-
Create Rating
Tool to create a rating in ChatBotKit. Use when you need to submit a numeric rating value for tracking purposes.
-
Create Secret
Tool to create a new secret in ChatBotKit. Secrets store credentials that bots use to access external services via skillset abilities. Use when you need to securely store API keys, tokens, or other authentication…
-
Create Secret (GraphQL)
Tool to create a new secret via GraphQL mutation. Use when you need to securely store credentials, API keys, or authentication tokens via the GraphQL API.
-
Create Sitemap Integration
Tool to create a sitemap integration for a ChatBotKit dataset. Sitemap integrations automatically crawl and index website content from a sitemap.xml file, keeping your dataset synchronized with your website content…
-
Create Skillset
Tool to create a new skillset. Use when you need to group multiple skills into a single reusable unit.
-
Create Slack Integration
Tool to create a Slack integration for a ChatBotKit bot. Use when you need to connect a bot to Slack by providing signing secret and bot token from Slack Developer Portal.
-
Create Space
Tool to create a new space in ChatBotKit. Use when you need to create a workspace or organizational container for related resources.
-
Create Support Integration
Creates a new support integration for a ChatBotKit bot. Support integrations enable your chatbot to handle customer support inquiries and optionally forward conversation summaries to a specified email address. Use this…
-
Create Task
Tool to create a new background task that can be triggered to perform automated operations. Use when you need to set up scheduled or on-demand tasks with configurable bot and contact associations.
-
Create Telegram Integration
Tool to create a Telegram integration for a ChatBotKit bot. Use when you need to connect a bot to Telegram by providing a Telegram bot token from BotFather.
-
Create Trigger Integration
Tool to create a Trigger integration for a ChatBotKit bot. Use when you need to set up automated triggers that can process events and execute bot actions on a schedule or based on specific conditions.
-
Create Twilio Integration
Tool to create a Twilio integration for a ChatBotKit bot. Use when you need to connect a bot to Twilio for SMS or messaging capabilities. All parameters are optional.
-
Create WhatsApp Integration
Creates a new WhatsApp integration for a ChatBotKit bot. WhatsApp integrations enable your chatbot to communicate with users through WhatsApp messaging. Use this when you need to connect a bot to WhatsApp Business API…
-
Create Widget Integration
Tool to create a Widget integration for a ChatBotKit bot. Use when you need to create a web widget that can be embedded on websites to enable conversations with a bot.
-
Create Widget Integration Session
Creates a new widget integration session for interactive chat. Use this when you need to initialize a widget chat session with optional contact information, initial messages, and custom session duration.
-
Delete Blueprint
Tool to permanently delete a blueprint from ChatBotKit. Use when you need to remove a blueprint and optionally its associated resources.
-
Delete Blueprint (GraphQL)
Tool to permanently delete a blueprint template via GraphQL mutation. Use when you need to remove a blueprint from the platform using the GraphQL API.
-
Delete Bot
Tool to delete a bot. Use when you need to permanently remove a bot from the system.
-
Delete Bot (GraphQL)
Tool to delete a bot via GraphQL mutation. Use when you need to permanently remove a bot from the system using the GraphQL API.
-
Delete Contact
Tool to permanently delete a contact from ChatBotKit. Use when you need to remove a contact from the system.
-
Delete Conversation
Tool to permanently delete a conversation from ChatBotKit. Use when you need to remove a conversation and all its associated messages.
-
Delete Conversation Message
Tool to permanently delete a message from a conversation in ChatBotKit. Use when you need to remove a specific message from a conversation.
-
Delete Dataset
Tool to permanently delete a dataset from ChatBotKit. Use when you need to remove a dataset and all its associated data.
-
Delete Dataset (GraphQL)
Tool to delete a dataset via GraphQL mutation. Use when you need to permanently remove a dataset and all its associated records using the GraphQL API.
-
Delete Dataset Record
Tool to permanently delete a record from a dataset. Use when you need to remove a specific record from a ChatBotKit dataset.
-
Delete Discord Integration
Tool to delete a Discord integration. Use when you need to permanently remove a Discord integration from the system.
-
Delete Email Integration
Tool to permanently delete an Email integration from ChatBotKit. Use when you need to remove an Email integration from the system.
-
Delete Extract Integration
Tool to delete an Extract integration. Use when you need to permanently remove an Extract integration from the system.
-
Delete File
Tool to permanently delete a file from ChatBotKit. Use when you need to remove a file from the system.
-
Delete Instagram Integration
Tool to permanently delete an Instagram integration from ChatBotKit. Use when you need to remove an Instagram integration from the system.
-
Delete Integration (GraphQL)
Tool to delete an integration via GraphQL mutation. Use when you need to permanently remove an integration from the system using the GraphQL API.
-
Delete MCP Server Integration
Tool to delete an MCP Server integration. Use when you need to permanently remove an MCP Server integration from the system.
-
Delete Memory
Tool to permanently delete a memory from ChatBotKit. Use when you need to remove a memory from the system.
-
Delete Messenger Integration
Tool to permanently delete a Messenger integration from ChatBotKit. Use when you need to remove a Messenger integration from the system.
-
Delete Notion Integration
Tool to permanently delete a Notion integration from ChatBotKit. Use when you need to remove a Notion integration from the system.
-
Delete Partner User
Tool to permanently delete a partner user account. Use when you need to clean up test or inactive accounts.
-
Delete Rating
Tool to permanently delete a rating from ChatBotKit. Use when you need to remove a rating from the system.
-
Delete Secret
Tool to permanently delete a secret from ChatBotKit. Use when you need to remove a secret from the system.
-
Delete Sitemap Integration
Tool to permanently delete a Sitemap integration from ChatBotKit. Use when you need to remove a Sitemap integration from the system.
-
Delete Skillset
Tool to delete a skillset. Use when you need to permanently remove a skillset from the system.
-
Delete Skillset Ability
Tool to delete an ability from a skillset. Use when you need to remove a specific ability from a skillset.
-
Delete Slack Integration
Tool to delete a Slack integration. Use when you need to permanently remove a Slack integration from the system.
-
Delete Space
Tool to permanently delete a space from ChatBotKit. Use when you need to remove a space from the system.
-
Delete Support Integration
Tool to delete a Support integration. Use when you need to permanently remove a Support integration from the system.
-
Delete Task
Tool to permanently delete a task from ChatBotKit. Use when you need to remove a task from the system.
-
Delete Telegram Integration
Tool to permanently delete a Telegram integration from ChatBotKit. Use when you need to remove a Telegram integration from the system.
-
Delete Trigger Integration
Tool to permanently delete a Trigger integration from ChatBotKit. Use when you need to remove a Trigger integration from the system.
-
Delete Twilio Integration
Tool to delete a Twilio integration. Use when you need to permanently remove a Twilio integration from the system.
-
Delete WhatsApp Integration
Tool to permanently delete a WhatsApp integration from ChatBotKit. Use when you need to remove a WhatsApp integration from the system.
-
Delete Widget Integration
Tool to delete a Widget integration. Use when you need to permanently remove a Widget integration from the system.
-
Detach Dataset File
Tool to detach a file from a dataset. Use when you need to remove a file's association with a dataset, optionally deleting its records.
-
Download File
Tool to download a file by its ID. Use when you need to retrieve a file's content from ChatBotKit.
-
Downvote Bot
Tool to downvote a bot in ChatBotKit. Use when you need to register negative feedback on a bot's performance or quality.
-
Downvote Conversation
Tool to downvote a conversation in ChatBotKit. Use when you need to register negative feedback on a conversation's quality or outcome.
-
Downvote Conversation Message
Tool to downvote a conversation message in ChatBotKit. Use when you need to register negative feedback on a message's quality or appropriateness.
-
Ensure Contact
Tool to ensure a contact exists or create a new one. Use when you need to create or retrieve a contact by fingerprint, ensuring idempotent contact management.
-
Execute GraphQL Query
Tool to execute a GraphQL query or mutation against the ChatBotKit API. Use when you need to run custom GraphQL queries to retrieve or modify data in flexible ways not covered by other actions.
-
Export Contacts
Tool to export contacts with pagination support. Use when you need to retrieve or export contact information from ChatBotKit.
-
Export Conversations
Tool to export conversations with pagination support. Use when you need to retrieve and export conversation data in bulk for analysis, backup, or migration purposes.
-
Export Dataset Records
Tool to export dataset records with pagination support. Use when you need to retrieve or export record data from a specific ChatBotKit dataset.
-
Export Event Logs
Tool to export event logs with pagination support. Use when you need to retrieve and export event log data for monitoring, auditing, or analysis purposes.
-
Export Memories
Tool to export memories with pagination support. Use when you need to retrieve or export memory information from ChatBotKit.
-
Export Skillset Abilities
Tool to export all abilities from a specific skillset with pagination support. Use when you need to retrieve the complete list of abilities within a skillset.
-
Export Spaces
Tool to export spaces with pagination support. Use when you need to retrieve or export space data in bulk for analysis, backup, or migration purposes.
-
Export Tasks
Tool to export tasks with pagination support. Use when you need to retrieve and export task data in bulk for analysis, backup, or migration purposes.
-
Fetch Blueprint
Tool to fetch a blueprint by ID. Use when you need to retrieve detailed information about a specific blueprint.
-
Fetch Blueprint (GraphQL)
Tool to fetch a single blueprint by ID using GraphQL. Returns detailed blueprint information including template configuration. Use when you need structured GraphQL response format with complete blueprint metadata.
-
Fetch Bot
Tool to fetch a specific bot by its ID. Use when you need detailed information about a particular bot including configuration, model, dataset, and skillset associations.
-
Fetch Bot (GraphQL)
Tool to fetch a single bot by ID using GraphQL query. Use when you need to retrieve bot configuration, backstory, model, and other details via the GraphQL API.
-
Fetch Bot Usage
Tool to fetch bot usage statistics for a specific bot. Use when you need to retrieve metrics like conversations, messages, and token usage for a given time period.
-
Fetch Contact
Tool to retrieve detailed information about a specific contact by ID. Use when you need to access contact details including email, phone, fingerprint, and preferences.
-
Fetch Conversation
Tool to retrieve full details of a specific conversation by its ID. Use when you need complete information about a conversation including its configuration, metadata, and associated resources.
-
Fetch Conversation Message
Tool to retrieve full details of a specific message within a conversation. Use when you need complete information about a particular message including its content, type, and metadata.
-
Fetch Conversation Usage
Tool to fetch usage statistics for a specific conversation. Use when you need to retrieve token and message counts for billing, monitoring, or analytics purposes.
-
Fetch Conversation with Messages (GraphQL)
Tool to fetch a single conversation by ID with messages and metadata using GraphQL. Returns detailed conversation information including all messages, associated bot, contact, space, and task. Use when you need complete…
-
Fetch Dataset
Tool to fetch a specific dataset by its ID. Use when you need detailed information about a particular dataset including configuration, storage, search settings, and content instructions.
-
Fetch Dataset Record
Tool to fetch a specific record from a dataset by its ID. Use when you need to retrieve detailed information about a particular dataset record including its text content, source, and metadata.
-
Fetch Dataset via GraphQL
Tool to fetch a single dataset by ID using GraphQL. Use when you need to retrieve dataset details (name, description, timestamps) via the GraphQL endpoint.
-
Fetch Discord Integration
Tool to fetch a specific Discord integration by its ID. Use when you need detailed information about a particular Discord integration including configuration, bot association, and metadata.
-
Fetch Email Integration
Tool to fetch a specific Email integration by its ID. Use when you need detailed information about a particular Email integration including configuration, bot association, and settings.
-
Fetch Extract Integration
Tool to fetch a specific Extract integration by its ID. Use when you need detailed information about a particular Extract integration including configuration, bot association, request template, and extraction schema.
-
Fetch File
Tool to retrieve detailed metadata about a specific file by its ID. Use when you need file information including name, type, size, and visibility settings. Note: This returns file metadata, not the actual file content.
-
Fetch File (GraphQL)
Tool to fetch a single file by ID using GraphQL. Returns detailed file information including name, description, timestamps, and metadata. Use when you need structured GraphQL response format.
-
Fetch Instagram Integration
Tool to fetch a specific Instagram integration by its ID. Use when you need detailed information about a particular Instagram integration including access token, configuration, and metadata.
-
Fetch MCP Server Integration
Tool to fetch a specific MCP Server integration by its ID. Use when you need detailed information about a particular MCP Server integration including configuration, skillset, and blueprint associations.
-
Fetch Memory
Tool to retrieve detailed information about a specific memory by ID. Use when you need to access the content and metadata of a particular memory entry.
-
Fetch Messenger Integration
Tool to fetch a specific Messenger integration by its ID. Use when you need detailed information about a particular Messenger integration including configuration, bot association, and settings.
-
Fetch Notion Integration
Tool to fetch a specific Notion integration by its ID. Use when you need detailed information about a particular Notion integration including dataset association, sync status, and metadata.
-
Fetch Platform Doc
Tool to fetch a specific platform documentation by its ID. Use when you need to retrieve documentation content for ChatBotKit platform features.
-
Fetch Platform Example
Tool to fetch a specific platform example with full configuration details by its ID. Use when you need to retrieve complete information about a ChatBotKit example including its type, config, and associated metadata.
-
Fetch Platform Manual
Tool to fetch a specific platform manual by its ID. Use when you need documentation or help content for a particular platform feature or resource type (e.g., datasets, skillsets, bots).
-
Fetch Platform Manuals (GraphQL)
Tool to fetch platform manuals using GraphQL query by search query or specific IDs. Use when you need to retrieve documentation manuals for ChatBotKit platform features via GraphQL.
-
Fetch Platform Tutorial
Tool to fetch a specific platform tutorial by its ID. Use when you need to retrieve tutorial content for ChatBotKit platform features.
-
Fetch Platform Tutorials
Tool to fetch platform tutorials by search query or IDs. Use when you need to search for tutorials or retrieve specific tutorials to help with ChatBotKit platform features.
-
Fetch Rating
Tool to retrieve detailed information about a specific rating by ID. Use when you need to access rating details including value, reason, and associated entities.
-
Fetch Secret
Tool to fetch a secret by ID. Use when you need to retrieve detailed information about a specific secret.
-
Fetch Sitemap Integration
Tool to fetch a specific Sitemap integration by its ID. Use when you need detailed information about a particular Sitemap integration including configuration, dataset association, URL patterns, and synchronization…
-
Fetch Skillset
Tool to fetch a specific skillset by its ID. Use when you need detailed information about a particular skillset.
-
Fetch Skillset (GraphQL)
Tool to fetch a single skillset by ID using GraphQL. Use when you need to retrieve skillset details via the GraphQL API.
-
Fetch Skillset Ability
Tool to fetch detailed information about a specific ability from a skillset. Use when you need to retrieve ability configuration, instructions, and associated resources.
-
Fetch Slack Integration
Tool to fetch a specific Slack integration by its ID. Use when you need detailed information about a particular Slack integration including configuration, bot association, and metadata.
-
Fetch Space
Tool to retrieve detailed information about a specific space by ID. Use when you need to access space details including name, description, blueprint, and associated contact.
-
Fetch Support Integration
Tool to fetch a specific Support integration by its ID. Use when you need detailed information about a particular Support integration including configuration, bot association, and metadata.
-
Fetch Task
Tool to retrieve details of a specific task by its ID. Use when you need to check the status, outcome, or configuration of a particular task.
-
Fetch Telegram Integration
Tool to fetch a specific Telegram integration by its ID. Use when you need detailed information about a particular Telegram integration including configuration, bot association, and metadata.
-
Fetch Trigger Integration
Tool to fetch a specific trigger integration by its ID. Use when you need detailed information about a particular trigger integration including configuration, schedule, authentication, and associated bot.
-
Fetch Twilio Integration
Tool to fetch a specific Twilio integration by its ID. Use when you need detailed information about a particular Twilio integration including configuration, bot association, and metadata.
-
Fetch Usage
Tool to fetch account-wide usage statistics including tokens, conversations, messages, and database resources. Use when you need overall usage metrics for billing, monitoring, or analytics purposes.
-
Fetch Usage Series
Tool to fetch usage series data for the last 90 days. Use when you need to analyze token usage, conversation counts, or message counts over time.
-
Fetch WhatsApp Integration
Tool to fetch a specific WhatsApp integration by its ID. Use when you need detailed information about a particular WhatsApp integration including configuration, bot association, and settings.
-
Fetch Widget Integration
Tool to fetch a specific Widget integration by its ID. Use when you need detailed information about a particular Widget integration including configuration, bot association, and widget settings.
-
Generate Report
Tool to generate a specific report with time-series breakdowns. Use when you need usage statistics, event metrics, or analytics data for a specific time period.
-
Generate Reports
Tool to generate multiple reports simultaneously. Use when you need to retrieve analytics, metrics, or statistical data from ChatBotKit. Report IDs can be obtained from the platform report list endpoint.
-
Get Audit Log Export
Tool to export audit log entries showing user actions and system events. Use when you need to retrieve audit records for monitoring, compliance, or security analysis.
-
Get Event Metric Series
Tool to fetch event metric time series data for a specific metric type. Use when you need to retrieve historical metric data points for analytics, monitoring, or reporting purposes.
-
Get Rating Export
Tool to export ratings with pagination support. Use when you need to retrieve and export rating data in bulk for analysis, backup, or migration purposes.
-
Get Rating List
Tool to retrieve a paginated list of ratings. Use when you need to browse, filter, or analyze ratings data.
-
Invoke Trigger Integration
Tool to invoke a trigger integration in ChatBotKit. Use when you need to manually trigger a specific trigger integration.
-
List Audit Logs
Tool to retrieve a paginated list of audit logs. Use when you need to review system activity, security events, or compliance tracking.
-
List Blueprint Resources
Tool to list the resources of a blueprint. Use when you need to retrieve all resources associated with a specific blueprint.
-
List Blueprints
Tool to retrieve a list of blueprints. Use when you need to browse or paginate through available blueprint templates.
-
List Blueprints via GraphQL
Tool to list all blueprints using GraphQL with cursor-based pagination. Use when you need to browse blueprint templates via GraphQL endpoint with edges/node connection pattern.
-
List Bots
Tool to retrieve a paginated list of all bots. Use when you need to browse or manage multiple bots, and iterate pages via cursor.
-
List Bots (GraphQL)
Tool to query bots via GraphQL with pagination support. Use when you need to retrieve a list of bots using the GraphQL API.
-
List Contact Conversations
Tool to retrieve a paginated list of conversations for a specific contact. Use when you need to view all conversations associated with a contact.
-
List Contact Memories
Tool to retrieve a paginated list of memories for a specific contact. Use when you need to browse or access memory entries associated with a contact.
-
List Contact Ratings
Tool to retrieve ratings submitted by a specific contact. Use when you need to monitor conversation quality, identify areas for improvement, and track user satisfaction with AI-generated responses.
-
List Contact Secrets
Tool to retrieve a paginated list of secrets for a specific contact. Use when you need to browse or access secret entries associated with a contact.
-
List Contact Spaces
Tool to retrieve a paginated list of spaces for a specific contact. Use when you need to fetch all spaces associated with a particular contact ID.
-
List Contact Tasks
Tool to retrieve a paginated list of tasks for a specific contact. Use when you need to view all tasks associated with a particular contact.
-
List Contacts
Tool to retrieve a paginated list of contacts. Contacts represent users interacting with bots. Use when you need to browse, filter, or manage multiple contacts.
-
List Contacts with Pagination
Tool to list contacts with full pagination support using GraphQL. Returns contact information including ID, name, email, metadata, and timestamps, along with pagination details. Use when you need to retrieve contacts…
-
List Conversation Messages
Tool to list messages in a conversation with pagination. Use after obtaining a conversation ID to fetch messages page by page.
-
List Conversations
Tool to retrieve a paginated list of conversations. Use when you need to page through conversation history.
-
List Conversations (GraphQL)
Tool to retrieve conversations using GraphQL with cursor-based pagination. Use when you need to list all conversations with Relay-style pagination support.
-
List Dataset Files
Tool to retrieve a list of files in a dataset. Use when you need to browse or paginate through dataset files.
-
List Dataset Records
Tool to list records in a dataset with pagination. Use after obtaining a dataset ID to retrieve all records or paginate through them.
-
List Datasets
Tool to list datasets. Use when you need to browse or paginate through available datasets.
-
List Datasets via GraphQL
Tool to list all datasets using GraphQL with cursor-based pagination. Use when you need to browse datasets via GraphQL endpoint. Supports forward pagination with 'first' and 'after', or backward pagination with 'last'…
-
List Discord Integrations
Tool to retrieve a list of Discord integrations. Use when you need to browse or manage configured Discord integrations and iterate pages via cursor.
-
List Email Integrations
Tool to retrieve a list of email integrations. Use when you need to browse or manage configured email integrations and iterate pages via cursor.
-
List Event Logs
Tool to retrieve a paginated list of event logs. Use when you need to browse system events, audit activity, or analyze event history.
-
List Event Metrics
Tool to list event metrics for the authenticated account. Use when you need to retrieve analytics and monitoring data about platform events.
-
List Extract Integrations
Tool to retrieve a list of Extract integrations. Use when you need to browse or manage configured Extract integrations and iterate pages via cursor.
-
List Files
Tool to retrieve a list of files. Use when you need to browse or paginate through available files that can be attached to datasets.
-
List Files (GraphQL)
Tool to list files using GraphQL query with connection-based pagination. Use when you need to retrieve files via GraphQL endpoint with edges/nodes structure.
-
List Instagram Integrations
Tool to retrieve a list of Instagram integrations. Use when you need to browse or manage configured Instagram integrations and iterate pages via cursor.
-
List Integrations (GraphQL)
Tool to list integrations with pagination using GraphQL query. Use when you need to retrieve multiple integration records with cursor-based pagination support.
-
List Magic Prompts
Tool to retrieve a list of magic prompts. Use when you need to browse or enumerate available magic prompts in the system.
-
List MCP Server Integrations
Tool to retrieve a list of MCP Server integrations. Use when you need to browse or manage configured MCP Server integrations and iterate pages via cursor.
-
List Memories
Tool to retrieve a paginated list of memories. Use when you need to browse or access memory entries across the system.
-
List Messages (GraphQL)
Tool to list messages for one or more conversations using GraphQL. Returns messages in GraphQL connection pattern with edges/node structure. Use when you need to fetch messages across multiple conversations…
-
List Messenger Integrations
Tool to retrieve a list of Messenger integrations. Use when you need to browse or manage configured Messenger integrations and iterate pages via cursor.
-
List Notion Integrations
Tool to retrieve a list of Notion integrations. Use when you need to browse or manage configured Notion integrations and iterate pages via cursor.
-
List Partners
Tool to retrieve a list of all partner accounts associated with the main account. Use when you need to view or manage all sub-accounts under your partner umbrella.
-
List Platform Abilities
Tool to retrieve a list of platform abilities. Use when you need to browse available abilities or capabilities provided by the platform.
-
List Platform Actions
Tool to retrieve a paginated list of platform actions. Use when you need to browse available actions or discover what actions are supported by the platform.
-
List Platform Docs
Tool to retrieve a list of platform documentation items. Use when you need to browse available documentation or discover what documentation is available for the ChatBotKit platform.
-
List Platform Examples
Tool to retrieve a list of platform examples from ChatBotKit. Use when you need to browse available example templates and resources.
-
List Platform Guides
Tool to retrieve a list of platform guides. Use when you need to browse available guides or tutorials for the platform.
-
List Platform Manuals
Tool to retrieve a list of platform manuals. Use when you need to browse available documentation and help resources for the ChatBotKit platform.
-
List Platform Models
Tool to retrieve a list of available platform models. Use when you need to browse AI models available on the platform.
-
List Platform Reports
Tool to retrieve a list of available platform reports. Use when you need to view or analyze system-generated reports.
-
List Platform Secrets
Tool to retrieve a paginated list of platform secrets. Use when you need to browse or access secret entries at the platform level.
-
List Platform Tutorials
Tool to retrieve a list of platform tutorials. Use when you need to browse or discover available tutorials for learning how to use the ChatBotKit platform.
-
List Policies
Tool to retrieve a list of policies. Use when you need to browse available policies or filter by metadata.
-
List Portals
Tool to retrieve a list of portals. Use when you need to browse or paginate through available portals.
-
List Portals (GraphQL)
Tool to retrieve a paginated list of portals using GraphQL. Use when you need to query portals via GraphQL with cursor-based pagination.
-
List Secrets
Tool to retrieve a list of secrets. Use when you need to browse or access credentials for external service integrations.
-
List Secrets via GraphQL
Tool to list all secrets using GraphQL with cursor-based pagination. Use when you need to retrieve secrets stored in ChatBotKit. Supports forward pagination with 'first' and 'after', or backward pagination with 'last'…
-
List Sitemap Integrations
Tool to retrieve a list of Sitemap integrations. Use when you need to browse or manage configured Sitemap integrations and iterate pages via cursor.
-
List Skillset Abilities
Tool to retrieve a list of abilities within a specific skillset. Use when you need to enumerate abilities for a given skillset.
-
List Skillsets
Tool to retrieve a list of all skillsets available in the system. Use when you need to enumerate existing skillsets.
-
List Skillsets (GraphQL)
Tool to list skillsets using GraphQL query with connection-based pagination. Use when you need to retrieve skillsets via GraphQL endpoint with edges/nodes structure.
-
List Slack Integrations
Tool to retrieve a list of Slack integrations. Use when you need to browse or manage configured Slack integrations and iterate pages via cursor.
-
List Spaces
Tool to retrieve a paginated list of spaces. Spaces are containers for organizing bot resources. Use when you need to browse or manage multiple spaces.
-
List Support Integrations
Tool to retrieve a list of support integrations. Use when you need to browse or manage configured support integrations and iterate pages via cursor.
-
List Tasks
Tool to retrieve a paginated list of tasks. Use when you need to view all tasks, optionally filtered by bot, contact, status, or metadata.
-
List Teams
Tool to retrieve a paginated list of teams. Use when you need to browse or manage multiple teams.
-
List Telegram Integrations
Tool to retrieve a list of Telegram integrations. Use when you need to browse or manage configured Telegram integrations and iterate pages via cursor.
-
List Tokens
Tool to retrieve a list of all API tokens. Use when you need to audit or manage existing tokens.
-
List Twilio Integrations
Tool to retrieve a list of Twilio integrations. Use when you need to browse or manage configured Twilio integrations and iterate pages via cursor.
-
List WhatsApp Integrations
Tool to retrieve a list of WhatsApp integrations. Use when you need to browse or manage configured WhatsApp integrations and iterate pages via cursor.
-
List Widget Integrations
Tool to retrieve a list of widget integrations. Use when you need to browse or manage configured widget integrations and iterate pages via cursor.
-
Publish Channel Message
Publish a message to a ChatBotKit channel. Use this action when you need to send messages to a specific channel identified by its channel ID.
-
Search Bot Memory
Tool to search memories for a specific bot. Use when you need to retrieve stored memories that match a keyword or phrase.
-
Search Contact Memory
Tool to search memories for a specific contact by keyword or phrase. Use when you need to find specific information stored in a contact's memory.
-
Search Dataset
Tool to search a dataset for records matching a given search query. Uses semantic search for finding relevant records. Use when you need to retrieve stored data from a dataset based on a keyword or phrase.
-
Search Memory
Tool to search memories for records matching a given search query. Use when you need to find specific memories, optionally filtered by bot or contact.
-
Search Platform Abilities
Tool to search platform abilities using semantic similarity. Use when you need to find relevant abilities or tools based on a query.
-
Search Platform Docs
Tool to search platform documentation using semantic similarity. Use when you need to find relevant documentation, guides, or help articles based on a query.
-
Search Platform Docs (GraphQL)
Tool to search platform documentation by search query via GraphQL and retrieve docs with id, name, excerpt, and link. Use when you need to find relevant ChatBotKit documentation using the GraphQL API.
-
Search Platform Examples
Tool to search platform examples using semantic similarity. Use when you need to find relevant examples, templates, or code snippets from the platform's example library.
-
Search Platform Guides
Tool to search platform guides using semantic similarity. Use when you need to find relevant documentation, tutorials, or guides based on a search query.
-
Search Platform Manuals
Tool to search platform manuals using semantic similarity. Use when you need to find documentation, guides, or help resources related to a specific topic or question.
-
Search Platform Secrets
Tool to search platform secrets using semantic similarity. Use when you need to find secrets that match a particular topic or keyword using intelligent matching.
-
Search Platform Tutorials
Tool to search platform tutorials using semantic similarity. Use when you need to find relevant tutorials, documentation, or guides on specific topics.
-
Setup Email Integration
Tool to setup an email integration in ChatBotKit. Use when you need to activate or configure an existing email integration for use with a bot.
-
Setup Trigger Integration
Tool to setup a trigger integration in ChatBotKit. Use when you need to activate or configure an existing trigger integration for use with a bot.
-
Setup Twilio Integration
Tool to setup a Twilio integration in ChatBotKit. Use when you need to activate or configure an existing Twilio integration for use with a bot.
-
Setup WhatsApp Integration
Tool to setup a WhatsApp integration in ChatBotKit. Use when you need to activate or configure an existing WhatsApp integration for use with a bot.
-
Setup Widget Integration
Tool to setup a Widget integration in ChatBotKit. Use when you need to activate or configure an existing Widget integration for use with a bot.
-
Subscribe to Channel
Tool to subscribe to messages from a ChatBotKit channel. Use this when you need to monitor and receive messages from a specific channel. The subscription works by first replaying historical messages (if historyLength…
-
Sync Dataset File
Tool to sync a dataset file. Use when you need to synchronize a file within a dataset to ensure its content is up-to-date and available for use by the bot.
-
Sync File
Tool to sync a file. Use when you need to synchronize a file to ensure its content is up-to-date and available for use.
-
Sync Notion Integration
Tool to sync a Notion integration with ChatBotKit. Use when you need to manually trigger synchronization of content between Notion pages and the associated ChatBotKit dataset.
-
Sync Sitemap Integration
Tool to sync a sitemap integration. Use when you need to trigger an immediate sync of a sitemap integration to refresh the dataset with the latest content from the website.
-
Synthesize Conversation Message
Tool to convert a conversation message into speech audio. Use when you need to synthesize text from a message into audio format.
-
Trigger Extract Integration
Tool to trigger an extract integration on historic conversations in ChatBotKit. Use when you need to process past conversations with an extract integration, either by specifying a sample size or specific conversation…
-
Trigger Support Integration
Tool to trigger a support integration on historic conversations in ChatBotKit. Use when you need to process past conversations with a support integration, either by specifying a sample size or specific conversation IDs.
-
Trigger Task
Tool to trigger execution of a background task. Use when you need to manually start or restart a task.
-
Update Blueprint
Tool to update an existing blueprint. Use when you need to modify blueprint properties such as name, description, visibility, or metadata.
-
Update Blueprint (GraphQL)
Tool to update an existing blueprint using GraphQL mutation. Use when you need to modify a blueprint's properties via the GraphQL API.
-
Update Bot
Tool to update an existing bot's configuration and properties. Use when you need to modify a bot's name, description, model, backstory, associated datasets/skillsets, or other settings.
-
Update Bot (GraphQL)
Tool to update an existing bot using GraphQL mutation. Use when you need to modify a bot's properties via the GraphQL API.
-
Update Contact
Tool to update an existing contact's information. Use when you need to modify contact details like email, nickname, phone number, or preferences.
-
Update Conversation
Tool to update an existing conversation's properties. Use when you need to modify conversation metadata, bot configuration, or associated resources like contacts, tasks, or spaces.
-
Update Conversation Message
Tool to update an existing message in a conversation. Use this to modify the text, entities, or type of a previously created message.
-
Update Dataset
Tool to update an existing dataset's configuration and properties. Use when you need to modify a dataset's name, description, visibility, search settings, or other configuration options.
-
Update Dataset (GraphQL)
Tool to update an existing dataset using GraphQL mutation. Use when you need to modify a dataset's properties such as name, description, search configuration, visibility, or metadata via the GraphQL API endpoint.
-
Update Dataset Record
Tool to update an existing record in a dataset. Use when you need to modify text data or metadata in an existing dataset record.
-
Update Discord Integration
Tool to update an existing Discord integration's configuration. Use when you need to modify Discord integration settings such as bot token, session duration, contact collection, or associated bot/blueprint.
-
Update Email Integration
Tool to update an existing Email integration's configuration and properties. Use when you need to modify an Email integration's settings such as allowed sender emails, attachment handling, contact collection, or…
-
Update Extract Integration
Tool to update an existing Extract integration's configuration. Use when you need to modify an Extract integration's model, extraction request, schema, associated bot, or other settings.
-
Update File
Tool to update an existing file's metadata and properties. Use when you need to modify a file's name, description, visibility, or other configuration settings.
-
Update File (GraphQL)
Tool to update an existing file using GraphQL mutation. Use when you need to modify a file's name, description, visibility, or other properties via the GraphQL API endpoint.
-
Update Instagram Integration
Tool to update an existing Instagram integration's configuration. Use when you need to modify Instagram integration settings such as access token, session duration, contact collection, attachments, or associated…
-
Update MCP Server Integration
Tool to update an existing MCP Server integration. Use when you need to modify properties of an MCP (Model Context Protocol) Server integration such as name, description, associated skillset or blueprint, or metadata.
-
Update Memory
Tool to update an existing memory's text or associations. Use when you need to modify memory content or change its bot/contact associations.
-
Update Messenger Integration
Tool to update an existing Messenger integration's configuration. Use when you need to modify Messenger integration settings such as access token, session duration, attachments, or associated bot/blueprint.
-
Update Notion Integration
Tool to update an existing Notion integration's configuration and properties. Use when you need to modify a Notion integration's settings such as sync schedule, token, dataset association, or expiration settings.
-
Update Partner User
Tool to update an existing partner user's information. Use when you need to modify partner user details like email, profile image, or resource limits.
-
Update Rating
Tool to update an existing rating by ID. Use when you need to modify a rating's value or associated metadata. Ratings track user feedback (upvotes/downvotes) for contacts, bots, conversations, and messages.
-
Update Secret
Tool to update an existing secret's configuration and properties. Use when you need to modify a secret's name, description, value, type, or other settings.
-
Update Secret (GraphQL)
Tool to update an existing secret via GraphQL mutation. Use when you need to modify a secret's properties using the GraphQL API.
-
Update Sitemap Integration
Tool to update an existing Sitemap integration's configuration. Use when you need to modify sitemap URL, glob patterns, sync schedule, dataset association, or crawling settings like JavaScript rendering and CSS…
-
Update Skillset
Tool to update an existing skillset's configuration and properties. Use when you need to modify a skillset's name, description, visibility, or other settings.
-
Update Skillset (GraphQL)
Tool to update an existing skillset using GraphQL mutation. Use when you need to modify a skillset's properties such as name, description, or abilities via the GraphQL API.
-
Update Skillset Ability
Tool to update an existing ability within a skillset. Use when you need to modify ability properties like name, description, instruction, or associated resources.
-
Update Slack Integration
Tool to update an existing Slack integration's configuration. Use when you need to modify Slack integration settings such as bot token, signing secret, session duration, contact collection, ratings, or associated…
-
Update Space
Tool to update an existing space's configuration and properties. Use when you need to modify a space's name, description, associated blueprint, contact, or other settings.
-
Update Support Integration
Tool to update an existing Support integration's configuration and properties. Use when you need to modify a Support integration's email, name, description, or associated bot/blueprint.
-
Update Task
Tool to update an existing task's configuration and properties. Use when you need to modify a task's schedule, bot/contact associations, or execution parameters.
-
Update Telegram Integration
Tool to update an existing Telegram integration's configuration and properties. Use when you need to modify a Telegram integration's settings such as bot token, session duration, attachment handling, or associated…
-
Update Trigger Integration
Tool to update an existing Trigger integration's configuration. Use when you need to modify Trigger integration settings such as name, description, metadata, associated bot/blueprint, or authentication settings.
-
Update Trigger Integration (GraphQL)
Tool to update trigger integration configuration and settings using GraphQL mutation. Use when you need to modify a trigger integration's properties such as name, description, metadata, authentication settings, or…
-
Update Twilio Integration
Tool to update an existing Twilio integration's configuration. Use when you need to modify Twilio integration settings such as name, description, session duration, contact collection, or associated bot/blueprint.
-
Update WhatsApp Integration
Tool to update an existing WhatsApp integration's configuration. Use when you need to modify WhatsApp integration settings such as access token, phone number ID, session duration, contact collection, or associated…
-
Update Widget Integration
Tool to update an existing Widget integration's configuration. Use when you need to modify widget settings such as title, theme, placeholder text, auto-scroll behavior, or other display and functionality options.
-
Upload Conversation Attachment
Upload a file as a conversation attachment in ChatBotKit. This action creates an attachment record and returns upload details. Use when you need to attach files (documents, images, etc.) to a conversation for the bot…
-
Upload File
Tool to upload content to an existing file resource in ChatBotKit. Use when you need to populate a file resource with actual file data.
-
Upsert Conversation Contact
Tool to upsert (create or update) contact information for a conversation in ChatBotKit. Use when you need to associate contact details like email, phone, or nickname with a conversation.
-
Upvote Bot
Tool to upvote a bot in ChatBotKit. Use when you want to endorse or rate a bot positively, providing optional feedback on why the bot deserves recognition.
-
Upvote Conversation
Tool to upvote a conversation in ChatBotKit. Use when you want to endorse or rate a conversation positively, providing optional feedback on quality.
-
Upvote Conversation Message
Tool to upvote a conversation message in ChatBotKit. Use when you want to endorse or rate a specific message positively within a conversation.
-
Verify Secret
Tool to verify a secret in ChatBotKit. Use when you need to check the authentication status of a secret credential.
Setup
Connect Chatbotkit in Hookshot™
Pick a scope, then confirm what can start a Protege and what it can do.
Trigger Access
What can start a Protege from this app.
Tool Access
What a Protege can do after it starts.
Connection scope
Prefer team for production.
Personal
Tied to one user—only when the workflow needs their account.
Chat
Team-scoped for supported chat surfaces.
Build with us
See Hookshot™ in your stack.
Request early access or book a live walkthrough with the team.
