Skip to docs navigation

ChatBotKit integration guide

Verified

How to connect ChatBotKit to WEXTL and use its 4 triggers and 145 actions in your workflows. About ChatBotKit: Build and run AI agents: chat with bots, manage datasets, skillsets, contacts and tasks, and watch new conversations in ChatBotKit.

  • 4 triggers
  • 60 searches
  • 85 actions
  • Polling
  • Auth: API key

AI-assisted documentation31 min read

This documentation is compiled from our integration source code, internal specs for ChatBotKit, its official API documentation and anonymized requests logs we collect from our support team[2].

Open ChatBotKit on WEXTL →
  • ChatBotKit
  • WEXTL
  • Braintrust
  • Dust
  • AgentX
  • CustomGPT
  • BigML
  • AWS Transcribe
  • Botsonic
  • Airtop
  • Anthropic's Claude
  • DeepL
  • AWS Comprehend
  • Cody AI
  • Alibaba Cloud (Qwen)
  • Amberscript
  • AWS Rekognition
  • Apiframe
  • Camb AI
  • AWS Textract
  • AltText AI
  • Bigjpg
  • Dappier
  • DeepSeek
  • Bolna
  • ElevenLabs
  • Cartesia
  • CALL-E
  • DocsBot
  • Deepgram
  • Docparser
  • API KeypasswordRequired

    In ChatBotKit open your account settings, then API Keys, create a key and copy it. Keep it secret.[1]

  1. Log in to your WEXTL account, add the ChatBotKit node module to your workflow, and click Create new credential.
  2. Optional: In the Credential name field, enter a name for the credential.
  3. Enter the authentication credentials you copied from your ChatBotKit account, or follow the on-screen instructions to create the credential.
  4. If prompted, authenticate your account and confirm access.
  5. If you want to make changes to your credential in the future, follow the steps in Manage credentials →

Watch Event Logs

TriggerScheduled read of new log entries.
Input fields[3]
FieldType
Event Typetext
LimitRequired
number
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Typetext
Conversation Idtext

29other output fields

Watch New Contacts

TriggerSchedule-based check for new contacts.
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Fingerprinttext
Emailtext

4other output fields

Watch New Conversations

TriggerScheduled detection of new chats.
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Bot Idtext
Modeltext

9other output fields

Watch New Messages

TriggerScheduled check for fresh chat messages.
Input fields[3]
FieldType
ConversationRequired
choice
LimitRequired
number
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Typetext
Texttext

Download a File

SearchFile content from ChatBotKit storage.
Input fields[3]
FieldType
FileRequired
choice
Output fields[3]
FieldType
Filefile
File Nametext
Content Typetext

Download a Space File

SearchFile content pulled from a space path.
Input fields[3]
FieldType
SpaceRequired
choice
PathRequired
text
Output fields[3]
FieldType
Filefile
File Nametext
Content Typetext

Find or Create a Contact

ActionUpsert for contacts keyed by fingerprint.
Input fields[3]
FieldType
Nametext
Descriptiontext
Metaarray
Rowobject
FingerprintRequired
text
Emailtext
Phonetext
Nicknametext
Preferencestext

1other input field

Output fields[3]
FieldType
Idtext

Get a Blueprint

SearchAlias and metadata of one blueprint.
Input fields[3]
FieldType
BlueprintRequired
choice
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Contact Idtext

1other output field

Get a Bot

SearchName and description of a single bot.
Input fields[3]
FieldType
BotRequired
choice
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Modeltext

9other output fields

Get a Contact

SearchSaved profile of a single contact.
Input fields[3]
FieldType
ContactRequired
choice
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Fingerprinttext
Emailtext

4other output fields

Get a Conversation

SearchBot, contact and expiry details of one conversation.
Input fields[3]
FieldType
ConversationRequired
choice
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Bot Idtext
Modeltext

8other output fields

Get a Conversation Message

SearchSingle message inside a chat.
Input fields[3]
FieldType
ConversationRequired
choice
Message IDRequired
text
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Typetext
Texttext

Get a Dataset

SearchAlias, name and description of a dataset.
Input fields[3]
FieldType
DatasetRequired
choice
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

10other output fields

Get a Dataset Record

SearchSingle dataset entry with its source text.
Input fields[3]
FieldType
DatasetRequired
choice
Record IDRequired
text
Output fields[3]
FieldType
Idtext
Created Atnumber
Updated Atnumber
Texttext
Sourcetext

Get a File

SearchFile record without its content.
Input fields[3]
FieldType
FileRequired
choice
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

2other output fields

Get a Memory

SearchText and expiry of one stored memory.
Input fields[3]
FieldType
Memory IDRequired
text
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Contact Idtext
Bot Idtext

2other output fields

Get a Secret

SearchAlias and name of a stored credential.
Input fields[3]
FieldType
SecretRequired
choice
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

5other output fields

Get a Skillset

SearchSummary of a bot ability group.
Input fields[3]
FieldType
SkillsetRequired
choice
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

3other output fields

Get a Skillset Ability

SearchSummary of a single bot ability.
Input fields[3]
FieldType
SkillsetRequired
choice
Ability IDRequired
text
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

7other output fields

Get a Space

SearchDetails of a storage space.
Input fields[3]
FieldType
SpaceRequired
choice
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

1other output field

Get a Task

SearchDetails of a bot task.
Input fields[3]
FieldType
TaskRequired
choice
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext
Contact Idtext

12other output fields

Get a Trigger Integration

SearchSummary of a bot trigger setup.
Input fields[3]
FieldType
Trigger IntegrationRequired
choice
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

9other output fields

Get a User

SearchProfile of one sub-account user.
Input fields[3]
FieldType
UserRequired
choice
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Imagetext
Emailtext

1other output field

Get an Extract Integration

SearchSetup summary of an extraction integration.
Input fields[3]
FieldType
Extract IntegrationRequired
choice
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

4other output fields

Get Speech for a Conversation Message

ActionText-to-speech for a chat message.
Input fields[3]
FieldType
ConversationRequired
choice
Message IDRequired
text
Output fields[3]
FieldType
Idtext

Get the Next Conversation Reply

ActionTriggers the pending bot answer in a chat.
Input fields[3]
FieldType
ConversationRequired
choice
Functions (JSON)text
Extensions (JSON)text
Output fields[3]
FieldType
Idtext
Texttext
Usageobject
Tokennumber

Get the Usage of a Bot

SearchToken and message totals for a bot.
Input fields[3]
FieldType
BotRequired
choice
Fromdate
Todate
Output fields[3]
FieldType
Tokensnumber
Conversationsnumber
Messagesnumber

Get the Usage of a Conversation

SearchConsumption figures for one conversation.
Input fields[3]
FieldType
ConversationRequired
choice
Fromdate
Todate
Output fields[3]
FieldType
Tokensnumber
Messagesnumber

Get the Usage Over Time

SearchUsage figures split by period.
Output fields[3]
FieldType
Tokensarray
Conversationsarray
Messagesarray

Get Usage

SearchTotals across the whole account.
Output fields[3]
FieldType
Tokensnumber
Conversationsnumber
Messagesnumber
Databaseobject
Datasetsnumber
Recordsnumber
Skillsetsnumber
Abilitiesnumber
Filesnumber
Usersnumber

List Blueprints

SearchBlueprints with their aliases and names.
Input fields[3]
FieldType
Contactchoice
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Contact Idtext

1other output field

List Bots

SearchChatbots with aliases and names.
Input fields[3]
FieldType
Contactchoice
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Modeltext

9other output fields

List Contact Conversations

SearchChat threads started by a single contact.
Input fields[3]
FieldType
ContactRequired
choice
Orderchoice
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Bot Idtext
Modeltext

7other output fields

List Contact Memories

SearchNotes remembered about one contact.
Input fields[3]
FieldType
ContactRequired
choice
Orderchoice
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Bot Idtext
Texttext

List Contact Secrets

SearchCredentials stored for a single contact.
Input fields[3]
FieldType
ContactRequired
choice
Orderchoice
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Typetext

List Contact Tasks

SearchAutonomous jobs of a single contact.
Input fields[3]
FieldType
ContactRequired
choice
Orderchoice
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Contact Idtext
Bot Idtext

10other output fields

List Contacts

SearchContacts that have talked to your bots.
Input fields[3]
FieldType
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Fingerprinttext
Emailtext

4other output fields

List Conversation Attachments

SearchFiles that belong to a chat.
Input fields[3]
FieldType
ConversationRequired
choice
Orderchoice
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Typetext
Sizenumber

List Conversation Messages

SearchMessages of a chat in sequence.
Input fields[3]
FieldType
ConversationRequired
choice
Orderchoice
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Typetext
Texttext

List Conversations

SearchChats across your account.
Input fields[3]
FieldType
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Bot Idtext
Modeltext

9other output fields

List Dataset Files

SearchAttached files of a dataset, sortable by order.
Input fields[3]
FieldType
DatasetRequired
choice
Orderchoice
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Visibilitytext

List Dataset Records

SearchEntries stored in a dataset.
Input fields[3]
FieldType
DatasetRequired
choice
Orderchoice
Limitnumber
Output fields[3]
FieldType
Idtext
Created Atnumber
Updated Atnumber
Texttext
Sourcetext

List Datasets

SearchDatasets with their search settings.
Input fields[3]
FieldType
Contactchoice
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

10other output fields

List Event Logs

SearchAccount activity log entries.
Input fields[3]
FieldType
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Typetext
Conversation Idtext

29other output fields

List Extract Integration Items

SearchExtracted results of an integration.
Input fields[3]
FieldType
Extract IntegrationRequired
choice
Orderchoice
Limitnumber
Output fields[3]
FieldType
Idtext
Extract Integration Idtext
Conversation Idtext
Datatext
Created Attext
Updated Attext

List Extract Integrations

SearchIntegrations that extract data from chats.
Input fields[3]
FieldType
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

4other output fields

List Files

SearchFiles in ChatBotKit storage.
Input fields[3]
FieldType
Contactchoice
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

2other output fields

List Memories

SearchNotes your bots remember.
Input fields[3]
FieldType
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Contact Idtext
Bot Idtext

2other output fields

List Models

SearchModels available to bots.
Input fields[3]
FieldType
Typechoice
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Typetext
Defaultboolean

5other output fields

List Secrets

SearchCredentials stored for abilities.
Input fields[3]
FieldType
Contactchoice
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

5other output fields

List Skillset Abilities

SearchAbilities that bots can call from a skillset.
Input fields[3]
FieldType
SkillsetRequired
choice
Orderchoice
Limitnumber
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

7other output fields

List Skillsets

SearchGroups of abilities for bots.
Input fields[3]
FieldType
Contactchoice
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

3other output fields

List Space Files

SearchFolder listing of a space.
Input fields[3]
FieldType
SpaceRequired
choice
PathRequired
text
Recursiveboolean
Output fields[3]
FieldType
Itemsarray
Next Tokentext

List Spaces

SearchFile storage areas in the account.
Input fields[3]
FieldType
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

1other output field

List Task Executions

SearchRun history of a task.
Input fields[3]
FieldType
TaskRequired
choice
Statuschoice
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Task Idtext
Conversation Idtext

7other output fields

List Tasks

SearchAutonomous jobs across the account.
Input fields[3]
FieldType
Blueprintchoice
Botchoice
Contactchoice
Statuschoice
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext
Contact Idtext

12other output fields

List Teams

SearchTeams that exist for the account.
Input fields[3]
FieldType
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber

List Trigger Integrations

SearchIntegrations that start bots.
Input fields[3]
FieldType
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Blueprint Idtext

9other output fields

List Usage Records

SearchUsage entries with their Type and Count.
Input fields[3]
FieldType
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Typetext
Countnumber

9other output fields

List Users

SearchSub-account users with their profile fields.
Input fields[3]
FieldType
Orderchoice
Metadata Filterarray
Rowobject
Limitnumber
Output fields[3]
FieldType
Nametext
Descriptiontext
Metatext
Idtext
Created Atnumber
Updated Atnumber
Imagetext
Emailtext

1other output field

Search a Dataset

SearchFinds matching entries in a dataset.
Input fields[3]
FieldType
DatasetRequired
choice
SearchRequired
text
Filterarray
Rowobject
Output fields[3]
FieldType
Idtext
Recordsarray

Search Bot Memory

SearchMemory entries that match a search phrase.
Input fields[3]
FieldType
BotRequired
choice
SearchRequired
text
Output fields[3]
FieldType
Itemsarray

Search Contact Memory

SearchMatching saved notes of one contact.
Input fields[3]
FieldType
ContactRequired
choice
SearchRequired
text
Output fields[3]
FieldType
Itemsarray

Search Memories

SearchAccount-wide lookup of remembered notes.
Input fields[3]
FieldType
SearchRequired
text
Contactchoice
Botchoice
Output fields[3]
FieldType
Itemsarray

Answer Questions About a State

ActionQuestion answering against a described state.
Input fields[3]
FieldType
Modelchoice
StateRequired
text
Questionsarray
Rowobject
Output fields[3]
FieldType
Answerstext
Usageobject
Modeltext
Input Tokensnumber
Output Tokensnumber

Attach a File to a Dataset

ActionConnects a stored file with a dataset.
Input fields[3]
FieldType
DatasetRequired
choice
FileRequired
choice
Typechoice
Output fields[3]
FieldType
Idtext

Cancel a Task

ActionStops one ChatBotKit task from running.
Input fields[3]
FieldType
TaskRequired
choice
Output fields[3]
FieldType
Idtext

Cancel a Task Execution

ActionAborts a single in-flight task run.
Input fields[3]
FieldType
TaskRequired
choice
Task Execution IDRequired
text
Output fields[3]
FieldType
Idtext
Task Idtext

Compact a Conversation

ActionSummary of one saved chat.
Input fields[3]
FieldType
ConversationRequired
choice
Output fields[3]
FieldType
Idtext
Texttext
Usageobject
Tokennumber

Compact Messages into a Summary

ActionOne-off summary of a message list.
Input fields[3]
FieldType
Botchoice
Modelchoice
Backstorytext
Datasetchoice
Skillsetchoice
Privacyboolean
Moderationboolean
MessagesRequired
array
Messageobject

1other input field

Output fields[3]
FieldType
Texttext
Usageobject
Tokennumber

Complete a Chat

ActionSingle stateless chat reply.
Input fields[3]
FieldType
MessagesRequired
array
Messageobject
Botchoice
Modelchoice
Backstorytext
Datasetchoice
Skillsetchoice
Privacyboolean
Moderationboolean

5other input fields

Output fields[3]
FieldType
Texttext
Usageobject
Tokennumber
Endobject
Reasontext

Continue a Chat in the Background

ActionBackground reply for an existing conversation.
Input fields[3]
FieldType
ConversationRequired
choice
Texttext
Entities (JSON)text
Functions (JSON)text
Extensions (JSON)text
Limits (JSON)text
Channel Idtext
Output fields[3]
FieldType
Channel Idtext

Create a Blueprint

ActionResource container for bots and datasets.
Input fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Contactchoice
Visibilitychoice
Output fields[3]
FieldType
Idtext

Create a Bot

ActionNew chatbot with its model and knowledge.
Input fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Modelchoice
Backstorytext
Datasetchoice
Skillsetchoice

6other input fields

Output fields[3]
FieldType
Idtext

Create a Bot Session

ActionTime-limited session token for a bot.
Input fields[3]
FieldType
BotRequired
choice
Session Length (seconds)number
Messagesarray
Messageobject
Metaarray
Rowobject
Output fields[3]
FieldType
Idtext
Conversation Idtext
Tokentext
Expires Atnumber
Messagesarray

Create a Chat Completion

ActionOpenAI-style chat completion.
Input fields[3]
FieldType
ModelRequired
choice
MessagesRequired
array
Messageobject
Temperaturenumber
Max Tokensnumber
Extra Settings (JSON)text
Output fields[3]
FieldType
Idtext
Objecttext
Choicesarray
Usageobject
Prompt tokensnumber
Completion tokensnumber
Total tokensnumber

Create a Contact

ActionContact stored with identifying details.
Input fields[3]
FieldType
Nametext
Descriptiontext
Metaarray
Rowobject
Fingerprinttext
Emailtext
Phonetext
Nicknametext
Preferencestext

1other input field

Output fields[3]
FieldType
Idtext

Create a Conversation

ActionNew empty or seeded conversation.
Input fields[3]
FieldType
Nametext
Descriptiontext
Metaarray
Rowobject
Botchoice
Modelchoice
Backstorytext
Datasetchoice
Skillsetchoice

6other input fields

Output fields[3]
FieldType
Idtext
Messagesarray

Create a Conversation Message

ActionStores a chosen kind of message in a chat.
Input fields[3]
FieldType
ConversationRequired
choice
Nametext
Descriptiontext
Metaarray
Rowobject
TypeRequired
choice
TextRequired
text
Entities (JSON)text
Output fields[3]
FieldType
Idtext
Entitiesarray

Create a Conversation Session

ActionClient token for continuing a conversation.
Input fields[3]
FieldType
ConversationRequired
choice
Session Length (seconds)number
Output fields[3]
FieldType
Idtext
Tokentext
Expires Atnumber

Create a Dataset

ActionSearchable store of text for bots.
Input fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Rerankertext
Record Max Tokensnumber

7other input fields

Output fields[3]
FieldType
Idtext

Create a Dataset Record

ActionAdds one text entry to a dataset.
Input fields[3]
FieldType
DatasetRequired
choice
TextRequired
text
Sourcetext
Metaarray
Rowobject
Output fields[3]
FieldType
Idtext

Create a File

ActionFile placeholder awaiting an upload.
Input fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Visibilitychoice
Output fields[3]
FieldType
Idtext

Create a Memory

ActionRemembered note for later bot answers.
Input fields[3]
FieldType
Nametext
Descriptiontext
Metaarray
Rowobject
Contactchoice
Botchoice
TextRequired
text
Expires Atnumber
Output fields[3]
FieldType
Idtext

Create a Secret

ActionStored credential for abilities.
Input fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Kindchoice
Typechoice

3other input fields

Output fields[3]
FieldType
Idtext

Create a Skillset

ActionContainer of bot abilities.
Input fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Visibilitychoice
Statechoice
Output fields[3]
FieldType
Idtext

Create a Skillset Ability

ActionCapability entry for a skillset, linked to resources.
Input fields[3]
FieldType
SkillsetRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Linked Secret Idchoice
Linked File Idchoice

5other input fields

Output fields[3]
FieldType
Idtext

Create a Space

ActionStorage area for bot files and uploads.
Input fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Output fields[3]
FieldType
Idtext

Create a Task

ActionScheduled bot job with limits.
Input fields[3]
FieldType
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Botchoice
Scheduletext
Timezonetext

6other input fields

Output fields[3]
FieldType
Idtext

Create a Trigger Integration

ActionScheduled or external bot trigger.
Input fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Botchoice
Authenticateboolean
Scheduletext

3other input fields

Output fields[3]
FieldType
Idtext

Create a User

ActionNew sub-account user.
Input fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Imagetext
Emailtext
Limits (JSON)text
Output fields[3]
FieldType
Idtext

Create a User Session

ActionShort-lived login token for a sub-account user.
Input fields[3]
FieldType
UserRequired
choice
Session Length (seconds)number
Config (JSON)text
Output fields[3]
FieldType
Idtext
Tokentext
Expires Atnumber

Create an Extract Integration

ActionStructured data extraction from conversations.
Input fields[3]
FieldType
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Botchoice
Schemaarray
Rowobject
Requesttext

1other input field

Output fields[3]
FieldType
Idtext

Delete a Blueprint

ActionBlueprint removal with an option to include its resources.
Input fields[3]
FieldType
BlueprintRequired
choice
Delete Resourcesboolean
Output fields[3]
FieldType
Idtext

Delete a Bot

ActionResponds with the Id of the removed bot.
Input fields[3]
FieldType
BotRequired
choice
Output fields[3]
FieldType
Idtext

Delete a Contact

ActionClears one saved contact from the account.
Input fields[3]
FieldType
ContactRequired
choice
Output fields[3]
FieldType
Idtext

Delete a Conversation

ActionClears one chat thread from the account.
Input fields[3]
FieldType
ConversationRequired
choice
Output fields[3]
FieldType
Idtext

Delete a Conversation Message

ActionClears a single message from a chat.
Input fields[3]
FieldType
ConversationRequired
choice
Message IDRequired
text
Output fields[3]
FieldType
Idtext

Delete a Dataset

ActionReturns the Id of the deleted dataset.
Input fields[3]
FieldType
DatasetRequired
choice
Output fields[3]
FieldType
Idtext

Delete a Dataset Record

ActionRemoves a single stored text entry.
Input fields[3]
FieldType
DatasetRequired
choice
Record IDRequired
text
Output fields[3]
FieldType
Idtext

Delete a File

ActionRemoves one stored file from storage.
Input fields[3]
FieldType
FileRequired
choice
Output fields[3]
FieldType
Idtext

Delete a Memory

ActionForgets a single stored fact.
Input fields[3]
FieldType
Memory IDRequired
text
Output fields[3]
FieldType
Idtext

Delete a Secret

ActionClears a credential used by abilities.
Input fields[3]
FieldType
SecretRequired
choice
Output fields[3]
FieldType
Idtext

Delete a Skillset

ActionClears a group of bot abilities.
Input fields[3]
FieldType
SkillsetRequired
choice
Output fields[3]
FieldType
Idtext

Delete a Skillset Ability

ActionRemoves a single callable capability.
Input fields[3]
FieldType
SkillsetRequired
choice
Ability IDRequired
text
Output fields[3]
FieldType
Idtext

Delete a Space

ActionClears a file storage area.
Input fields[3]
FieldType
SpaceRequired
choice
Output fields[3]
FieldType
Idtext

Delete a Space File

ActionFile or folder removal from a space.
Input fields[3]
FieldType
SpaceRequired
choice
PathRequired
text
Recursiveboolean
Output fields[3]
FieldType
Pathtext

Delete a Task

ActionClears an autonomous bot job.
Input fields[3]
FieldType
TaskRequired
choice
Output fields[3]
FieldType
Idtext

Delete a Trigger Integration

ActionClears a scheduled bot trigger.
Input fields[3]
FieldType
Trigger IntegrationRequired
choice
Output fields[3]
FieldType
Idtext

Delete a User

ActionClears one user from the account.
Input fields[3]
FieldType
UserRequired
choice
Output fields[3]
FieldType
Idtext

Delete an Extract Integration

ActionClears a conversation data extraction setup.
Input fields[3]
FieldType
Extract IntegrationRequired
choice
Output fields[3]
FieldType
Idtext

Detach a File from a Dataset

ActionSeparates a file from a dataset, optionally dropping its records.
Input fields[3]
FieldType
DatasetRequired
choice
FileRequired
choice
Delete Recordsboolean
Output fields[3]
FieldType
Idtext

Duplicate a Blueprint

ActionCopy of a blueprint with its resource list.
Input fields[3]
FieldType
BlueprintRequired
choice
Output fields[3]
FieldType
Idtext
Resourcestext

Duplicate a Bot

ActionClones a bot configuration under a new Id.
Input fields[3]
FieldType
BotRequired
choice
Output fields[3]
FieldType
Idtext

Make an API Call

universalDirect ChatBotKit REST API access for uncovered endpoints.
Input fields[3]
FieldType
URLRequired
text
MethodRequired
choice
Headersarray
Rowobject
Query Stringarray
Rowobject
Bodytext
Output fields[3]
FieldType
Bodytext
Headersobject
Content-typetext
Status Codenumber

Move a Space File

ActionGives a space file a new path, which also renames it.
Input fields[3]
FieldType
SpaceRequired
choice
PathRequired
text
Destination PathRequired
text
Output fields[3]
FieldType
Pathtext

Rate a Conversation Down

ActionThumbs-down feedback on a chat.
Input fields[3]
FieldType
ConversationRequired
choice
Valuenumber
Reasontext
Output fields[3]
FieldType
Idtext

Rate a Conversation Up

ActionThumbs-up feedback on a chat.
Input fields[3]
FieldType
ConversationRequired
choice
Valuenumber
Reasontext
Output fields[3]
FieldType
Idtext

Run a Skillset Ability

ActionDirect call of a single ability.
Input fields[3]
FieldType
SkillsetRequired
choice
Ability IDRequired
text
Inputtext
Contactchoice
Output fields[3]
FieldType
Usageobject
Tokennumber
Errortext
Messagesarray

Run a Task

ActionImmediate start of a task.
Input fields[3]
FieldType
TaskRequired
choice
Output fields[3]
FieldType
Idtext

Run a Trigger Integration

ActionManual firing of a trigger integration.
Input fields[3]
FieldType
Trigger IntegrationRequired
choice
Output fields[3]
FieldType
Idtext

Run an Extract Integration

ActionStarts a data extraction run.
Input fields[3]
FieldType
Extract IntegrationRequired
choice
Conversation Idstext
Samplenumber
Output fields[3]
FieldType
Idtext
Triggerednumber

Run the Setup of a Trigger Integration

ActionStarts the setup of a bot trigger.
Input fields[3]
FieldType
Trigger IntegrationRequired
choice
Output fields[3]
FieldType
Idtext

Send a Conversation Message

ActionAdds a message to a chat without a reply.
Input fields[3]
FieldType
ConversationRequired
choice
TextRequired
text
Entities (JSON)text
Functions (JSON)text
Extensions (JSON)text
Output fields[3]
FieldType
Idtext
Entitiesarray

Send a Message and Get a Reply

ActionMessage to a conversation with the reply returned.
Input fields[3]
FieldType
ConversationRequired
choice
Texttext
Entities (JSON)text
Functions (JSON)text
Extensions (JSON)text
Limits (JSON)text
Output fields[3]
FieldType
Idtext
Texttext
Usageobject
Tokennumber
Endobject
Reasontext

Set the Contact of a Conversation

ActionAssociates a contact with a chat.
Input fields[3]
FieldType
ConversationRequired
choice
Nametext
Descriptiontext
Metaarray
Rowobject
Fingerprinttext
Emailtext
Phonetext
Nicknametext
Output fields[3]
FieldType
Idtext

Start a Chat in the Background

ActionAsynchronous chat that returns a channel to follow.
Input fields[3]
FieldType
MessagesRequired
array
Messageobject
Botchoice
Modelchoice
Backstorytext
Datasetchoice
Skillsetchoice
Privacyboolean
Moderationboolean

6other input fields

Output fields[3]
FieldType
Channel Idtext

Sync a Dataset File

ActionRe-reads a file that feeds a dataset.
Input fields[3]
FieldType
DatasetRequired
choice
FileRequired
choice
Output fields[3]
FieldType
Idtext

Sync a File

ActionUpdates a stored file from its source.
Input fields[3]
FieldType
FileRequired
choice
Output fields[3]
FieldType
Idtext

Update a Blueprint

ActionRelabels a blueprint and changes who sees it.
Input fields[3]
FieldType
BlueprintRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Contactchoice
Visibilitychoice
Clear Fieldschoice
Output fields[3]
FieldType
Idtext

Update a Bot

ActionReconfigures the model, backstory and knowledge of a chatbot.
Input fields[3]
FieldType
BotRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Modelchoice
Backstorytext
Datasetchoice

8other input fields

Output fields[3]
FieldType
Idtext

Update a Contact

ActionCorrects the saved details of a contact.
Input fields[3]
FieldType
ContactRequired
choice
Nametext
Descriptiontext
Metaarray
Rowobject
Fingerprinttext
Emailtext
Phonetext
Nicknametext

2other input fields

Output fields[3]
FieldType
Idtext

Update a Conversation

ActionGives a chat a different bot, model or contact.
Input fields[3]
FieldType
ConversationRequired
choice
Nametext
Descriptiontext
Metaarray
Rowobject
Botchoice
Modelchoice
Backstorytext
Datasetchoice

8other input fields

Output fields[3]
FieldType
Idtext

Update a Conversation Message

ActionCorrects the wording of a saved chat message.
Input fields[3]
FieldType
ConversationRequired
choice
Message IDRequired
text
Nametext
Descriptiontext
Metaarray
Rowobject
Typechoice
Texttext
Entities (JSON)text
Output fields[3]
FieldType
Idtext

Update a Dataset

ActionAdjusts the search settings of a dataset.
Input fields[3]
FieldType
DatasetRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Rerankertext

9other input fields

Output fields[3]
FieldType
Idtext

Update a Dataset Record

ActionFixes the text or source of a stored record.
Input fields[3]
FieldType
DatasetRequired
choice
Record IDRequired
text
Texttext
Sourcetext
Metaarray
Rowobject
Output fields[3]
FieldType
Idtext

Update a File

ActionMetadata changes on a stored file.
Input fields[3]
FieldType
FileRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Visibilitychoice

1other input field

Output fields[3]
FieldType
Idtext

Update a Memory

ActionChanges what a stored memory says.
Input fields[3]
FieldType
Memory IDRequired
text
Nametext
Descriptiontext
Metaarray
Rowobject
Contactchoice
Botchoice
Texttext
Expires Atnumber

1other input field

Output fields[3]
FieldType
Idtext

Update a Secret

ActionReconfigures a stored credential.
Input fields[3]
FieldType
SecretRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Kindchoice

5other input fields

Output fields[3]
FieldType
Idtext

Update a Skillset

ActionRetitles a group of abilities and toggles its state.
Input fields[3]
FieldType
SkillsetRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Visibilitychoice

2other input fields

Output fields[3]
FieldType
Idtext

Update a Skillset Ability

ActionReworks a single callable bot ability.
Input fields[3]
FieldType
SkillsetRequired
choice
Ability IDRequired
text
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Linked Secret Idchoice

7other input fields

Output fields[3]
FieldType
Idtext

Update a Space

ActionRelabels a file storage area.
Input fields[3]
FieldType
SpaceRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Clear Fieldschoice
Output fields[3]
FieldType
Idtext

Update a Task

ActionReschedules a bot job and its limits.
Input fields[3]
FieldType
TaskRequired
choice
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Contactchoice
Botchoice
Scheduletext

8other input fields

Output fields[3]
FieldType
Idtext

Update a Trigger Integration

ActionReworks the timing and access of a bot trigger.
Input fields[3]
FieldType
Trigger IntegrationRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Botchoice
Authenticatechoice

5other input fields

Output fields[3]
FieldType
Idtext

Update a User

ActionChanges the profile details of a user.
Input fields[3]
FieldType
UserRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Imagetext
Emailtext
Limits (JSON)text

1other input field

Output fields[3]
FieldType
Idtext

Update an Extract Integration

ActionReworks one data extraction setup.
Input fields[3]
FieldType
Extract IntegrationRequired
choice
Aliastext
Nametext
Descriptiontext
Metaarray
Rowobject
Blueprintchoice
Botchoice
Schemaarray
Rowobject

3other input fields

Output fields[3]
FieldType
Idtext

Upload a Conversation Attachment

ActionPuts a document into a chat.
Input fields[3]
FieldType
ConversationRequired
choice
Filetext
File URLtext
Output fields[3]
FieldType
Idtext
Nametext
Upload Requestobject
Methodtext
Urltext
Headerstext

Upload a File

ActionFills a file record with content.
Input fields[3]
FieldType
FileRequired
choice
Filetext
File URLtext
Output fields[3]
FieldType
Idtext
Upload Requestobject
Methodtext
Urltext
Headerstext

Upload a Space File

ActionStores content under a path of a storage area.
Input fields[3]
FieldType
SpaceRequired
choice
PathRequired
text
Filetext
File URLtext
Output fields[3]
FieldType
Idtext
Pathtext
Upload Requestobject
Methodtext
Urltext
Headerstext

Look for ChatBotKit templates in the WEXTL template library.

Browse templates →
  1. WEXTL® ChatBotKit Source Code connector implementation.
  2. Our users use cases and automations.
  3. Official API Documentation for ChatBotKit.
  4. WEXTL® visual workflow builder data.

Last updated: Nov 14, 2026 14:55

How we write our apps documentation

How we compile these docs: sources, the role of AI, and how we verify.