如何在 ActiveCampaign API v3 中将联系人添加到列表中答案

【问题标题】：How to add a contact to a list in ActiveCampaign API v3如何在 ActiveCampaign API v3 中将联系人添加到列表中
【发布时间】：2019-03-13 17:35:25
【问题描述】：

根据 v3 docs，我应该能够使用联系人 API 将联系人添加到列表中，但我不知道如何执行此操作，因为我在 Contacts 下看不到任何相关列表。

如何使用 API 版本 3 将联系人添加到列表（不是通过自动化）？还是文档有误？

【问题讨论】：

标签： activecampaign

【解决方案1】：

v3 文档已更新 (Lists documentation)，它们不再显示您可以通过 API 将联系人添加到列表中。 ActiveCampaign Lists documentation screenshot

编辑：您可以使用 v1 contact_sync (contact_sync documentation) 将联系人添加到列表中

第二次编辑：您现在可以通过 v3 API 将联系人添加到列表和/或将其订阅状态更改为给定列表！ (update list status for a contact documentation)

【讨论】：

我需要将多个联系人添加到一个列表中，我可以一次通话吗？或者我需要为每个联系人调用 1 个 API 调用吗？
使用apiv1和v3有什么区别？

【解决方案2】：

以上说法不再正确。您可以使用Create Contact 端点添加联系人。

它基本上是一个使用以下参数的 POST 请求：

电子邮件（必填）
名字（可选）
姓氏（可选）
电话（可选）

API v3 发生了很大变化，现在在您创建联系人以执行以下操作后，您必须咨询其他端点。例如：

要将联系人添加到列表，您需要向 Contact Lists 端点发送 POST 请求，您需要在其中提供三个参数 (listid, contactid, status)。

如果您需要为联系人分配标签，为了能够创建关系，您首先需要使用Create a new tag 端点创建标签。并将生成的标签 ID 与 Create Contact Tag 端点结合使用，您可以将所述标签 ID 与联系人 ID 结合起来。

现在，为了删除相同的标签，Active Campaign 中的人让我们工作更多，为了从联系人中删除标签，您不需要使用联系人的 id 和标签的 id，而是必须使用联系人的id和标签和特定联系人之间的关系id，这是相当多的步骤，但我想他们想在结构上让它变得非常罗布特。

从您提出问题之日起，实际上有许多新端点可用。您应该查看新的API reference。它有一些缺陷，还没有 100% 完成，但它会很有用。

【讨论】：

【解决方案3】：

希望这会有所帮助，因为它让我有些头疼...使用 activecampaign php sdk 通过同步命令添加联系人时，您还可以将其添加到列表中：

  $list_id = 'thelistid';
  $contact = array(
    "email"              => 'contactemail@doamin.com',
    "p[{$list_id}]"      => $list_id,
    "status[{$list_id}]" => 1, // "Active" status
  );

$contact_sync = $ac->api("contact/sync", $contact);

他们也在repository 上写了它作为示例，但由于某种原因我没有听懂。

【讨论】：