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

# TikTok integration

> Connect TikTok for Lead Ads, messaging, and workflow triggers in the HoopAI platform.

The TikTok integration connects your TikTok Business account to the HoopAI platform for lead capture, messaging, and ad reporting.

## TikTok Lead Ads setup

<Steps>
  <Step title="Connect your TikTok account">
    Go to **Settings > Integrations > TikTok Ads**. Click **Connect** and log in with your TikTok Business account. Select the ad account to connect and grant permissions.
  </Step>

  <Step title="Create a lead form in TikTok Ads Manager">
    In TikTok Ads Manager, create a campaign with the Lead Generation objective. Build your lead form with the fields you want to capture — name, email, phone, and custom questions.
  </Step>

  <Step title="Map form fields">
    In **Settings > Integrations > TikTok**, click **Form Field Mapping**. Map each TikTok form field to the corresponding CRM contact field.
  </Step>

  <Step title="Publish and test">
    Publish your lead ad campaign. Use TikTok's testing tools to submit a test lead and verify it appears in your CRM.
  </Step>
</Steps>

## TikTok messaging integration

Connect TikTok Direct Messages (DMs) to manage conversations from TikTok directly in the HoopAI Conversations inbox.

<Steps>
  <Step title="Enable TikTok messaging">
    In the TikTok integration panel, enable the **Messaging** toggle for your connected account.
  </Step>

  <Step title="Verify in Conversations">
    Open **Conversations** and confirm that TikTok appears as a channel filter. Incoming TikTok DMs will appear alongside your other messaging channels.
  </Step>
</Steps>

<Note>
  TikTok messaging availability depends on your TikTok Business account type and region. Not all TikTok accounts support the messaging API.
</Note>

## Workflow triggers

Once TikTok is connected, you can use these workflow triggers:

* **TikTok Lead Ad submitted** — fires when a new lead is captured through a TikTok Lead Ad form
* **TikTok message received** — fires when a new DM is received from TikTok (if messaging is enabled)

Use these triggers to automate lead follow-up, assign contacts to pipelines, send welcome messages, or enroll contacts in nurture sequences.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Leads not importing from TikTok">
    Verify that form field mapping is complete. Check that the TikTok ad campaign is active and the lead form is published. Disconnect and reconnect the integration to refresh the token.
  </Accordion>

  <Accordion title="TikTok DMs not appearing">
    Confirm that the messaging toggle is enabled in the integration settings. Verify your TikTok Business account supports the messaging API. Check that permissions were fully granted during connection.
  </Accordion>

  <Accordion title="Connection expired">
    TikTok access tokens expire periodically. Reconnect by going to **Settings > Integrations > TikTok** and clicking **Reconnect**.
  </Accordion>
</AccordionGroup>

***

## Related articles

* [Integrations overview](/settings/integrations)
* [Ad manager](/marketing/ad-manager)
* [Workflow triggers](/automation/workflow-triggers)