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

# BotPenguin integration for LuumenAI

Read BotPenguin contacts, segments, and templates, then import in bulk on approval

## What LuumenAI can do with BotPenguin

LuumenAI connects to BotPenguin with an API token and exposes 6 tools (5 read-only · 1 write). 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: 6 tools (5 read-only · 1 write)
- Plan: available on all plans
- Category: AI & automation

## About BotPenguin with LuumenAI

Connect BotPenguin with an API key and Luumen can answer questions about your messaging setup without you opening the console. Check which WhatsApp bots exist, what templates they carry and which dynamic fields those templates need, page through inbox contacts, and read segment filters and counts. When contacts need to go in, Luumen shows the import first and waits for your approval.

## Example tools

Read-only (5 in total):

- `BOTPENGUIN_GET_TEMPLATE_DYNAMIC_FIELDS` — Return the dynamic key-value fields required by a BotPenguin WhatsApp template.
- `BOTPENGUIN_LIST_INBOX_CONTACTS` — Return one page of BotPenguin inbox contacts filtered by whether the contact has interacted with a bot.
- `BOTPENGUIN_LIST_SEGMENTS` — List the contact segments configured in the connected BotPenguin account, including each segment's filter definition and contact count.
- `BOTPENGUIN_LIST_WHATSAPP_BOTS` — List WhatsApp bots available to the connected BotPenguin account for use with plugin template tools.
- `BOTPENGUIN_LIST_WHATSAPP_TEMPLATES` — List WhatsApp templates available to a BotPenguin bot.

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

- `BOTPENGUIN_IMPORT_CONTACTS` — Import contacts in bulk into BotPenguin.

## Frequently asked questions

### How does LuumenAI connect to BotPenguin?

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 BotPenguin on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default. Administrators configure that per tool.

### Is there an audit trail?

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

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