Integration

TimelinesAI integration

TimelinesAI is a shared WhatsApp inbox for teams. Agents can list and update chats, read message history, send WhatsApp messages, files and voice notes from connected numbers (and WhatsApp Business Platform messages and templates), add notes, labels and reactions, upload files, manage text templates and webhook subscriptions, and read connected accounts, teammates and quota usage. Teammate invitations, template usage tracking and the duplicate v2 routes are not exposed. Authentication is the workspace API token from Integrations > Public API in TimelinesAI, sent as a Bearer token; sending a message uses the workspace's message quota.

Connect TimelinesAI How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

What you can do with TimelinesAI

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.

Message, 8 operations

get_messageGet messageGETReturns one message: text, sender and recipient names and phones, direction, delivery status, attachment URL and reactions. Personal data.
get_message_status_historyGet message status historyGETReturns a sent message's delivery history: each status (Sending, Sent, Delivered, Read, Failed) with its timestamp. Use it after a send tool.
list_chat_messagesList chat messagesGETReturns a chat's message history, 50 per page, filterable by direction, date or message range and sorted asc or desc. Message texts and sender names and phones are personal data.
send_chat_fileSend chat filePOSTSends a file as a WhatsApp document message into an existing chat, with an optional caption. This messages a real person and uses message quota. Returns data.message_uid.
send_chat_messageSend chat messagePOSTSends a WhatsApp message (text, an uploaded file_uid, or both) into an existing chat or group from the account it belongs to. This messages real people and uses message quota. Returns data.message_uid.
send_chat_voice_noteSend chat voice notePOSTSends an audio file (OGG, OGA or MP3) as a WhatsApp voice note into an existing chat or group. This messages real people and uses message quota. Returns data.message_uid.
send_message_to_jidSend message to jidPOSTSends a WhatsApp message to a contact or group JID ([email protected] or [email protected]), optionally as a reply. This messages real people and uses message quota. Returns data.message_uid.
send_message_to_phoneSend message to phonePOSTSends a WhatsApp message to a phone number, no prior chat needed, from whatsapp_account_phone or else the most recently connected account. This messages a real person and uses message quota. Returns data.message_uid.

Label, 6 operations

add_chat_labelsAdd chat labelsPUTAdds labels to a chat, keeping the ones already applied. Unknown label names are created in the workspace. Returns the chat's labels.
add_waba_chat_labelsAdd waba chat labelsPUTAdds labels to a WABA chat, keeping the ones already applied. Unknown label names are created in the workspace.
list_chat_labelsList chat labelsGETReturns the label names applied to a chat.
list_waba_chat_labelsList waba chat labelsGETReturns the label names applied to a WABA chat.
replace_chat_labelsReplace chat labelsPOSTReplaces all labels of a chat with the given list (labels not in it are removed). Unknown label names are created in the workspace. Returns the chat's labels.
replace_waba_chat_labelsReplace waba chat labelsPOSTReplaces all labels of a WABA chat with the given list (labels not in it are removed). Unknown label names are created in the workspace.

File, 5 operations

delete_fileDelete fileDELETEPermanently deletes an uploaded file from the workspace.
get_fileGet fileGETReturns an uploaded file's name, size, MIME type, uploader and a temporary download URL valid for 15 minutes.
list_filesList filesGETLists files uploaded to the workspace (uid, name, size, MIME type, uploader email, upload time), optionally filtered by part of the file name.
upload_fileUpload filePOSTUploads a file (multipart) to the workspace and returns its uid, to send as file_uid in a message tool, with a temporary download URL.
upload_file_from_urlUpload file from urlPOSTUploads a file to the workspace from a publicly reachable URL (not Google Drive or OneDrive links) and returns its uid, to send as file_uid in a message tool, with a temporary download URL.

Template, 5 operations

create_templateCreate templatePOSTCreates a text template (quick reply) with a name and text; names may repeat. Returns the template with its id.
delete_templateDelete templateDELETEPermanently deletes a text template, if its can_be_deleted rule allows it (403 otherwise).
get_templateGet templateGETReturns one text template: name, text, visibility, team, author and timestamps. 404 when it does not exist or is not visible to the token.
list_templatesList templatesGETLists the workspace's text templates (quick replies) visible to the token: id, name, text, visibility and team. Not paginated.
update_templateUpdate templatePATCHChanges a text template's name, text, visibility or team; only the fields you send change. Moving it back to all teams is not exposed here.

Waba message, 5 operations

get_waba_messageGet waba messageGETReturns one WABA message: text, direction, delivery status, attachment and, when it failed, the failure reason. Personal data.
get_waba_message_status_historyGet waba message status historyGETReturns a WABA message's delivery history: each status transition with its timestamp, and the failure reason when it failed.
list_waba_chat_messagesList waba chat messagesGETReturns a WABA chat's message history (50 per page unless size says otherwise), filterable by direction and date or message range. Message texts are personal data.
send_waba_chat_messageSend waba chat messagePOSTSends a WhatsApp Business message into a WABA chat: text, an uploaded file_uid, or an approved template (not combined). This messages a real person and Meta may bill it. Returns data.message_uid.
send_waba_message_to_phoneSend waba message to phonePOSTSends a WhatsApp Business message to a phone number from a WABA account: text, an uploaded file_uid, or an approved template (not combined). This messages a real person and Meta may bill it. Returns data.message_uid.

Webhook, 5 operations

create_webhookCreate webhookPOSTSubscribes a URL to one TimelinesAI event (new message, chat assigned, account disconnected...). Idempotent on event_type plus url. Deliveries are not signed, so the receiver cannot verify them.
delete_webhookDelete webhookDELETEPermanently deletes a webhook subscription; deliveries stop immediately.
get_webhookGet webhookGETReturns one webhook subscription: event type, URL, enabled flag and consecutive delivery error count.
list_webhooksList webhooksGETLists the workspace's webhook subscriptions: id, event type, target URL, enabled flag and consecutive delivery error count.
update_webhookUpdate webhookPUTChanges a webhook subscription's event type, URL, or enabled flag (false pauses deliveries); only the fields you send change.

Reaction, 4 operations

get_message_reactionsGet message reactionsGETReturns the emoji reactions on a message: the total, a count per emoji and who reacted.
get_waba_message_reactionGet waba message reactionGETReturns the current reactions on a WABA message.
set_message_reactionSet message reactionPATCHSets the connected account's emoji reaction on a WhatsApp message (one emoji); per the vendor an empty string clears it. The contact sees the reaction. Returns data.message_uid.
set_waba_message_reactionSet waba message reactionPATCHSets the WABA account's emoji reaction on a message (one emoji); per the vendor an empty string clears it. The contact sees the reaction.

Chat, 3 operations

get_chatGet chatGETReturns one chat: contact name, phone and JID, labels, responsible teammate, read/closed state, AI agent flag, last message and, for a group, its members. Personal data.
list_chatsList chatsGETLists the workspace's WhatsApp chats, 50 per page (check data.has_more_pages), filtered by label, account, phone, name, responsible, read, closed or creation date. Returns contact names and phone numbers (personal data).
update_chatUpdate chatPATCHUpdates a chat: rename it, assign a responsible teammate by email (an empty string unassigns), close or reopen it, mark it read or unread, or switch its AI agent on or off. Only the fields you send change.

Waba chat, 3 operations

get_waba_chatGet waba chatGETReturns one WABA chat with its contact, labels, responsible teammate and the Meta 24-hour service window state, which decides whether free text can be sent.
list_waba_chatsList waba chatsGETLists WhatsApp Business Platform (WABA) chats, 50 per page (check data.has_more_pages), filtered by WABA account, responsible, closed or phone. Contact names and phones are personal data.
update_waba_chatUpdate waba chatPATCHUpdates a WABA chat: rename it, assign a responsible teammate by email (an empty string unassigns), close or reopen it, or mark it read or unread. Only the fields you send change.

Teammate, 2 operations

get_current_teammateGet current teammateGETReturns the teammate the API token belongs to: name, email, role, team and WhatsApp accounts.
list_teammatesList teammatesGETLists the workspace's teammates: user id, name, email, role, team, status and their WhatsApp accounts. Personal data.

Waba account, 2 operations

get_waba_accountGet waba accountGETReturns one WABA account with its status, owner, display phone number and the Meta business profile and ids it belongs to.
list_waba_accountsList waba accountsGETLists the WhatsApp Business Platform (WABA) accounts connected to the workspace: internal id (used by the other WABA tools), status, owner, display phone number and Meta ids.

Waba analytics, 2 operations

get_waba_analyticsGet waba analyticsGETReads a WABA analytics request started with request_waba_analytics: state is pending, ready (result holds the analytics and pricing_analytics data) or error.
request_waba_analyticsRequest waba analyticsPOSTStarts a Meta analytics request (message volume and pricing-category breakdown) for a WABA account and returns a handle; then call get_waba_analytics with it until state is ready or error.

Waba template, 2 operations

get_waba_templateGet waba templateGETReturns one WABA message template as Meta defines it (components, parameters, status) and the WABA accounts it can be sent from.
list_waba_templatesList waba templatesGETLists the workspace's WhatsApp Business message templates (any Meta status), 50 per page: id, name to send with, status, language, category.

Note, 1 operation

add_chat_noteAdd chat notePOSTAdds an internal note to a chat (private by default); notes are not sent to the WhatsApp contact. Returns data.message_uid.

Whatsapp account, 1 operation

list_whatsapp_accountsList whatsapp accountsGETLists the WhatsApp numbers connected to the workspace: account id (wid), phone, status (active or disconnected), owner and whether WhatsApp currently restricts new outreach.

Workspace, 1 operation

get_workspaceGet workspaceGETReturns the workspace id, name and plan with its seat, messaging and API call quotas and their current usage.

Use TimelinesAI from Claude Code, Cursor or Codex

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

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