Integration

BotConversa integration

BotConversa is a Brazilian WhatsApp chatbot and marketing platform. Find, list, create and delete subscribers (WhatsApp contacts), send them a text or file message or start a flow for them, add or remove their tags, campaigns and sequences, set or clear their custom field values, open or close their live-chat conversation, list and create campaigns (entry links and QR codes), list flows, tags, sequences and custom fields, and read and set the bot's global fields. Team member (manager) administration is not exposed. Authentication is the account's API key, sent in the API-KEY header; the API allows 600 requests per minute.

Connect BotConversa How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

What you can do with BotConversa

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.

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

Campaign, 5 operations

add_subscriber_to_campaignAdd subscriber to campaignPOSTAdds a subscriber to a campaign.
delete_campaignDelete campaignDELETEDeletes a campaign permanently.
get_campaignGet campaignGETReturns one campaign: name, message text, share type (0 link, 1 QR code) and the flow it starts.
list_campaignsList campaignsGETLists the campaigns of the account: id, name, message text, share type (0 link, 1 QR code), the flow they start, the campaign link and the QR code image link.
remove_subscriber_from_campaignRemove subscriber from campaignDELETERemoves a subscriber from a campaign.

Custom field, 3 operations

clear_subscriber_custom_fieldClear subscriber custom fieldDELETEClears a custom field value on a subscriber.
list_custom_fieldsList custom fieldsGETLists the account's custom fields (per-subscriber variables): id, key and type (0 string, 1 number, 2 date, 3 datetime). Use the id with set_subscriber_custom_field.
set_subscriber_custom_fieldSet subscriber custom fieldPOSTSets a custom field value on a subscriber. The value format depends on the field type: text, a number, a date dd.mm.yyyy or a datetime dd.mm.yyyy HH:MM:SS.

Sequence, 3 operations

add_subscriber_to_sequenceAdd subscriber to sequencePOSTSubscribes a subscriber to a sequence, so its scheduled WhatsApp messages are sent to the contact, a real person, over time. On Meta's official WhatsApp API (Pro plan), Meta charges each sent message from the prepaid wallet.
list_sequencesList sequencesGETLists the account's sequences (id and name). Use the id with add_subscriber_to_sequence.
remove_subscriber_from_sequenceRemove subscriber from sequenceDELETEUnsubscribes a subscriber from a sequence, stopping its remaining scheduled messages.

Tag, 3 operations

add_subscriber_tagAdd subscriber tagPOSTAdds a tag to a subscriber. Tags can start the automations configured on them in BotConversa.
list_tagsList tagsGETLists the account's tags (id and name). Use the id with add_subscriber_tag and remove_subscriber_tag.
remove_subscriber_tagRemove subscriber tagDELETERemoves a tag from a subscriber.

Bot field, 2 operations

list_bot_fieldsList bot fieldsGETLists the bot's global fields (bot-wide variables shared by every contact, not per-subscriber values): id, key, type (0 string, 1 float, 2 date, 3 datetime) and current value.
set_bot_fieldSet bot fieldPOSTSets the value of one global bot field. The value must match the field's type (see list_bot_fields), otherwise the call is refused with 'Format of value is not correct'.

Subscriber, 2 operations

create_subscriberCreate subscriberPOSTCreates a subscriber (WhatsApp contact). The contact must have given explicit opt-in consent to receive WhatsApp messages: has_opt_in_whatsapp is required and must be true. A phone that already exists is refused.
list_subscribersList subscribersGETLists subscribers (WhatsApp contacts, personal data: names and phone numbers), one page at a time: count, next and previous page links, and the subscribers with their tags, campaigns, sequences and custom field values.

Change conversation status, 1 operation

set_conversation_statusSet conversation statusPOSTOpens or closes the live-chat conversation with a subscriber, optionally assigning it to a team member (manager).

Create, 1 operation

create_campaignCreate campaignPOSTCreates a campaign, an entry point shared as a link or a QR code (share_type) that starts the given flow for the contacts who use it.

Delete, 1 operation

delete_subscriberDelete subscriberDELETEDeletes a subscriber (WhatsApp contact) and its data from the account permanently.

Flow, 1 operation

list_flowsList flowsGETLists the bot's flows (id and name). Use the id with send_flow or as a campaign's to_flow.

Get by phone, 1 operation

get_subscriber_by_phoneGet subscriber by phoneGETFinds a subscriber by phone number and returns the contact (personal data: name, phone, WhatsApp username) with its tags, campaigns, sequences and custom field values. Answers 404 when no subscriber has that phone.

Send flow, 1 operation

send_flowSend flowPOSTStarts a flow for a subscriber: the bot runs it and sends its WhatsApp messages to the contact now. This messages a real person. On Meta's official WhatsApp API (Pro plan), Meta charges each sent message from the account's prepaid wallet.

Send message, 1 operation

send_messageSend messagePOSTSends a WhatsApp message to a subscriber now: a text, or a file given by its link (type file). This messages a real person. On Meta's official WhatsApp API (Pro plan), Meta charges each sent message from the account's prepaid wallet.

Use BotConversa from Claude Code, Cursor or Codex

Connect BotConversa in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its BotConversa 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 BotConversa

Create your workspace
Sign up free. Nothing to install.
Connect BotConversa once
Add your BotConversa 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.