🧩 Product Overview
TimelinesAI bridges WhatsApp communications with external systems like CRMs, enabling automation and synchronization of messages, chats, files, and chat lifecycle events. You can capture incoming/outgoing messages, send messages/files via existing chats, and find messages or chats programmatically.
⚠️ Important Note for Contributors
This feature must be submitted as a Piece following the Activepieces architecture. Submissions not following this format will not be accepted. Please make sure to review the Piece Development Guidelines before starting development.
🚨 Triggers
| Trigger |
Description |
Use Case |
| Chat Closed |
Fires when a chat is closed. |
When support is done, trigger follow-ups or archive workflows. |
| New Outgoing Chat |
Fires when a new outgoing chat is initiated. |
When your system opens a new chat (e.g. to a new customer), trigger processes. |
| New Incoming Chat |
Fires when a new incoming chat (i.e. from a user) is created. |
On first user message (new chat), initiate welcome sequence. |
| New Sent Message |
Fires when a message is sent (outgoing). |
After sending a message, log it in CRM or analytics. |
| New Received Message |
Fires when a message is received (incoming). |
Forward incoming messages to ticketing or notification flows. |
| New Uploaded File |
Fires when a new file is uploaded in a chat. |
Trigger workflows when attachments or media are received. |
| Chat Renamed |
Fires when a chat is renamed. |
Update internal records or titles when chat metadata changes. |
| New WhatsApp Account |
Fires when a new WhatsApp account is added/registered. |
Onboard a new WhatsApp number into automation flows. |
🛠️ Write Actions
| Action |
Description |
| Send Message to Existing Chat |
Sends a text message in a chat identified by chat_id |
| Send Uploaded File to Existing Chat |
Send a file (media/attachment) to a chat, with metadata like file name, via existing chat. |
| Send File to Existing Chat |
Similar to above: send a file attachment to a chat using URL or file input and name. |
| Send Message to New Chat |
Create a new chat (new conversation) by specifying the WhatsApp account, phone number, and message. |
| Close Chat |
Programmatically mark a chat as closed by its chat_id. |
🔍 Search Actions
| Action Name |
Description |
| Find Chat |
Look up a chat by parameters such as chat_id, phone, name, etc. |
| Find Message |
Lookup a message by its WhatsApp message ID. |
| Find Uploaded File |
Locate an uploaded file by filename or identifier. |
| Find Message Status |
Lookup a message’s delivery status by message ID. |
| Find WhatsApp Account |
Search for a WhatsApp account (by phone or ID). |
📚 API Reference
🧪 Test Account Access
🧑💻 New to Activepieces?
Activepieces is the leading open source AI automation platform. We have many apps (we call them Pieces), that are available within the builder and as MCPs. These apps are build with our TypeScript framework and are easy to build. Once they're merged to our repo, they will available as pieces in our automation builder and as MCPs to be used with AI agents and MCP clients.
We welcome contributions and in fact, we get excited over them. Start your journey here: https://www.activepieces.com/docs/developers/building-pieces/overview
🧩 Product Overview
TimelinesAI bridges WhatsApp communications with external systems like CRMs, enabling automation and synchronization of messages, chats, files, and chat lifecycle events. You can capture incoming/outgoing messages, send messages/files via existing chats, and find messages or chats programmatically.
⚠️ Important Note for Contributors
This feature must be submitted as a Piece following the Activepieces architecture. Submissions not following this format will not be accepted. Please make sure to review the Piece Development Guidelines before starting development.
🚨 Triggers
🛠️ Write Actions
chat_idchat_id.🔍 Search Actions
📚 API Reference
🧪 Test Account Access
🧑💻 New to Activepieces?
Activepieces is the leading open source AI automation platform. We have many apps (we call them Pieces), that are available within the builder and as MCPs. These apps are build with our TypeScript framework and are easy to build. Once they're merged to our repo, they will available as pieces in our automation builder and as MCPs to be used with AI agents and MCP clients.
We welcome contributions and in fact, we get excited over them. Start your journey here: https://www.activepieces.com/docs/developers/building-pieces/overview