Skip to main content
BotMape logo
  • Category: ai chatbots
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 8
  • Triggers: 0
  • Slug: BOTMAPE
  • Version: 20261101_00

Tools

Slug: BOTMAPE_ADD_KNOWLEDGEAdd and automatically embed training content in one AI agent’s knowledge base, optionally with source or categorization metadata.

Input Parameters

string
required
Non-empty training content to embed, such as FAQs, documentation, or policies.
object
Optional free-form metadata for the content, such as its category, source, or tags.
integer
required
Numeric AI agent ID whose knowledge base should receive the training content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTMAPE_CREATE_AI_AGENTPermanently create a BotMape AI agent. BotMape provides no documented delete-agent API, so this toolkit cannot remove it afterward, and creation may permanently consume a plan-limited agent slot. Requires explicit confirmation that a lasting agent is intended.

Input Parameters

string
required
Permanent AI agent display name (1-100 characters). Creating it may consume a plan-limited slot, and no documented API can delete it.
string
Brief statement of the lasting AI agent’s purpose.
string
Widget theme color as a six-digit hex value such as #6366f1.
string
Behavior and personality instructions for the new AI agent.
string
Initial greeting the new AI agent shows visitors.
boolean
required
Must be true to confirm that BotMape provides no documented API to delete the new AI agent and that creation may permanently consume a plan-limited agent slot. This confirmation is not sent to BotMape.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTMAPE_DELETE_KNOWLEDGE_ENTRYPermanently delete one knowledge-base entry from an AI agent using both the agent ID and knowledge entry ID.

Input Parameters

integer
required
Numeric ID of the AI agent that owns the knowledge entry.
integer
required
ID of the knowledge entry to permanently delete; obtain it with List Knowledge Entries.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTMAPE_GET_AI_AGENTReturn the detailed configuration, behavior prompt, appearance, and active state of one AI agent by ID.

Input Parameters

integer
required
Numeric AI agent ID returned by List AI Agents.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTMAPE_GET_PLATFORM_ANALYTICSRetrieve aggregate BotMape analytics across the account’s AI agents, including message and conversation totals and daily activity. Use these statistics to review platform usage and trends.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTMAPE_LIST_AI_AGENTSReturn all AI agents owned by the connected BotMape account, including the IDs needed by single-agent, chat, and knowledge tools.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTMAPE_LIST_KNOWLEDGE_ENTRIESReturn all knowledge-base entries currently attached to one AI agent, including entry IDs needed for deletion.

Input Parameters

integer
required
Numeric AI agent ID whose knowledge base should be listed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTMAPE_SEND_MESSAGE_TO_AI_AGENTImmediately send a visitor message to an AI agent, creating a conversation or continuing the supplied conversation, and return the generated reply. This permanently adds chat history.

Input Parameters

string
required
Non-empty visitor message to send immediately to the AI agent.
string
Stable external visitor identifier used to associate this message with a visitor.
integer
required
ID of the AI agent that should receive the message; use an ID returned by List AI Agents.
string
Display name to record for the visitor.
string
Email address to record for the visitor.
string
Existing conversation ID to continue; omit to start a new conversation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not