---
title: "连接 Agillic"
description: "在 Agillic 中创建 API 密钥，使用开发者密钥和 Secret 完成连接，并使用你选择的字段创建或更新收件人。"
url: https://scratcher.io/zh/help/integrations/agillic
language: zh-Hans
---

1. [帮助中心](https://scratcher.io/zh/help)
2. [集成](https://scratcher.io/zh/help/integrations)
3. 连接 Agillic

# 连接 Agillic

在 Agillic 中创建 API 密钥，使用开发者密钥和 Secret 完成连接，并使用你选择的字段创建或更新收件人。

通过 Agillic 集成，每位注册用户都会在 Agillic 中被创建或更新为收件人。此处 Agillic 不使用列表：收件人会添加到你的 Agillic 数据中，你可以在 Agillic 中构建目标群组。

## 准备工作

- 一个位于 Agillic 欧洲平台上的 Agillic 账户，以及一位可以创建 API 密钥的用户（通常是管理员）。

## 第 1 步：在 Agillic 中创建 API 密钥

1. 在 Agillic 中打开 **Settings**，找到 API 密钥（API credentials）。
2. 创建一个新密钥，并为其起一个易于识别的名称，例如“Scratcher”。
3. 复制 **Developer key**（也称为 API key）和 **Secret**。Secret 只会显示一次。

## 密钥所需的权限

Scratcher 使用该密钥读取你的个人数据字段、按电子邮件查找收件人，以及创建和更新收件人。如果 Agillic 允许限制密钥权限，则该密钥需要收件人的读写权限以及个人数据的读取权限。无需其他权限。

## 第 2 步：将 Agillic 连接到 Scratcher

1. 在 Scratcher 中，前往**设置** > **集成**，然后点击 **Agillic**。
2. 粘贴**开发者密钥**和 **Secret**。
3. 点击**安装集成**。Scratcher 会登录 Agillic 以验证它们。

## 第 3 步：在活动中启用

1. 在编辑器中，前往**连接** > **集成** > **Agillic**，然后点击**激活**。
2. 如果你连接了多个账户，请在**选择账户**下选择要使用的账户。
3. 在**字段映射**下，将每个 **Scratcher 字段**与一个 Agillic 个人数据字段对应起来。
4. 在**唯一电子邮件字段**下，选择你在 Agillic 中用于电子邮件的字段：“选择你在 Agillic 中用于电子邮件的字段（请确保该字段在 Agillic 中也是唯一的）”。列表中只显示唯一的文本字段。如果留空，Scratcher 将使用 **EMAIL** 字段。
5. 在\*\*按许可筛选（可选）\*\*下，选择你的营销同意复选框，这样只会发送表示同意的用户。
6. 点击**保存**，然后点击**测试**。

> 须知：Agillic 没有可供选择的列表，因此你一点击**激活**，Scratcher 就会开始发送。请在活动上线之前激活集成，或者立即完成设置。

## 字段映射

- 电子邮件地址始终会发送到唯一电子邮件字段。你无需映射它。
- 字段列表会显示你的 Agillic 个人数据及其类型。日期以 Agillic 的格式发送，例如 31.12.2025。
- 如果你有用于选择加入的个人数据字段，请将同意的**已接受**字段映射到该字段。

## 发送内容和时间

Scratcher 会按电子邮件查找收件人。如果收件人不存在，则会创建；否则会更新。新注册用户会在一两分钟内发送，现有潜在客户会在你激活集成时发送。在**设置** > **集成** > **发送状态**下，你可以看到每条潜在客户在 Agillic 中是新建的还是已存在的。

## 故障排除

- “Agillic API request failed with status code ...”：Agillic 未接受该请求。401 或 403 表示密钥已被删除或缺少访问权限；请连接新密钥。
- Agillic 关于某个字段的信息：某个值与字段类型不符，或缺少必填字段。请检查映射。

集成

- [集成的工作原理](https://scratcher.io/zh/help/integrations/how-integrations-work)
- [所有集成](https://scratcher.io/zh/help/integrations/other-integrations)
- [查看发送状态并重新发送潜在客户](https://scratcher.io/zh/help/integrations/delivery-status)
- [连接 HubSpot](https://scratcher.io/zh/help/integrations/hubspot)
- [连接 Salesforce Marketing Cloud](https://scratcher.io/zh/help/integrations/salesforce-marketing-cloud)
- [通过 Zapier 连接 Microsoft Dynamics 365](https://scratcher.io/zh/help/integrations/microsoft-dynamics-365)
- [连接 Emarsys](https://scratcher.io/zh/help/integrations/emarsys)
- [连接 Klaviyo](https://scratcher.io/zh/help/integrations/klaviyo)
- [连接 Mailchimp](https://scratcher.io/zh/help/integrations/mailchimp)
- [连接 ActiveCampaign](https://scratcher.io/zh/help/integrations/activecampaign)
- [连接 Apsis One](https://scratcher.io/zh/help/integrations/apsis-one)
- [连接 Drip](https://scratcher.io/zh/help/integrations/drip)
- [连接 HeyLoyalty](https://scratcher.io/zh/help/integrations/heyloyalty)
- [连接 Peytz](https://scratcher.io/zh/help/integrations/peytz)
- [连接 Marketingplatform](https://scratcher.io/zh/help/integrations/marketingplatform)
- [通过 Zapier 连接 Campaign Monitor](https://scratcher.io/zh/help/integrations/campaign-monitor)
- [通过 Zapier 连接 ActiveTrail](https://scratcher.io/zh/help/integrations/activetrail)
- [连接 Bloomreach](https://scratcher.io/zh/help/integrations/bloomreach)
- [连接 Iterable](https://scratcher.io/zh/help/integrations/iterable)
- [连接 Mapp](https://scratcher.io/zh/help/integrations/mapp)
- [连接 Agillic](https://scratcher.io/zh/help/integrations/agillic)
- [连接 Ortto](https://scratcher.io/zh/help/integrations/ortto)
- [连接 Emarketeer](https://scratcher.io/zh/help/integrations/emarketeer)
- [连接 Shopify](https://scratcher.io/zh/help/integrations/shopify)
- [连接 Hello Retail](https://scratcher.io/zh/help/integrations/hello-retail)
- [通过 Zapier 连接 8,000 多款应用](https://scratcher.io/zh/help/integrations/zapier)
- [通过 Zapier 连接 monday.com](https://scratcher.io/zh/help/integrations/monday-com)
- [通过 Zapier 连接 Asana](https://scratcher.io/zh/help/integrations/asana)
- [通过 Zapier 连接 Podio](https://scratcher.io/zh/help/integrations/podio)
- [通过 Zapier 连接 Intercom](https://scratcher.io/zh/help/integrations/intercom)

继续学习

## 相关文章

- [集成的工作原理](https://scratcher.io/zh/help/integrations/how-integrations-work): 只需连接一次你的邮件工具或 CRM，在每个活动中启用，选择列表，映射字段，并只发送已给予同意的用户。
- [查看发送状态并重新发送潜在客户](https://scratcher.io/zh/help/integrations/delivery-status): 查看哪些潜在客户已发送到你的工具，理解错误信息，解决问题并重新发送。
- [征求同意并添加条款和条件](https://scratcher.io/zh/help/forms/consent-and-permissions): 为新闻通讯添加同意复选框，链接您的条款，选择哪个复选框用于订阅，并只把表示同意的用户发送到您的邮件工具。

需要帮助？

## 仍需要帮助？

真人团队随时为您提供帮助。如果您已在使用 Scratcher，最快的方式是使用平台内的聊天功能。

- **[与我们聊天](https://platform.scratcher.io/zh-Hans/login)**

    登录后点击右下角的聊天按钮。Rex 会立即回复，我们的团队也只需一键即可联系。
- **[预约会议](https://scratcher.io/zh/book-a-meeting)**

    与我们的团队进行免费 30 分钟视频通话：产品演示、活动创意或设置协助。
- **[给我们发邮件](mailto:contact@scratcher.io)**

    发送邮件至 contact@scratcher.io，我们会尽快回复您。
