> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Mailchimp

接待员可以帮来电者订阅邮件列表。它会确认对方的邮箱地址，然后通过 Mailchimp 的 Marketing API 将其添加到 Mailchimp 受众。Mailchimp 会在订阅前向每位新联系人发送确认邮件。

## 开始前

需要从 Mailchimp 获取以下值：

| 值          | 获取位置                                                                            |
| ---------- | ------------------------------------------------------------------------------- |
| **API 密钥** | 个人资料 → **Extras** → **API keys** → **Create A Key**                             |
| **服务器前缀**  | API 密钥中连字符后的部分，例如 `us21`                                                        |
| **受众 ID**  | **Audience** → **All contacts** → **Settings** → **Audience name and defaults** |

Mailchimp 使用 HTTP 基本认证验证 API 密钥。请在电脑上构建请求头值：

```bash
printf 'reception:YOUR_API_KEY' | base64
```

## 创建 webhook 工具

前往 **Integrations**，选择 **Add integration**，然后选择 **Webhook Tool**。

| 字段         | 值                                                                          |
| ---------- | -------------------------------------------------------------------------- |
| **名称**     | `add_to_mailing_list`                                                      |
| **描述**     | “将来电者添加到邮件列表。仅当来电者要求加入并逐个字母确认邮箱地址后使用。”                                     |
| **方法**     | POST                                                                       |
| **URL**    | `https://SERVER_PREFIX.api.mailchimp.com/3.0/lists/AUDIENCE_ID/members`    |
| **请求头**    | 将 `Authorization` 设为 `Basic `，后接编码后的值                                      |
| **请求体参数**  | `email_address`（字符串，必填）：“来电者的邮箱地址。”  `status`（字符串，必填）：“始终使用精确值 `pending`。” |
| **分配给智能体** | **Receptionist**                                                           |

选择 **Enable**，然后[测试接待员](/docs/zh/reception-ai/receptionist/testing)，要求订阅邮件列表。在对方确认邮件前，该联系人会在受众中显示为 **Pending**。

> **Warning**
>
> `pending` 会发送 Mailchimp 的订阅确认邮件。来电者在电话中同意并不代表在所有国家都属于
> 书面同意，因此除非确定不需要，否则请保留双重确认订阅。

该工具仅发送顶层字段，因此无法填写 Mailchimp 放在 `merge_fields` 下的名字等合并字段。若要添加这些字段，请改为通过 [Zapier](/docs/zh/reception-ai/integrations/zapier) 路由订阅请求。

## 故障排除

| 问题                 | 检查内容                                  |
| ------------------ | ------------------------------------- |
| Mailchimp 返回 401   | 重新编码请求头值，并检查 URL 中的服务器前缀是否与 API 密钥匹配。 |
| Mailchimp 返回 404   | 检查 URL 中的受众 ID。                       |
| `Member Exists`    | 该地址已在列表中。接待员可以告知来电者其已订阅。              |
| `Invalid Resource` | 邮箱地址格式不正确。请让接待员在提交前向来电者复述地址拼写。        |