Communication

Timelinesai

Learn how to use Timelinesai with Composio

Overview

SLUG: TIMELINESAI

Description

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

Authentication Details

bearer_token
stringRequired

Connecting to Timelinesai

Create an auth config

Use the dashboard to create an auth config for the Timelinesai toolkit. This allows you to connect multiple Timelinesai accounts to Composio for agents to use.

1

Select App

Navigate to Timelinesai.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Timelinesai Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4timelinesai_auth_config_id = "ac_YOUR_TIMELINESAI_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": user_api_key}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Timelinesai for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, timelinesai_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Timelinesai toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["TIMELINESAI"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Delete File

Description

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

Action Parameters

file_uid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Chats

Description

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

Action Parameters

assignee_id
string
created_since
string
has_label
boolean
has_open_task
boolean
integration_id
string
is_archived
boolean
is_assigned
boolean
is_followed
boolean
is_muted
boolean
is_unread
boolean
label_id
string
limit
integer
offset
integer
person_id
string
search
string
sort_direction
string
sort_field
string
team_member_id
string
types
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get File Details

Description

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

Action Parameters

file_uid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Webhook

Description

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

Action Parameters

webhook_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Webhook

Description

Tool to retrieve details of a specific webhook subscription. use after confirming the webhook id.

Action Parameters

webhook_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Webhooks

Description

Tool to list all webhook subscriptions for the workspace. use when you need to retrieve configured webhooks, optionally with pagination.

Action Parameters

limit
integer
offset
integer

Action Response

data
arrayRequired
error
string
limit
integerRequired
offset
integerRequired
successful
booleanRequired
total
integerRequired

Tool Name: Get WhatsApp Accounts

Description

Tool to list all whatsapp accounts connected to the workspace. use after configuring whatsapp integration to verify accounts.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Uploaded Files

Description

Tool to list files uploaded in your timelinesai workspace. use when you need to retrieve all uploaded files.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Webhook Subscription

Description

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

Action Parameters

event_type
stringRequired
secret
string
url
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Webhook

Description

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.

Action Parameters

enabled
boolean
event_types
arrayRequired
url
Required
webhook_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired