Integration

WAHA integration

WAHA, the self-hosted WhatsApp HTTP API. Run the full session lifecycle (create, start, stop, restart, log out, delete, read status and the linked account), pair a phone through a QR code or a live screenshot, send text, images, files and locations, mark messages as seen, browse chats and their message history, read the contact list and check whether a number is on WhatsApp, and list, create and inspect groups. The server is your own, so the host is part of the credential.

Connect WAHA How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

Common WAHA use cases

sending a pickup point to a driver
finding the session name to send from
guarding a send behind a status check
sending a product photo to a customer
delivering a PDF invoice over WhatsApp
pausing a sender during a maintenance window
swapping the phone behind an existing session
confirming the sender number before a campaign
finding the identifier of a group to post into
decommissioning a sender that is no longer used

What you can do with WAHA

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.

Session, 11 operations

create_sessionCreate sessionPOSTCreates a named session and can start it in the same call.
delete_sessionDelete sessionDELETEStops, logs out and removes a session in one irreversible call.
get_qr_codeGet qr codeGETDownloads the QR code image a human must scan to pair the session.
get_screenshotGet screenshotGETCaptures what the session's browser currently shows, as an image.
get_sessionGet sessionGETReturns a single session, its status and the account it is linked to.
get_session_meGet session meGETReturns the phone number and display name behind a session.
list_sessionsList sessionsGETLists sessions with their status and the account each is linked to.
logout_sessionLogout sessionPOSTDrops a session's WhatsApp credentials while keeping its configuration.
restart_sessionRestart sessionPOSTRestarts a session, keeping its credentials.
start_sessionStart sessionPOSTStarts a session so it can pair or resume its WhatsApp connection.
stop_sessionStop sessionPOSTStops a session while keeping its WhatsApp credentials.

Message, 6 operations

get_chat_messagesGet chat messagesGETReads a chat's message history with paging and media handling.
send_fileSend filePOSTSends a file to a chat as a document.
send_imageSend imagePOSTSends an image to a chat, with an optional caption.
send_locationSend locationPOSTSends a map pin to a chat.
send_seenSend seenPOSTSends read receipts for a chat so the sender sees blue ticks.
send_textSend textPOSTSends a text message from a session to a chat.

Group, 3 operations

create_groupCreate groupPOSTCreates a WhatsApp group and adds the given participants.
get_group_participantsGet group participantsGETLists a group's members with their role.
list_groupsList groupsGETLists the groups the session is a member of.

Contact, 2 operations

check_number_existsCheck number existsGETTells you whether a phone number has WhatsApp and returns its chat identifier.
list_contactsList contactsGETLists a session's contacts with their WhatsApp identifiers.

Chat, 1 operation

list_chatsList chatsGETLists a session's chats with their last message.

Use WAHA from Claude Code, Cursor or Codex

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

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

WAHA integration FAQ

What can you do with the WAHA integration?

LiveContext exposes 23 operations on WAHA, covering session, message, group and contact. Common uses include sending a pickup point to a driver, finding the session name to send from and guarding a send behind a status check.