Clay

将 Clay 表格中补全信息后的数据行发送到 Warmbly，转为联系人，并将回复、退信、会议等 Warmbly 事件回传至 Clay 表格。

Clay 集成支持双向通信。Clay 表格向 Warmbly 发送数据行，转换为联系人后可直接加入营销活动；Warmbly 再将事件发回 Clay 表格，使 Clay 工作流能根据回复、退信或会议预约继续执行操作。

无需安装 Clay 应用，也不需要 Clay API 密钥。两个方向都使用 URL。

连接 Clay

打开集成 > Clay > 连接。Warmbly 会为该连接生成 URL，并打开显示该 URL 的 Clay 页面。

URL 显示时立即复制

该 URL 相当于密码，因此只显示一次。如有遗失，可在 Clay 页面选择生成新 URL，旧 URL 会立即失效。

从 Clay 发送数据行

在 Clay 表格中添加一列，选择 HTTP API。

将方法设为 POST，并将 Clay URL 粘贴为端点。

编写 JSON 请求体，输入 / 插入列。只有 email 是必填项：

{
  "email": "/Work Email",
  "first_name": "/First Name",
  "last_name": "/Last Name",
  "company": "/Company Name",
  "title": "/Job Title",
  "linkedin_url": "/LinkedIn Profile",
  "tags": "clay, q4-list"
}

先在少量数据行上运行该列，检查结果后再开启自动运行。

每行可包含的内容

键	转换结果
`email`	联系人的邮箱地址，必填
`first_name`, `last_name`	联系人姓名。如果这两个字段不存在，会拆分 `name`（或 `full_name`）
`company`, `phone`	对应的联系人字段
`tags`	标签，可为列表或逗号分隔的字符串；在连接默认标签的基础上追加
`subscribed`	为 `false` 时，以未订阅状态添加联系人
`campaign_id`	Warmbly 营销活动 ID；联系人加入此活动，而非默认活动
`custom_fields`	自定义字段对象
其他任意键	转为同名的自定义字段，可在邮件中作为变量使用

也支持常见的 Clay 列名，例如 work_email、job_title、company_name、linkedin、domain 等。

请求体可以是一行、行数组，或含有 rows 数组的对象。每次请求最多包含 100 行、大小不超过 1 MB。

响应

Clay 可以将响应映射回列。单行请求会在响应顶层返回该行的结果：

{
  "status": "created",
  "contact_id": "3f7c…",
  "email": "[email protected]",
  "received": 1,
  "created": 1,
  "updated": 0,
  "skipped": 0,
  "failed": 0,
  "results": [ … ]
}

status 为 created、updated、skipped（例如联系人已存在且选择了保持不变，或地址被禁止发送），或 failed。跳过或失败的行会带有 reason。多行请求具有相同的计数字段，并在 results 中为每行提供一项结果。

Warmbly 无法识别的 URL 返回 404，已断开的连接返回 403。这两种情况重试也不会解决：应修正列中的 URL 或重新连接 Clay，再次运行数据行。同一连接每分钟超过 600 次请求会返回 429 和 Retry-After，Warmbly 自身出错则返回 500。后两种情况适合重试，因此应在 HTTP API 列的设置中启用重试，并将 429 和 500 列为重试状态。

数据行如何转为联系人

在 Clay 页面的数据行转换设置中，选择应用于每行的规则：

将每个联系人加入某个营销活动，或仅添加到联系人列表；
标签；
将联系人固定加入的分群；
联系人已存在时的处理方式：更新会填入 Clay 提供的内容但不会清空字段，或选择保持不变；
新联系人是否默认处于已订阅状态。

联系人的来源设为 Clay，因此可用分群筛选。被禁止发送的地址不会被添加。联系人加入营销活动后，与其他潜在客户一样，遵守活动所用邮箱的发送上限和间隔。

向 Clay 发送事件

在 Clay 中为表格添加来源，选择 Webhook，复制其 URL。如果启用了身份验证令牌，也一并复制。

在 Clay 页面的向 Clay 发送事件中粘贴 Webhook URL 和令牌。

选择要发送的事件，保存后使用发送测试行检查 Clay 是否收到。

可选事件包括：潜在客户回复、邮件发送、邮件打开、链接点击、邮件退信、联系人退订、会议预约和会议取消。每个事件都会添加一行，以平铺列的形式包含事件、联系人的邮箱与姓名、营销活动和事件详情。

要发送到多个 Clay 表格，可在自动化流程中使用向 Clay 发送数据行操作。默认发送到连接绑定的表格，除非步骤指定其他表格的 Webhook。连接的身份验证令牌只会发送给其绑定表格，因此步骤另行指定的表格必须使用不带令牌的 Webhook 来源。

停止发送会移除 Webhook URL、令牌和所选事件。

工作区导出时一并迁移的内容

Clay 连接会像其他集成一样随工作区导出迁移，包括默认设置和所选事件。仅当归档包含凭据时，表格 Webhook 和令牌才会一同迁移；否则需要重新粘贴。入站 URL 在新实例上保持相同路径，因此应将 Clay 列中的地址更改为新实例地址，或在新实例生成新的 URL。