> ## Documentation Index
> Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Lead Generation

> Turn the leads from your TikTok ads, Instant Forms and message ads alike, into contacts, reply on WhatsApp the moment a lead arrives, and keep every lead's outcome.

TikTok Lead Generation turns the leads from your TikTok ads into Ciarem contacts: both the Instant Forms people fill in and the leads TikTok extracts from your message ads. You choose where each form answer lands, and can send a WhatsApp template to every new lead the moment they arrive. Admins set it up under **Settings > Integrations > TikTok Lead Generation**.

> [!NOTE]
>
> TikTok keeps leads for 90 days. Ciarem receives each lead as it arrives and stores it, so your contacts outlive that window.

## Connect an ad account

Leads belong to a TikTok ad account, so you connect the ad accounts that run your lead ads.

**1. Open TikTok Lead Generation**

Go to **Settings**, then **Integrations**, and click **Connect** on the TikTok Lead Generation card.

**2. Sign in to TikTok for Business**

Sign in with a TikTok for Business account that manages the ad accounts, and authorize Ciarem.

**3. Pick your ad accounts**

Tick every ad account that runs your lead ads and click **Connect**. You can add more later with **Connect ad account**.

**4. Check your forms**

The ad account's Instant Forms appear under **Lead forms**. A form you publish later in TikTok Ads Manager shows up there too. Click **Refresh** if you don't see it yet.

An ad account can only be connected to one Ciarem workspace. Signing in again later refreshes the access of the accounts you already connected; keep them ticked.

## Lead forms

The **Lead forms** table shows, for each form, its submissions, the contacts created, and how many need attention. Submissions that didn't become a contact usually point to a mapping problem. A form shows **Ready** when every question has a destination, or how many questions are still unmapped.

Every ad account also has a **Direct messages** row. These are the leads TikTok extracts from your message ads: there is no form, so only the name, email and phone number can arrive. You can pause them and give them an auto-reply like any form.

## Map the questions

Open a form to choose where each answer lands, under **Question mapping**. Standard questions such as name, email, and phone map on their own. Custom questions need a destination: a contact field or a custom property. Click **Save changes**. A mapping change applies to new leads only; leads already received keep the mapping they arrived with.

When a question lands in a property with options, each answer goes to the option with the same label. TikTok doesn't share a question's answer choices with Ciarem, so a property you create from a question is a text property.

To pause a form, turn off **Create contacts from this form**. Its submissions are still saved, but no contacts are created while it's off.

## How leads match your contacts

A lead needs an email or a phone number to become a contact. Ciarem first looks for a contact with the same email, then one with the same phone:

* **No match**: Ciarem creates a new contact, with the TikTok ad as its origin.
* **Match**: the lead's name, email, and phone only fill fields that are empty on the contact, so nothing your team or the AI agent already set is replaced. Custom properties you mapped are updated with the newest lead's answers. An empty answer never clears a property.

A lead with neither an email nor a phone number isn't imported. It shows in the form's submission history with the reason.

## When a new lead arrives

* **Auto-reply template**: pick an approved WhatsApp [template](https://help.ciarem.ai/channels/message-templates.md) and it is sent to every new lead on this form as soon as they arrive. Each send is charged to your WhatsApp wallet at Meta's rate, like any template.
* **Create a follow-up task when the auto-reply can't be sent**: when this is on and no auto-reply goes out, either because no template is chosen or because it couldn't be sent, Ciarem creates a [task](https://help.ciarem.ai/using-ciarem/tasks.md) due 24 hours after the lead arrived, for the contact's owner. A new lead usually has no owner yet, so admins find the task under **No owner**.

The auto-reply is skipped when the lead has no phone number, the number isn't on WhatsApp, the template is missing a required value, your wallet balance is too low, the line's messaging limit is reached, or the template's WhatsApp line was disconnected. Each skip is shown with its reason.

## Submission history

Each form keeps a **Submission history** with every lead's outcome: the contact it created or updated, whether the auto-reply was sent, and why a lead didn't become a contact.

## Disconnect an ad account

**Disconnect** stops new leads from that ad account from creating contacts. Your form mappings are kept and apply again if you reconnect.

## Troubleshooting

### My ad account isn't in the list

TikTok only lists the ad accounts the account you signed in with can manage. Sign in with a TikTok for Business account that has access to the ad account, then click **Connect ad account** again.

### "This TikTok ad account is already connected to another workspace"

An ad account can only send its leads to one Ciarem workspace. Disconnect it from the other workspace first, then connect it here.

### "We can no longer read this ad account's lead forms"

Ciarem lost access to the ad account. This usually happens when the access was revoked in TikTok for Business or the person who connected it lost their role on the ad account. Click **Reconnect** and sign in again.

### Leads aren't arriving

* Check the form's **Submission history**. If the lead is there, its outcome says why it didn't become a contact. The usual causes are a paused form or a lead with no email and no phone number.
* If the lead isn't there at all, check that the ad account shows as connected with no **Reconnect** warning.
* Leads submitted before you connected the ad account aren't imported.

Running Facebook or Instagram ads too? See [Meta Lead Ads](https://help.ciarem.ai/integrations/meta-lead-ads.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.