Как добавить контакт в список в ActiveCampaign API v3

В соответствии с документацией v3, я мог бы добавить контакт в список с помощью Contact API, но я не знаю, как это сделать, поскольку ничего не вижу в списке контактов.

Как добавить контакт в список (не с помощью автоматизации), используя версию 3 API? Или документы по ошибке?

3 ответа

Решение

Документы v3 были обновлены ( документация списков) и больше не читают, что вы можете добавить контакт в список через API. Скриншот документации ActiveCampaign Lists

РЕДАКТИРОВАТЬ: вы можете добавить контакт в список, используя v1 contact_sync ( документация contact_sync)

ВТОРОЕ РЕДАКТИРОВАНИЕ: теперь вы можете добавить контакт в список и / или изменить его статус подписки на данный список через API v3! ( обновить статус списка для контактной документации)

Вышесказанное больше не соответствует действительности. Вы можете добавить контакт, используя конечную точку Создать контакт.

Это в основном POST-запрос, который использует следующие параметры:

  • E-Mail (обязательно)
  • Имя (необязательно)
  • Фамилия (необязательно)
  • Телефон опционально)

API v3 сильно изменился, и теперь, после того как вы создали контакт, чтобы выполнить следующие действия, вы должны обратиться к другим конечным точкам. Например:

Чтобы добавить контакт в список, вам нужен POST-запрос к конечной точке списков контактов, где вам нужно указать три параметра. (listid, contactid, status),

Если вам нужно назначить тег контакту, для того, чтобы иметь возможность создать отношение, сначала нужно создать тег с помощью конечной точки Создать новый тег. И использовать полученный идентификатор тега с конечной точкой Создать тег контакта, где вы объединяете указанный идентификатор тега с идентификатором контакта.

Теперь, чтобы удалить тот же тег, ребята из Active Campaign заставили нас работать больше, и чтобы удалить тег из контакта, вы не используете идентификатор контакта и идентификатор тега, а скорее вы должны использовать идентификатор контакта и идентификатор отношения между тегом и конкретным контактом, это довольно много шагов, но я думаю, они хотели сделать его очень робастным с точки зрения структуры.

Есть много новых конечных точек, которые фактически были доступны примерно с той даты, когда вы задали свой вопрос. Вы должны проверить новую ссылку API. Он имеет некоторые недостатки и еще не завершен на 100%, но это было бы полезно.

Надеюсь, это поможет, так как это дало мне голову ... Используя 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);

Писали тоже в качестве примеров в репозиторий, но я почему-то не уловил.

Другие вопросы по тегам