Как добавить контакт в список в 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);
Писали тоже в качестве примеров в репозиторий, но я почему-то не уловил.