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

# 创建活动

> 在此部分，您可以创建和配置自动化通知或呼叫活动，这些活动将由机器人使用之前创建的模板执行。

<img src="https://mintcdn.com/lovi/Knq0_jkn8h7nw8oT/images/CreateCampaignForm.png?fit=max&auto=format&n=Knq0_jkn8h7nw8oT&q=85&s=46c684c8ca6c5fad5c7fb7c58441c6b4" alt="创建活动表单" width="1690" height="782" data-path="images/CreateCampaignForm.png" />

这里是一切汇聚的地方：受众（您的 CSV）、消息（您的模板）和确切时刻。

此表单是您的**发射中心**。我们将逐个字段配置，以确保消息在正确的时间到达正确的人。

***

### 📝 1. 发射配置（字段）

填写这些详情以定义活动的身份：

* **电话号码：** 选择消息将从中发送的号码。如果您有几个（销售、支持），请仔细选择。
* **通知模板：** 选择您的已批准模板之一。

  * *注意：* 只有从 Meta 获得绿灯的模板（状态：*已批准*）才会出现。
* **活动名称：** 供您自己参考的名称。比如 `Summer_Promo_2024`。
* **事件名称：** 事件的技​​术标识符。如果您使用 webhook 或外部集成来跟踪此特定活动何时启动，这很有用。

***

### ⏰ 2. 时间因素（调度）

时间是相对的，但在营销中它是至关重要的。

* **时区：** **非常重要！** 🌍 选择正确的时区。您不想因为选择了错误的时区而在凌晨 3:00 发送"早上好"消息。
* **发送日期：** 设置发送的确切日期和时间。

  * 系统将安排在那精确时刻交付。

***

### 👥 3. 受众（用户 CSV）

这里是您上传**客户**列表的地方 😄

您必须上传一个 **.CSV** 文件（最大 4MB），其中包含您想要联系的人员的详细信息。

#### ⚠️ CSV 的黄金规则：

为了使一切正常工作，您的 Excel/CSV 必须遵循一个神圣规则：

1. **`number` 列（必需）：** 必须有一个恰好称为 `number` 的列，其中包含带有国家代码的电话号码（例如 `447700900123`）。如果没有此列，系统不知道该联系谁。
2. **变量列（可选）：** 如果您的模板说"Hello `{{name}}`"，您的 CSV 必须有一个名为 `name` 的列。系统将使用每行中的数据自动填补空白。

***

### 👁️ 4. 验证（模板）

在最底部您将看到**模板**部分。

它不可编辑；它只是一个**视觉提醒**，以便您确认："啊，是的，这就是我要发送的模板。" 确保它符合您的预期。

***

### ❗ 5. 错误："Params Words Ratio Exceeds Limit"（具有太多变量的模板）

偶尔，在保存或验证模板/活动时，您可能会遇到类似于屏幕截图中所示的错误：

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lovi/mnt/data/f385a90c-187c-493d-a9de-a86f2b4ee98e.png" alt="错误屏幕截图" />

错误消息通常类似于：

> *无效参数 - OAuthException - Params Words Ratio Exceeds Limit - 此模板的变量太多。减少变量数量或增加消息长度。*

**这意味着什么？**

Meta (WhatsApp) 强制执行关于模板中变量数量与消息总长度之间比率的规则。如果模板包含相对于总字数的变量太多，验证可能会失败。

**该怎么做（快速步骤）：**

1. 查阅官方商业消息错误代码以了解确切原因和代码：[https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)

2. 检查模板并减少不必要的变量：

   * 在上传前将 CSV 中的字段合并到单个列中（例如，使用 `full_name` 而不是 `first_name` + `last_name`）。
   * 用单个更广泛的变量替换多个小变量（例如，`{{1}}` = "John Smith, VIP 客户"）。

3. 如果可能，增加消息的长度（添加非敏感描述性文本），以改善字数与变量的比率。

4. 如果您确实需要许多变量，请考虑创建几个变量较少的模板，并为每个细分选择最合适的模板。

5. 在生产前，使用 staging 环境或受控数量的电话号码测试模板。

**实用提示：**

* 避免对可以直接在模板中写入的常量内容使用变量。
* 验证 CSV：确保变量列名与模板引用的名称完全匹配。
* 在您的模板库中添加一个简短的技术注释（例如："使用字段：full\_name, order\_id"），以便准备 CSV 的同事正确执行。

***

### 🚀 发射！（保存）

当您点击**保存**时，活动将被**调度**。

它不会立即发出（除非您选择了当前时间）；相反，它将耐心等待在队列中直到 `发送日期`。

您可以转到**活动**模块（我们之前看到的那个）来查看它，状态为"待处理"，直到它的时间到来。

**一切就绪！配置它，上传您的列表，然后等待结果。📈**
