---
title: "BotMape integration for LuumenAI"
url: "https://www.luumen.ai/integrations/botmape/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# BotMape integration for LuumenAI

Read your BotMape agents and knowledge bases, change them as approved steps

## What LuumenAI can do with BotMape

LuumenAI connects to BotMape with an API token and exposes 8 tools (4 read-only · 2 write · 2 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 8 tools (4 read-only · 2 write · 2 destructive)
- Plan: available on all plans
- Category: AI & automation

## About BotMape with LuumenAI

Connect BotMape with an API key and Luumen can see every AI agent on the account: its behavior prompt, appearance, active state, and message volume. Ask what an agent is trained on, or which agent is handling the most conversations. When something needs to change, Luumen shows the edit first and waits for your approval before adding knowledge or creating an agent.

## Example tools

Read-only (4 in total):

- `BOTMAPE_GET_AI_AGENT` — Return the detailed configuration, behavior prompt, appearance, and active state of one AI agent by ID.
- `BOTMAPE_GET_PLATFORM_ANALYTICS` — Return account-wide BotMape message and conversation totals, daily activity, averages, and per-agent statistics.
- `BOTMAPE_LIST_AI_AGENTS` — Return all AI agents owned by the connected BotMape account, including the IDs needed by single-agent, chat, and knowledge tools.
- `BOTMAPE_LIST_KNOWLEDGE_ENTRIES` — Return all knowledge-base entries currently attached to one AI agent, including entry IDs needed for deletion.

Write and destructive (4 in total, approval required by default):

- `BOTMAPE_ADD_KNOWLEDGE` — Add and automatically embed training content in one AI agent's knowledge base, optionally with source or categorization metadata.
- `BOTMAPE_CREATE_AI_AGENT` — Permanently create a BotMape AI agent.
- `BOTMAPE_DELETE_KNOWLEDGE_ENTRY` — Permanently delete one knowledge-base entry from an AI agent using both the agent ID and knowledge entry ID.
- `BOTMAPE_SEND_MESSAGE_TO_AI_AGENT` — Immediately send a visitor message to an AI agent, creating a conversation or continuing the supplied conversation, and return the generated reply.

## Frequently asked questions

### How does LuumenAI connect to BotMape?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in BotMape on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 2 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to BotMape — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/botmape/