TimelinesAI Integration for ActiveCampaign

Overview

The TimelinesAI integration allows you to automatically send WhatsApp messages to your contacts when they enter an ActiveCampaign automation. Perfect for:

Welcome messages to new leads
Appointment reminders
Order confirmations
Follow-up sequences
VIP customer communications

Prerequisites

Before you begin, make sure you have:

[ ] An active TimelinesAI account (Sign up here)
[ ] At least one WhatsApp number connected to TimelinesAI
[ ] An ActiveCampaign account (any plan)
[ ] Your TimelinesAI API token

Getting Your API Token

Log in to TimelinesAI
Go to Integrations → Public API
Copy your API token

⚠️ Keep your API token secure. Do not share it publicly.

Setup Guide

Step 1: Install the Integration

In ActiveCampaign, go to Apps in the left sidebar
Search for TimelinesAI
Click Add to install the integration

Step 2: Connect Your Account

Click Connect on the TimelinesAI app
Enter your API Token from TimelinesAI
Click Connect

Once connected, you'll see your TimelinesAI account information displayed.

Step 3: Add to an Automation

Open an existing automation or create a new one
Add a new action by clicking the + button
Select CX Apps → TimelinesAI
Choose Send WhatsApp Message

Step 4: Configure Message Settings

Configure the following fields:

Field	Required	Description
WhatsApp Account	Yes	Select which connected WhatsApp number to send from
Message Text	Yes	The message content (supports personalization)
Label	No	Assign a label to the chat in TimelinesAI
Chat Name	No	Set a custom name for the chat

Step 5: Map the Phone Number

Map an ActiveCampaign contact field to the recipient phone number:

In the Mapping section, find Recipient Phone Number
Select the ActiveCampaign field containing the contact's phone number (usually Phone)
Click Finish

Using Personalization

Make your messages personal by inserting contact fields. Click the Personalize button when editing the message text.

Available fields include:

{{contact.first_name}} - Contact's first name
{{contact.last_name}} - Contact's last name
{{contact.email}} - Contact's email
{{contact.phone}} - Contact's phone number
Any custom fields you've created

Example message:

Hi {{contact.first_name}}! 👋  Thanks for signing up. We're excited to have you!  Reply to this message if you have any questions.

Labels and Chat Organization

Use the optional Label field to automatically organize chats in TimelinesAI:

Labels appear in the TimelinesAI sidebar for easy filtering
If the label doesn't exist, it will be created automatically
Great for segmenting: lead, customer, vip, support

Phone Number Format

For best results, store phone numbers in international format:

Format	Example	Recommended
International with +	`+14155551234`	✅ Yes
International without +	`14155551234`	✅ Yes
Local format	`(415) 555-1234`	⚠️ May not work

💡 Tip: Always include the country code for reliable delivery.

Troubleshooting

Connection Issues

Problem	Solution
"Invalid token" error	Verify your API token is correct. Copy it again from TimelinesAI → Integrations → Public API
"Connection failed"	Check that your TimelinesAI account is active and has at least one connected WhatsApp number
No WhatsApp accounts in dropdown	Connect a WhatsApp number in TimelinesAI first

Message Delivery Issues

Problem	Solution
Message not received	Verify the phone number format includes country code
"Phone number invalid" error	Ensure the phone field contains a valid international number
Message shows as "queued"	TimelinesAI adds a ~2 second delay between messages to prevent spam detection. The message will be sent shortly.

WhatsApp-Specific Issues

Problem	Solution
Recipient didn't get the message	The recipient must have WhatsApp installed and active on that phone number
Message marked as failed	Check if your WhatsApp session is still connected in TimelinesAI
Rate limit error	You may have exceeded your message quota. Check your TimelinesAI plan limits