NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
TimelinesAI connects to a Nagent workspace with an API key. Once it is connected, agents can call 13 TimelinesAI actions, such as "Get Chat Messages", "Get Chats" and "Get File Details". It also has 1 trigger, "New WhatsApp Message Received", which can start agent work when that TimelinesAI event happens. Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Each TimelinesAItrigger shows its configuration parameters and the payload your agent receives. A trigger fire is checked against the agent's level and logged, the same as work a person asked for.
TIMELINESAI_NEW_MESSAGE_RECEIVEDPolling trigger that monitors for new messages received in TimelinesAI WhatsApp chats.
Configuration
Filter messages from a specific chat ID. If not provided, all chats will be monitored
Periodic Interval to Check for Updates & Send a Trigger in Minutes
If true, only unread messages will be included
Maximum number of messages to fetch per polling cycle
Payload
ID of the chat the message belongs to
Type of event that triggered
Unique identifier of the message
Type of message (text, media, etc.)
Details of the message sender
Content of the message
ISO-8601 timestamp when message was sent
Every operation an agent can call against TimelinesAI, with input parameters and output schema.
TIMELINESAI_DELETE_FILETool to delete an uploaded file by its UID. Use after confirming the file is no longer needed.
Input parameters
Unique identifier of the file to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_DELETE_WEBHOOKTool to delete a webhook subscription by its ID. Use when you need to remove an existing webhook after confirming the webhook ID. Example: "Delete the webhook with ID '9f6a8c3d-56b7-4a1e-8f2e-abcdef123456'."
Input parameters
Unique identifier of the webhook subscription to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_GET_CHAT_MESSAGESTool to get messages from a specific chat in TimelinesAI. Use when you need to retrieve message history or recent messages from a chat. Example: "Get the last 20 messages from chat 'chat_123abc'."
Input parameters
Maximum number of messages to return
Number of messages to skip before returning results
Unique identifier of the chat to retrieve messages from
Get messages after this message ID (for pagination)
Get messages before this message ID (for pagination)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_GET_CHATSTool to get full or filtered list of all chats. Use when you need to browse or search chats with optional filters. Example: "List all unread chats assigned to me."
Input parameters
Maximum number of chats to return
List of chat types to include (e.g., \['group', 'direct'\])
Number of chats to skip before returning results
Search term to filter chats by name or content
If true, only chats that are muted
Filter chats by the specified label ID
If true, only chats that have at least one label
If true, only chats with unread messages are returned
Filter chats by the associated person ID
Field by which to sort results (e.g., 'createdAt')
Filter chats by the specified assignee ID
If true, only archived chats will be returned
If true, only chats that have been assigned
If true, only chats followed by the current user
ISO 8601 date string; return chats created after this timestamp
If true, only chats with open tasks
Filter chats by the specified integration ID
Sort order: 'asc' (ascending) or 'desc' (descending)
Filter chats involving the specified team member ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_GET_FILE_DETAILSTool to retrieve metadata and temporary download URL for an uploaded file. Use after uploading a file or when needing its URL.
Input parameters
Unique identifier of the file to retrieve details for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_GET_WEBHOOKRetrieves detailed information about a specific webhook subscription by its ID. Use this action to: - Check webhook configuration (URL, event type, enabled status) - Monitor webhook health (error counter) - Verify webhook existence before updating or deleting Prerequisites: You must have a valid webhook ID. Use the Get Webhooks action to list all available webhooks first.
Input parameters
The unique webhook ID (numeric string). Use Get Webhooks action to list all available webhook IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_GET_WEBHOOKSRetrieves all webhook subscriptions configured for the workspace. Webhooks notify external systems about events (e.g., 'message:new', 'chat:new') in real-time. Use this to view existing webhook configurations, check their status, or retrieve webhook IDs for updates/deletion. Supports optional pagination via limit and offset parameters.
Input parameters
Maximum number of webhooks to return per page
Number of webhooks to skip before returning results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_GET_WHATSAPP_ACCOUNTSTool to list all WhatsApp accounts connected to the workspace. Use after configuring WhatsApp integration to verify accounts.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_LIST_UPLOADED_FILESTool to list files uploaded in your TimelinesAI workspace. Use when you need to retrieve all uploaded files.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_POST_MESSAGETool to send a WhatsApp text message to a phone number via TimelinesAI. Use this to send messages to any recipient phone number using one of your connected WhatsApp accounts as the sender. The message will be delivered immediately if the recipient number is reachable on WhatsApp. Example: Send 'Hello, how can I help you today?' from +15105566777 to +14151231234.
Input parameters
Message text to send. Note: text length is limited by the WhatsApp platform (currently 65,534 characters).
Recipient's phone number in international format with a leading '+' and country code.
Your sender WhatsApp number in international format with a leading '+' and country code. This must be a WhatsApp account that is already connected to your TimelinesAI workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_POST_WEBHOOKTool to create a new webhook subscription. Use when you have the event type and callback URL ready.
Input parameters
The HTTP endpoint URL that will receive webhook payloads.
Optional secret used to sign webhook payloads (HMAC).
Event type to subscribe to. Valid values: 'message:new', 'message:sent:new', 'message:received:new', 'whatsapp:account:connected', 'whatsapp:account:disconnected', 'whatsapp:account:suspended', 'whatsapp:account:resumed', 'chat:new', 'chat:incoming:new', 'chat:outgoing:new', 'chat:responsible:assigned', 'chat:responsible:unassigned'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_PUT_WEBHOOKTool to update an existing webhook subscription. Use after confirming the webhook ID when you need to change the URL, subscribed event types, or enable/disable a webhook.
Input parameters
The URL endpoint that will receive webhook event notifications
Whether the webhook should be active. If omitted, current state is preserved
Single event type to subscribe to. Common types: 'message:new', 'chat:new', 'message:received:new', 'message:sent:new', 'chat:incoming:new', 'chat:outgoing:new', 'chat:responsible:assigned', 'chat:responsible:unassigned', 'whatsapp:account:connected', 'whatsapp:account:disconnected'
Unique identifier of the webhook subscription to update (numeric ID as string)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELINESAI_SEND_MESSAGESend a WhatsApp message to an existing chat in TimelinesAI. Use this action when you have a chat ID from the Get Chats action and want to send a message to that conversation. For sending messages to new phone numbers (not existing chats), use the 'Send WhatsApp Message to Number' action instead. Example: "Send message 'Hello world' to chat with ID 'chat_123abc'."
Input parameters
Unique identifier of the chat to send the message to. Obtain this from the Get Chats action.
The text message to send. Maximum length: 65,534 characters (WhatsApp platform limit).
Type of message to send. Common values: 'text' for text messages, 'media' for media messages. Defaults to 'text'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 13 TimelinesAI actions on Nagent, including "Get Chat Messages", "Get Chats" and "Get File Details". Get Chat Messages: Get messages from a specific chat in TimelinesAI. Each action is listed on this page with its input parameters and its output.
TimelinesAI connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Yes. TimelinesAI has 1 trigger on Nagent, "New WhatsApp Message Received", a poll trigger. A trigger fire is checked against the agent's level and logged, the same as work a person asked for.
Get Chat Messages takes 1 required input: chat_id. It also takes 4 optional inputs: limit, offset, after_message_id and before_message_id. It returns data, error and successful.