# TimelinesAI

TimelinesAI enables teams to manage and automate WhatsApp communications, integrating with various CRMs and tools to streamline workflows.

- **Category:** communication
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 13
- **Triggers:** 1
- **Slug:** `TIMELINESAI`
- **Version:** 20260424_00

## Tools

### Delete File

**Slug:** `TIMELINESAI_DELETE_FILE`

Tool to delete an uploaded file by its UID. Use after confirming the file is no longer needed.

### Delete Webhook

**Slug:** `TIMELINESAI_DELETE_WEBHOOK`

Tool 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'."

### Get Chat Messages

**Slug:** `TIMELINESAI_GET_CHAT_MESSAGES`

Tool 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'."

### Get Chats

**Slug:** `TIMELINESAI_GET_CHATS`

Tool 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."

### Get File Details

**Slug:** `TIMELINESAI_GET_FILE_DETAILS`

Tool to retrieve metadata and temporary download URL for an uploaded file. Use after uploading a file or when needing its URL.

### Get Webhook

**Slug:** `TIMELINESAI_GET_WEBHOOK`

Retrieves 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.

### Get Webhooks

**Slug:** `TIMELINESAI_GET_WEBHOOKS`

Retrieves 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.

### Get WhatsApp Accounts

**Slug:** `TIMELINESAI_GET_WHATSAPP_ACCOUNTS`

Tool to list all WhatsApp accounts connected to the workspace. Use after configuring WhatsApp integration to verify accounts.

### List Uploaded Files

**Slug:** `TIMELINESAI_LIST_UPLOADED_FILES`

Tool to list files uploaded in your TimelinesAI workspace. Use when you need to retrieve all uploaded files.

### Send WhatsApp Message to Number

**Slug:** `TIMELINESAI_POST_MESSAGE`

Tool 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.

### Create Webhook Subscription

**Slug:** `TIMELINESAI_POST_WEBHOOK`

Tool to create a new webhook subscription. Use when you have the event type and callback URL ready.

### Update Webhook

**Slug:** `TIMELINESAI_PUT_WEBHOOK`

Tool 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.

### Send Message to Chat

**Slug:** `TIMELINESAI_SEND_MESSAGE`

Send 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'."


## Triggers

### New WhatsApp Message Received

**Slug:** `TIMELINESAI_NEW_MESSAGE_RECEIVED`

**Type:** poll

Polling trigger that monitors for new messages received in TimelinesAI WhatsApp chats.

#### Configuration

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chat_id` | string | No | Filter messages from a specific chat ID. If not provided, all chats will be monitored |
| `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes |
| `is_unread` | boolean | No | If true, only unread messages will be included |
| `limit` | integer | No | Maximum number of messages to fetch per polling cycle |

#### Payload

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chat_id` | string | Yes | ID of the chat the message belongs to |
| `event_type` | string | No | Type of event that triggered |
| `message_id` | string | Yes | Unique identifier of the message |
| `message_type` | string | No | Type of message (text, media, etc.) |
| `sender` | object | No | Details of the message sender |
| `text` | string | No | Content of the message |
| `timestamp` | string | Yes | ISO-8601 timestamp when message was sent |