communicationapi_key

BotPenguin

BotPenguin is an AI chatbot platform for managing contacts, conversations, bot integrations, and cross-platform customer messaging.

Verdict

BotPenguin manages chatbot contacts, segments, and WhatsApp messaging workflows. When you @mention it in Switchy, your team can pull inbox conversations, import contact lists, inspect segment definitions, and preview WhatsApp template fields before sending campaigns. Marketing and support teams use it to audit bot performance, sync CRM data into BotPenguin, and draft template messages with the correct dynamic fields. Setup requires an API key from your BotPenguin dashboard; once connected, you can query contacts and templates without leaving your Project.

Common use cases

  • Import CRM leads into BotPenguin in bulk
  • Audit which contacts have engaged with bots
  • Preview template dynamic fields before campaigns
  • Compare segment sizes across marketing lists
  • List available WhatsApp bots for new workflows

Integration

Vendor
BotPenguin
Category
communication
Auth
API_KEY
Tools
6
Composio slug
botpenguin

Tools

  • Get Template Dynamic Fields

    Return the dynamic key-value fields required by a BotPenguin WhatsApp template.

  • Import Contacts

    Import contacts in bulk into BotPenguin. Existing contacts may be updated, and the operation does not return contact IDs.

  • List Inbox Contacts

    Return one page of BotPenguin inbox contacts filtered by whether the contact has interacted with a bot.

  • List Segments

    List the contact segments configured in the connected BotPenguin account, including each segment's filter definition and contact count.

  • List WhatsApp Bots

    List WhatsApp bots available to the connected BotPenguin account for use with plugin template tools.

  • List WhatsApp Templates

    List WhatsApp templates available to a BotPenguin bot.

Setup

Setup guide

  1. 11. In Switchy, open the Integrations panel and search for BotPenguin. 2. Click Connect and choose API Key as the authentication method. 3. Log into your BotPenguin account, navigate to Settings → API, and generate a new API key. 4. Paste the key into Switchy and click Authorize. 5. Switchy confirms the connection by listing your WhatsApp bots. 6. Inside any Project, type '@BotPenguin list my WhatsApp bots' to verify the integration works. 7. If you see bot names and IDs, the connection is live and ready for contact imports, segment queries, and template field lookups.

What teammates see: by default, memories from BotPenguin are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Audit Active Contacts

@BotPenguin list all inbox contacts who have interacted with a bot in the last 30 days. Show me their names and last interaction timestamps.

Preview Template Fields

@BotPenguin get the dynamic fields for the 'order_confirmation' WhatsApp template on bot ID 12345. List each field name and its expected format.

Compare Segment Sizes

@BotPenguin list all contact segments in my account. For each segment, show the filter definition and total contact count.

Import Lead CSV

@BotPenguin import the contacts from this CSV file into my account. Update any existing contacts with matching phone numbers.

List WhatsApp Bots

@BotPenguin list all WhatsApp bots available in my account. Include bot IDs and their current status.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@BotPenguin list all contacts in our 'High Value Customers' segment and show me their last interaction date

Output

Based on your BotPenguin segments, 'High Value Customers' contains 247 contacts with filters set to purchase_value > $500 AND last_purchase < 90 days. The segment was last updated 6 hours ago. To see individual contact interaction dates, you would need to list inbox contacts separately — segments show aggregate counts and filter rules, not per-contact activity timestamps. The top 3 segments by size are: High Value Customers (247), Trial Users (1,832), and Churned Accounts (94).

Notes

This example shows how BotPenguin organizes contacts into filtered segments. The MCP returns segment definitions and counts, not individual contact records — you'll need a follow-up prompt to list inbox contacts if you want per-person detail. Useful for understanding audience size before a broadcast campaign.

Prompt

@BotPenguin import these 50 new trial signups from our CSV into the contacts database and tag them 'Q1-2025-trial'

Output

Bulk import initiated for 50 contacts. BotPenguin will create new records or update existing ones based on phone number match. Note: the import operation does not return individual contact IDs, so you won't receive confirmation of which records were created versus updated. All contacts will be tagged 'Q1-2025-trial' as specified. You can verify the import by listing inbox contacts filtered by that tag after a few minutes, or by checking the segment count if you've configured a segment with that tag filter.

Notes

This demonstrates BotPenguin's bulk contact import capability. The key trade-off: you don't get back contact IDs or a success/failure breakdown per row, so plan to verify imports through segment counts or inbox listing. Ideal for onboarding leads at scale, less suited for workflows that need immediate per-contact confirmation.

Prompt

@BotPenguin check which WhatsApp templates are approved for our 'Customer Support' bot and show me the dynamic fields needed for the 'order_status_update' template

Output

Your 'Customer Support' bot has 12 approved WhatsApp templates. The 'order_status_update' template requires these dynamic fields: {{customer_name}}, {{order_id}}, {{current_status}}, and {{estimated_delivery}}. This template was approved by Meta 8 days ago and is in the 'Transactional' category. Before sending, ensure you have all four field values populated — missing fields will cause the send to fail. The template's preview text reads: 'Hi {{customer_name}}, your order {{order_id}} is now {{current_status}}. Estimated delivery: {{estimated_delivery}}.'

Notes

This example pairs two BotPenguin tools: listing templates and fetching dynamic field requirements. Useful before launching a WhatsApp campaign — you'll know exactly which data points to pass. Remember that WhatsApp template approval status can change if Meta flags content, so verify template availability close to send time for critical campaigns.

Use-case deep-dives

CRM contact sync for WhatsApp outreach

Why BotPenguin's bulk import works for weekly CRM syncs under 5k contacts

A five-person sales team syncs leads from HubSpot to BotPenguin every Monday to enable WhatsApp outreach. The Import Contacts tool handles bulk uploads and updates existing contacts, so the team runs one prompt per week to refresh the list. The MCP's API key auth means no OAuth dance, and the operation completes in under a minute for their 3,000-contact list. The trade-off: BotPenguin doesn't return contact IDs after import, so if your CRM workflow depends on matching BotPenguin records back to HubSpot, you'll need a separate lookup step or a custom script. For teams that treat BotPenguin as a downstream outreach channel—not the source of truth—this MCP keeps the sync simple. If you're over 10k contacts or need bidirectional sync with field-level mapping, you'll want a dedicated iPaaS tool or BotPenguin's Zapier integration instead.

Frequently asked

What does the BotPenguin MCP do in Switchy?

It lets your AI agents read BotPenguin contact lists, import contacts in bulk, retrieve WhatsApp template fields, and list your configured bots and segments. You can't send messages or trigger campaigns directly—this MCP focuses on contact management and template inspection to feed data into your workflows.

Do I need admin access to connect BotPenguin?

You need an API key from your BotPenguin account, which typically requires admin or developer permissions to generate. The key grants read access to contacts, segments, and templates, plus write access to import contacts. Check your BotPenguin account settings to create one.

Can the BotPenguin MCP send WhatsApp messages?

No. It retrieves template structures and dynamic fields so your agent knows what data a template needs, but it doesn't send messages. To actually dispatch WhatsApp messages, you'll need to use BotPenguin's API directly or trigger campaigns inside their platform.

How is this different from using BotPenguin's dashboard?

The MCP gives your AI agents programmatic access to contact data and template metadata without opening the dashboard. It's faster for bulk contact imports or checking which segments exist, but you'll still configure bots, design templates, and launch campaigns in BotPenguin's UI.

Who on the team should connect this integration?

Whoever manages your BotPenguin account and has API key access—usually a marketing ops lead or customer success manager. Once connected, any Switchy team member can query contact lists or segments in shared AI chats without needing their own BotPenguin login.

More communication MCPs

See all communication MCPs →

Data last verified 60 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.