Поля контакта

Контакт хранит имя человека и фото профиля, платформу и ID профиля, которые его идентифицируют, подключённую страницу, на которую пришло взаимодействие, теги, прикреплённые к нему, и время последней активности. Теги — единственное поле, которое можно изменить. Контакты создаются автоматически из входящего комментария, так что ничто в записи не вводится вручную, и нет способа добавить контакт самостоятельно.

Сводка

Поле	Тип	Откуда берётся значение	Редактируемое
Имя	текст	Имя пользователя из взаимодействия, создавшего контакт, обновляется при каждом последующем взаимодействии	Нет
ID профиля	текст	Идентификатор, который Facebook или Instagram использует для этого человека	Нет
Платформа	`facebook` или `instagram`	Платформа, с которой пришло взаимодействие	Нет
Фото профиля	изображение	Загружается с платформы после создания контакта, затем хранится AFP	Нет
Страница	ссылка на страницу	Страница, на которую пришло взаимодействие	Нет
Теги	список ссылок на теги	Селектор тегов контакта, или узлы `add_tag` и `remove_tag` в кампании	Да
Последняя активность	временная метка	Устанавливается при создании контакта, обновляется при каждом последующем взаимодействии	Нет
Комментарии	число	Считается по комментариям, привязанным к контакту, при каждом чтении записи	Нет
Пол	фиксированное значение	Устанавливается как неизвестный при создании контакта	Нет

Имя

Тип: текст
Редактируемое: нет

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

ID профиля

Тип: текст
Редактируемое: нет

Собственный идентификатор платформы для этого человека. Это половина идентичности контакта — платформа составляет вторую половину — и именно по нему узлы тегов кампании находят запись.

Платформа

Тип: facebook или instagram
Редактируемое: нет

С какой платформы пришло взаимодействие. Это часть идентичности контакта, а не настройка, и один из фильтров в списке контактов.

Фото профиля

Тип: изображение
Редактируемое: нет

Загружается с Facebook или Instagram в фоне, как только контакт появляется, затем хранится AFP, так что список контактов не зависит от того, останется ли URL платформы рабочим. Контакт может появиться раньше своей фотографии. Когда загрузка не удаётся, поле остаётся пустым, и попытка повторяется при следующем взаимодействии этого человека со страницей.

Страница

Тип: ссылка на страницу
Редактируемое: нет

Подключённая страница, на которую пришло взаимодействие, записывается при создании контакта и поддерживается актуальной по мере поступления последующих взаимодействий. Контакты принадлежат аккаунту, которому принадлежит страница, и когда ваш аккаунт находится под мастер-аккаунтом, контакты, которыми владеет этот мастер-аккаунт, появляются рядом с вашими собственными.

Селектор тегов на контакте заменяет весь набор целиком: он сохраняет теги, оставшиеся выбранными, так что снятие тега удаляет его. Тег, который ваш аккаунт не видит, отклоняется, и контакт остаётся без изменений.

Кампании пишут в то же поле с другой семантикой. Узел add_tag объединяет свои теги с тем, что контакт уже несёт, а узел remove_tag вычитает свои теги; ни один из них не заменяет набор. Оба находят контакт по ID профиля и платформе, так что выполнение для человека, у которого ещё нет записи контакта, ничего не меняет и переходит к следующему узлу. Типы узлов описывает оба узла, а Правила сопоставления ключевых слов описывает условие, которое решает, запускаются ли они вообще.

Последняя активность

Тип: временная метка
Редактируемое: нет

Устанавливается в момент создания контакта и обновляется при каждом последующем взаимодействии от этого человека. Список контактов упорядочен по ней, сначала новые, и фильтр по дате в этом списке измеряется относительно неё — список показывает последние 30 дней, пока вы не расширите диапазон.

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

Пол

Тип: фиксированное значение
Редактируемое: нет

Устанавливается как неизвестный при создании контакта и остаётся таким.

Как ключуются контакты

На каждого человека, на каждой платформе, у каждого владельца существует одна запись. Отсюда следуют три вещи:

У того, кто комментирует вашу страницу Facebook и также присылает сообщение вашему аккаунту Instagram, есть две записи контакта, потому что платформа — часть ключа.
Два аккаунта, которые оба взаимодействуют с одним и тем же человеком, держат для него собственную запись. Совместное использование под мастер-аккаунтом — это то, что делает запись другого аккаунта видимой.
Поиску по ID профиля также нужна платформа. Сам по себе идентификатор не указывает на один контакт.

Что не хранится

Никакого email-адреса, номера телефона или свободной заметки. Перечисленные выше поля — это вся запись.
Никакого контакта, который вы создаёте сами. Нет действия создания контакта и нет импорта; запись появляется только после того, как кто-то взаимодействует с подключённой страницей.
Никакой записи для того, кто только присылал личные сообщения. Контакт создаётся из входящего комментария.
Никакой истории сообщений. Счётчик комментариев — единственная активность, которую несёт сама запись.

Какие фильтры используют эти поля

Фильтр в списке контактов	Какое поле читает	Примечания
Платформа	Платформа	Facebook, Instagram, или все платформы
Тег	Теги	Один тег за раз
Диапазон дат	Последняя активность	Число дней назад, или всё время; по умолчанию 30 дней
Поиск	Имя	Совпадает с частью имени, не ищет по тегам

Список упорядочен по последней активности, сначала новые, и по умолчанию возвращает 20 контактов на страницу.

Связанное

Работа с контактами — фильтрация, поиск и удаление записей, которые описывают эти поля.
Типы узлов — узлы add_tag и remove_tag, которые пишут в поле Теги.
Правила сопоставления ключевых слов — как условие решает, какие люди доходят до узла тега.
Маршрутизация комментариев в ЛС — построение кампании, запускаемой комментарием, из которой приходят эти записи.
Тест и отладка кампании — тестовое выполнение оставляет теги контакта нетронутыми.