首页 / 技术原理 / 当前文章
📋 配置教程

TikTok消息事件集配置完整教程
2026年最新版

2026年6月 · 汇川外链技术团队 · 阅读约10分钟

TikTok 消息事件集（Message Event Set，简称 MES）是投 TikTok → WhatsApp / Line 链路的广告主必须配置的追踪工具。但官方文档分散、步骤繁琐，很多人配了好几天仍然跑不通。

本教程完整覆盖从零开始配置 MES 的全部步骤，以及常见报错的解决方案。如果你只是想快速跑通数据而不想处理技术细节，文末有更简单的方案。

配置前提：你需要准备什么

🏢

TikTok 广告账户

需要管理员权限，个人号不行

📱

WhatsApp Business API 账户

必须是 API 版，非 App 版

🖥️

服务端开发能力

需要接入 TikTok Events API

🌐

稳定的服务器

用于接收和转发事件数据

⚠️ 重要：WhatsApp Business App（手机版应用）无法接入消息事件集。必须是通过 Meta Business 申请的 WhatsApp Business API 企业账号。

第一步：在 TikTok Ads Manager 创建消息事件集

1

进入 Events Manager

登录 TikTok Ads Manager → 顶部菜单选「工具」→「事件」→「Events Manager」。

如果没有看到这个菜单，说明你的账户还没有开通消息广告权限，需要联系 TikTok 客户经理开通。

2

创建新的事件集

点击「创建」→ 在弹出的选项中选择「消息事件集（Message Event Set）」。

注意区分：这里有「App 事件集」、「Web 像素」和「消息事件集」三个选项，选错了会导致后续配置完全不对。

3

填写基本信息

给你的消息事件集起一个名字（例如：「WhatsApp-MY-01」），选择消息平台为「WhatsApp」，点击「下一步」。

系统会生成一个 事件集 ID 和 Access Token，务必保存好这两个值，后续服务端对接时要用。

第二步：配置 WhatsApp Business API 接入

4

在 Meta Business Manager 获取 Webhook

登录 Meta Business Manager → 「WhatsApp」→「配置」→「Webhooks」。

你需要在这里注册一个 Webhook URL，指向你的服务器。当用户在 WhatsApp 里发出消息时，Meta 会向这个 URL 推送事件通知。

5

配置 Webhook 订阅的事件类型

在 Webhook 配置页面，订阅以下事件类型：

  • messages — 用户发来的消息
  • message_deliveries — 消息送达状态

你的服务器收到 messages 事件时，表示用户已经在 WhatsApp 里发了消息——这就是你需要触发 TikTok 转化事件的时机。

第三步：搭建事件中转服务器

这是整个配置中技术难度最高的部分。你的服务器需要：

  1. 接收来自广告点击的 ttclid，并与 WhatsApp 号码或对话 ID 关联存储
  2. 接收 Meta Webhook 推送的消息事件
  3. 查询对应的 ttclid，向 TikTok Events API 发送转化事件

向 TikTok 发送转化事件的请求格式

核心 API 端点：

POST https://business-api.tiktok.com/open_api/v1.3/event/track/

请求体（JSON）：

{
  "pixel_code": "你的事件集ID",
  "event": "Contact",
  "event_id": "对话唯一ID（用于去重）",
  "timestamp": "2026-06-30T10:00:00+08:00",
  "context": {
    "ad": {
      "callback": "从跳转链接中提取的ttclid"
    },
    "ip": "用户IP地址",
    "user_agent": "用户UA"
  },
  "properties": {
    "currency": "USD",
    "value": 0
  }
}

⚠️ 必填字段不能漏：event_id（去重用）、context.ad.callback（ttclid）、timestamp（ISO 8601 格式）。漏传任何一个，归因将失败。

第四步：在广告创建时关联消息事件集

6

广告系列层级设置

创建广告系列时，广告目标选择「消息（Messaging）」。这个目标下，TikTok 才会启用消息事件集的归因逻辑。

7

广告组层级设置

在广告组配置页面，「转化」部分选择「消息对话」作为优化目标，然后关联你在第一步创建的消息事件集。

广告的跳转链接需要使用 TikTok 提供的 WhatsApp 直跳 URL 格式，系统会自动附加 ttclid 参数。

第五步：测试和验证

8

用测试事件工具验证

在 TikTok Events Manager → 你的消息事件集 → 「测试事件」，可以看到实时上报的事件是否被正确接收。

测试步骤：用手机点击一条带有你广告测试链接的帖子 → 跳转到 WhatsApp → 发送一条消息 → 回到 Events Manager 查看是否有事件上报。

如果测试事件页面显示「已接收」，说明全链路跑通了。

常见报错和解决方案

错误：事件上报后 Ads Manager 没有转化数

最常见原因：ttclid 没有正确传递。检查广告跳转链接是否包含 ttclid 参数，以及服务器是否正确从 URL 中提取并存储了这个值。

错误：API 返回 40002 参数错误

通常是 pixel_code 填错了——要填消息事件集的 ID，不是 Web 像素的 ID。两者格式相似，容易混淆。

错误：事件重复计算

没有正确传 event_id。每次上报用对话的唯一 ID 作为 event_id，TikTok 会自动去重。

错误：Webhook 验证失败

Meta Webhook 注册时需要你的服务器在 GET 请求中返回 hub.challenge 参数的值。确保你的服务器处理了这个验证请求。

跳过技术配置的方案

上面这些步骤需要服务端开发能力，对非技术背景的投手来说门槛很高。汇川外链把上述所有技术细节封装在了后台，你只需要：

整个过程 5 分钟完成，无需写任何代码，也无需自己搭建服务器。

不想自己配？5分钟直接跑通

汇川外链帮你处理全部技术细节，专注投广告就好。

免费咨询 →
Home / Tech Docs / Current Article
📋 Setup Guide

TikTok Message Event Set:
Complete Setup Guide (2026)

June 2026 · Huichuan Tech Team · 10 min read

TikTok Message Event Set (MES) is the tracking system required for TikTok → WhatsApp / Line ad funnels. But the official docs are scattered, the setup is complex, and many advertisers spend days on it without getting data flowing.

This guide walks through every step of MES setup from scratch, plus solutions to common errors. If you'd rather skip the technical complexity, there's a simpler option at the end.

Prerequisites

🏢

TikTok Ads Account

Admin access required

📱

WhatsApp Business API Account

Must be API version, not App version

🖥️

Server-side Dev Capability

For TikTok Events API integration

🌐

Stable Server Infrastructure

To receive and relay event data

⚠️ Important: WhatsApp Business App (mobile app) cannot connect to Message Event Set. You need a WhatsApp Business API enterprise account registered through Meta Business.

Step 1: Create a Message Event Set in TikTok Ads Manager

1

Navigate to Events Manager

Log in to TikTok Ads Manager → top menu "Tools" → "Events" → "Events Manager."

If you don't see this menu, your account doesn't have Messaging Ads access yet. Contact your TikTok rep to enable it.

2

Create a New Event Set

Click "Create" → in the popup, select "Message Event Set." Be careful: there are three options — App Event Set, Web Pixel, and Message Event Set. Choose the wrong one and the whole setup won't work.

3

Fill in Basic Details

Name your event set (e.g., "WhatsApp-MY-01"), select "WhatsApp" as the messaging platform, click "Next."

The system generates an Event Set ID and Access Token. Save both immediately — you'll need them for the server-side integration.

Step 2: Configure WhatsApp Business API

4

Set Up a Webhook in Meta Business Manager

Log in to Meta Business Manager → "WhatsApp" → "Configuration" → "Webhooks." Register a Webhook URL pointing to your server. When users send messages in WhatsApp, Meta pushes event notifications to this URL.

5

Subscribe to the Right Event Types

Subscribe to: messages (user-sent messages) and message_deliveries (delivery status).

When your server receives a messages event, that's when you trigger a TikTok conversion event report.

Step 3: Build the Event Relay Server

This is the most technically demanding part. Your server needs to:

  1. Capture the ttclid from ad click redirects and store it linked to the WhatsApp conversation
  2. Receive Meta Webhook push events
  3. Look up the corresponding ttclid and send a conversion event to TikTok Events API

TikTok Conversion Event Request Format

POST https://business-api.tiktok.com/open_api/v1.3/event/track/

Request body:

{
  "pixel_code": "your_event_set_id",
  "event": "Contact",
  "event_id": "unique_conversation_id_for_dedup",
  "timestamp": "2026-06-30T10:00:00+08:00",
  "context": {
    "ad": {
      "callback": "ttclid_from_redirect_url"
    },
    "ip": "user_ip_address",
    "user_agent": "user_agent_string"
  },
  "properties": {
    "currency": "USD",
    "value": 0
  }
}

⚠️ Required fields: event_id (deduplication), context.ad.callback (ttclid), timestamp (ISO 8601). Missing any of these will cause attribution to fail.

Step 4: Link MES to Your Ad Campaign

6

Campaign Level Setting

When creating a campaign, set the advertising objective to "Messaging." Only under this objective does TikTok activate MES attribution logic.

7

Ad Group Level Setting

In the ad group configuration, under "Conversion," select "Message Conversations" as the optimization goal, then link your Message Event Set from Step 1.

The ad redirect URL must use TikTok's WhatsApp direct-jump URL format — the system automatically appends the ttclid parameter.

Step 5: Test and Verify

8

Use the Test Events Tool

In TikTok Events Manager → your Message Event Set → "Test Events," you can see real-time event reports.

Test flow: tap a post with your test ad link on mobile → jump to WhatsApp → send a message → check Events Manager for a received event. If "Received" shows up, the full chain is working.

Common Errors and Fixes

No conversions in Ads Manager after event reporting

Most likely cause: ttclid not passed correctly. Check that your ad redirect URL contains the ttclid parameter and that your server correctly extracts and stores it.

API returns 40002 parameter error

Usually means the wrong ID is in pixel_code — it should be the Message Event Set ID, not a Web Pixel ID. The formats look similar, easy to mix up.

Duplicate event counting

event_id not being passed correctly. Use the conversation's unique ID as event_id on every report. TikTok deduplicates automatically.

Webhook verification failing

When registering a Meta Webhook, your server must return the hub.challenge value in a GET request. Make sure your server handles this verification step.

Skip the Technical Setup

All of the above requires server-side development skills. Huichuan encapsulates all of it in a dashboard — no coding required:

Done in 5 minutes. No server needed.

Skip the Setup — Start Tracking in 5 Minutes

Huichuan handles all the technical plumbing. You focus on running ads.

Free Consultation →