Integration

BotBee integration

BotBee is a WhatsApp Business API platform (official WhatsApp Cloud API numbers connected to a BotBee account). An agent can send WhatsApp text, media and reply-button messages, upload media, read a conversation and a message's delivery status, trigger bot flows, manage subscribers (create, look up, list, update, delete, labels, drip sequences, custom fields, notes, chat assignment), list templates, labels and post-backs, and list and sync WhatsApp catalogs and their orders. Free-form messages are allowed only inside the 24-hour customer-service window. The two Onetime Login routes (which create reseller end users and return their password and a one-time login URL) are not exposed. Authentication is the API token from the BotBee dashboard (API settings), sent as the apiToken query parameter. BotBee answers most refusals with HTTP 200 and status "0", so check status in every answer.

Connect BotBee How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in BotBee.Built from the 29 BotBee tools below, on the connection you add once.

What you can do with BotBee

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Each badge shows the default agent permission of an endpoint (allowed: an agent calls it without asking; ask first: you are asked before an agent calls it, when the agent or chat asks permission for sensitive actions; never: no agent may call it), which every user can change endpoint by endpoint in their credential settings.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Subscriber, 5 operations

create_subscriberCreate subscriberPOSTAgents: ask firstAdds a subscriber (WhatsApp contact) to one of your WhatsApp numbers. Counts toward the plan's subscriber limit. Nothing is sent to the person. Note this route names its fields phoneNumberID and phoneNumber.
delete_subscriberDelete subscriberPOSTAgents: ask firstPermanently removes a subscriber (WhatsApp contact) from one of your WhatsApp numbers. This cannot be undone.
get_subscriberGet subscriberPOSTAgents: ask firstLooks up a subscriber (WhatsApp contact) by phone number and returns their profile: name, email, gender, assigned agent, bot and AI reply state and labels. Returns personal data.
list_subscribersList subscribersPOSTAgents: ask firstLists the subscribers (WhatsApp contacts) of one of your WhatsApp numbers, one page at a time, with id, chat id, name and labels. Returns personal data.
update_subscriberUpdate subscriberPOSTAgents: ask firstUpdates a subscriber's first name, last name, gender or labels. Leave a field out to keep its current value.

Message, 3 operations

send_interactive_buttonsSend interactive buttonsPOSTAgents: ask firstSends a WhatsApp session message with 1 to 3 reply buttons and an optional text, image, video or document header. A real message is delivered, only inside the 24-hour customer-service window.
send_media_messageSend media messagePOSTAgents: ask firstSends an image, video, audio file or document to a WhatsApp number, from a public URL or a media id from upload_media. A real message is delivered. Pass media_url or media_id; at least one is required.
send_text_messageSend text messagePOSTAgents: ask firstSends a free-form WhatsApp text message to a phone number from one of your connected WhatsApp numbers. A real message is delivered.

Catalog, 2 operations

list_catalogsList catalogsPOSTAgents: ask firstLists the WhatsApp product catalogs connected to your BotBee account, with each catalog's id, name, URL and checkout tax and shipping settings.
sync_catalogSync catalogPOSTAgents: ask firstImports the current products of a WhatsApp catalog into BotBee, replacing BotBee's copy of that catalog's products.

Catalog order, 2 operations

list_catalog_ordersList catalog ordersPOSTAgents: ask firstLists the orders customers placed through your WhatsApp catalogs, optionally for one catalog: order id, customer first name, total, currency, status, payment method and date. Returns personal data.
update_catalog_order_statusUpdate catalog order statusPOSTAgents: ask firstChanges the fulfilment status of a catalog order to Approved, Completed, Shipped, Delivered or Refunded.

Label, 2 operations

create_labelCreate labelPOSTAgents: ask firstCreates a label on one of your WhatsApp numbers; read its id back with list_labels.
list_labelsList labelsPOSTAgents: ask firstLists the labels of one of your WhatsApp numbers, with each label's id, to pass as label_ids to add_subscriber_labels, remove_subscriber_labels or update_subscriber.

Subscriber label, 2 operations

add_subscriber_labelsAdd subscriber labelsPOSTAgents: ask firstAdds one or more labels to a subscriber, given as comma-separated label ids from list_labels. Labels can start automations configured in BotBee.
remove_subscriber_labelsRemove subscriber labelsPOSTAgents: ask firstRemoves one or more labels from a subscriber, given as comma-separated label ids from list_labels.

Subscriber sequence, 2 operations

add_subscriber_sequencesAdd subscriber sequencesPOSTAgents: ask firstEnrols a subscriber in one or more drip sequences, which then send the sequence's scheduled WhatsApp messages to the person.
remove_subscriber_sequencesRemove subscriber sequencesPOSTAgents: ask firstRemoves a subscriber from one or more drip sequences, which stops their remaining scheduled messages.

Bot flow, 1 operation

trigger_bot_flowTrigger bot flowPOSTAgents: ask firstStarts one of your bot flows for a subscriber, which sends that flow's WhatsApp messages to the person. Get the flow's unique id from the BotBee bot manager.

Conversation, 1 operation

get_conversationGet conversationPOSTAgents: ask firstReturns the message history between one of your WhatsApp numbers and a subscriber, limit messages at a time (offset pages further). The messages are personal data.

Custom field, 1 operation

list_custom_fieldsList custom fieldsPOSTAgents: ask firstLists the custom fields defined in your BotBee account, with each field's id, name and reply type (for example text or email).

Media, 1 operation

upload_mediaUpload mediaPOSTAgents: ask firstUploads an image, video, audio file or document to WhatsApp through BotBee and returns a media_id to use with send_media_message or send_interactive_buttons. Nothing is sent to anyone.

Message status, 1 operation

get_message_statusGet message statusPOSTAgents: ask firstReturns the delivery status of a sent WhatsApp message (for example delivered), with when it was updated, read or failed and why it failed.

Postback, 1 operation

list_postbacksList postbacksPOSTAgents: ask firstLists the post-back items (bot replies and flows) configured for one of your WhatsApp numbers, with the postback_id and bot name of each.

Subscriber chat, 1 operation

assign_subscriber_to_team_memberAssign subscriber to team memberPOSTAgents: ask firstRoutes a subscriber's live chat to one of your team members, who then sees it as theirs in the BotBee inbox.

Subscriber custom field, 1 operation

set_subscriber_custom_fieldsSet subscriber custom fieldsPOSTAgents: ask firstSets custom field values on a subscriber's profile, given as a JSON object of field name to value (names from list_custom_fields). Overwrites the named fields.

Subscriber input flow, 1 operation

reset_subscriber_input_flowReset subscriber input flowPOSTAgents: ask firstResets the bot's user-input flow state for a subscriber, so a question flow the person is in the middle of starts over.

Subscriber note, 1 operation

add_subscriber_noteAdd subscriber notePOSTAgents: ask firstAttaches an internal note to a subscriber's chat, visible to your team in the BotBee inbox and not sent to the person.

Template, 1 operation

list_templatesList templatesPOSTAgents: ask firstReturns the WhatsApp message templates of one of your WhatsApp numbers, with each template's name, locale, header type and approval status.

Use BotBee from Claude Code, Cursor or Codex

Connect BotBee in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its BotBee operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect BotBee

Create your workspace
Sign up free. Nothing to install.
Connect BotBee once
Add your BotBee connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.