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

Если в рамках суток пользователем 1 был совершен импорт 1 в размере 10 контактов и импорт 2 в размере 20 контактов, то мы сгруппируем эти добавления в одну строку с суммарным значением «Импорт пользователем 1 в размере 30 контактов». По той же логике мы сгруппируем все добавления с одного поп-апа или с одного ip-адреса. Обновления контактов не считаются добавлением, и не влияют на тарификацию.

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

Обновление существующих контактов посредством импорта или API не равно добавлению контактов, и в таблице статистики отображаться и учитываться не будет.

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

Понятнее всего разобрать логику можно на примере:

Изначально имеем пустой аккаунт
1.01 Импорт в размере 1000 контактов
Максимальный объем: 1000 Фактический объем: 1000
3.01 Импорт в размере 2000 контактов, из которых 500 - существующие
Максимальный объем: 2500 Фактический объем: 2500
4.01 Удаление контактов в размере 800 контактов
Максимальный объем: 2500 Фактический объем: 1700
10.01 Со всплывающего окна добавлено 4000 контактов
Максимальный объем: 5700 Фактический объем: 5700
25.01 Восстановление удаленных 4.01 контактов в размере 800
Максимальный объем: 6500 Фактический объем: 6500
31.01 Удаление контактов в размере 6400
Максимальный объем: 6500 Фактический объем: 100
За январь тарифицировать будет 6500 контактов, несмотря на то, что на 31.01 в аккаунте находится всего 100.
Максимальный объем на 01 февраля равен фактическому объему - 100 контактов, процесс повторяется.

Способы добавления контактов в платформу:

• Ручное добавление одного контакта
• Импорт - ручной или автоматический импорт контактов в сервисе
• API - методы на добавление единственного контакта или нескольких контактов
• Всплывающее окно - контакты, полученные с собирающего поп-апа на сайте
• Подписка на Web-Push уведомления - разрешение на отправку пуш-уведомлений на сайте
• Подписка на Mobile-Push уведомления - разрешение на отправку пуш-уведомлений в приложении
• Трекинг - добавление контактов с веб-форм на сайте, добавление при заказе и прочие способы трекинга, которые установлены на сайте
• Тестовая отправка - в случае, если контакт ранее не был добавлен в аккаунт
• Транзакция - отправка сообщения по API без предварительного добавления контакта в сервис
• Получение входящего сообщения по каналу WhatsApp
• Интеграция Tilda
• Интеграция AMO CRM
• Отправка на список контактов - загрузка csv файла с контактами на этапе Выбор получателей в Мастере создания сообщений
• Восстановление контакта из удаленных

Контактом мы считаем пользователя, для которого нам известен хотя бы один идентификатор:

• Емейл
• Телефон
• Web Push-Token
• Mobile Push-Token

Так как именно при наличии одного из этих каналов мы можем отправлять человеку сообщения.

Способы удаления контактов:

• Вручную - из карточки контакта: по кнопке и при удалении единственного канала (email, телефона)
• Импорт - загрузив .csv файл
• Сегмент - по кнопке Действия ➔ Удалить контакты
• Сценарий (блок завершения) - выбор опции «Удалить контакты»
• Метод API - метод «Удаление контактов»

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

Список контактов доступен во вкладке меню enKod.

Для добавления контакта в платформу импортом или по API необходимо указать хотя бы один из идентификаторов - емейл или телефон. При этом, формат записи емейл-адреса должен соответствовать этой структуре, а формат записи номера телефона - этому нормативу.

На странице Контакты вы можете найти пользователей через быстрый поиск по емейлу или номеру телефона.

Список контактов отсортирован по умолчанию по дате обновления.

Столбец «Каналы» отображает для каждого контакта факт наличия у него того или иного идентификатора и факт подписки на группу рассылок по данному каналу. Всего есть три варианта отображения канала:

• Пустота - контакт ни разу не был подписан ни на одну группу рассылок по этому каналу;
• Неактивный канал - контакт был подписан на группу рассылок по этому каналу, но в текущий момент отписан от всех групп этого канала;
• Активный канал - контакт подписан хотя бы на одну группу рассылок по этому каналу.

Если кликнуть на контакт, откроется карточка контакта. Здесь можно посмотреть все данные, которые известны о пользователе: имя, номер телефона, дата регистрации, источник трафика, каналы взаимодействия, активность и др.

По необходимости вы можете редактировать значения полей данных, email, телефона, имени и фамилии. Обо всех действиях вас оповестят события в карточке контакта, где указано как и кто вносил изменения.

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

В карточке контакта также можно посмотреть все группы рассылок, которые прикреплены к контакту, открепить ненужные или добавить новые.

Вы можете импортировать контакты в аккаунт с помощью ручного или автоматического импорта.

Для ручного импорта используйте файлы:

• в формате .csv (или .zip с .csv файлом внутри)
• до 150 Мб
• в кодировке UTF-8
• в качестве разделителя запятая или точка с запятой

Шаблон файла для импорта контактов можно скачать по этой ссылке.

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

Если какое-то из полей данных не создано заранее, вы можете создать его прямо из окна настройки импорта, нажав на плюс справа.

На следующем шаге импорта можно присвоить контактам одну или несколько групп рассылок. Это необязательный шаг. Если вы не выберете ни одну группу рассылок, импорт всё-равно пройдет успешно.

На этом же шаге можно указать, нужно ли присвоить группы рассылок отписчикам. Возможные варианты при импорте:

• Присвоить группу рассылок всем контактам. Если контакт ранее отписался от одной или сразу всех групп рассылок, то он всё равно импортируется и ему будут присвоены выбранные группы.
• Присвоить группу рассылок всем, кроме отписавшихся от выбранной группы рассылок. Если контакт ранее отписался от выбранной группы рассылок, то он импортируется в Контакты, но выбранная группа рассылок ему не присвоится.
• Присвоить группу рассылок всем, кроме отписавшихся от всех групп рассылок. Если контакт ранее отписался сразу от всех групп рассылок, то он импортируется в Контакты, но ему не присвоится ни одна группа рассылок.

После нажатия на кнопку «Начать сверку», вы можете найти свой готовый к импорту файл в разделе Импорты. При наведении на строку импорта появится кнопка «Начать импорт».

В окне настройки импорта вы можете выбрать, что сделать с новыми контактами и с контактами, которые уже есть в платформе. Успешный импорт имеет статус «Импорт завершен» в списке импортов.

Увидеть историю импорта можно в списке импортов при наведении курсора на нужную строку и нажатии кнопки «Открыть историю»

При импорте контактов любым способом мы отклоняем:

• некорректные по структуре и синтаксису
• емейл-адреса, для которых не существует MX-запись

Удаление импорта

Автоматические и ручные импорты можно удалить. В зависимости от того, какие кнопки появляются при наведении на строку импорта, удалить можно либо в строке импорта по кнопке удаления, либо в модальном окне, появляющемся по нажатию на “Открыть историю”

Если ваша база хранится не локально, то вы можете настроить автоматическую передачу контактов в enKod с указанного URL. Мы будем импортировать контакты по расписанию, или вы можете запускать импорт по API. При этом настройку нужно будет провести всего один раз.

Создайте автоматический импорт в разделе enKod ➔ Импорты ➔ Создать импорт ➔ Автоматический ➔ Автоимпорт контактов.

Настройка импорта состоит из четырех шагов:

На первом укажите:

• Название импорта (будет отображаться в списке автоимпортов в интерфейсе)
• URL - ссылка (http/https) на файл с контактами, допустимые форматы YML или архивы (с YML файлом внутри)
• Логин и пароль - заполните, если доступ к файлу ограничен

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

На шаге «Выбор групп рассылок» укажите, на какие группы следует подписывать контакты при импорте и по какому правилу осуществлять подписку.

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

Созданный автоимпорт будет храниться в списке автоимпортов. По клику на «Открыть историю» вы можете просмотреть последние 4 запуска детально (сколько контактов было добавлено, сколько обновлено, сколько мы сочли невалидными), проверить наличие ошибок (мы отключим автоимпорт, если трижды подряд не сможем получить файл по ссылке). В этом же окне доступен принудительный запуск автоимпорта, редактирование или удаление.

Вы можете создать неограниченное количество импортов, которые будут работать независимо.

По одному вручную в enKod можно добавить контакты через Контакты ➔ Действия ➔ Добавить контакт. Для каждого добавляемого таким образом контакта данные вводятся во всплывающем модальном окне:

По клику на «Добавить» контакт появляется в платформе.

Экспортировать контакты можно из списка или из сегмента. При экспорте вы можете выбрать те поля контактов, которые требуются в выгрузке.

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

Для массового удаления загрузите .csv файл со списком контактов максимальным размером 50Мб в кодировке UTF-8. Допустимая структура файла: первый столбец обязательно должен содержать емейл-адреса или телефоны. После загрузки будет отображено доступное для удаления количество контактов, которое удалось найти в платформе.

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

Восстановить контакты можно из списка удаленных, нажав на соответствующую кнопку.

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

При добавлении контакта с помощью импорта, метода трекинга, API-методов действуют следующие правила:

• создаем контакт, если он не существует
• обновляем, если он существует
• восстанавливаем контакт из удаленных, с сохранением истории и со значениями полей данных, переданные поля данных перезаписываем на те, что переданы в запросе, непереданные не изменяем, но восстанавливаем их значения
• если переданы емейл и телефон контакта, и обоих идентификаторов нет в базе - создаем новый контакт с емейлом и телефоном
• если переданы емейл и телефон контакта, и при этом в базе уже есть переданный емейл, то:
  • если mainChannel = email, то телефон будет добавлен существующему контакту с емейлом
  • если mainChannel = phone, то будет создан новый контакт только с телефоном, емейл сохранится за существующим контактом
• если переданы емейл и телефон контакта, и при этом в базе уже есть переданный телефон, то:
  • если mainChannel = phone, то емейл будет добавлен существующему контакту с телефоном
  • если mainChannel = email, то будет создан новый контакт только с емейлом, телефон сохранится за существующим контактом
• если передан емейл и телефон контакта, и при этом в базе уже есть оба идентификатора, но у разных контактов, то, в зависимости от значения параметра mainChannel, переданные основные поля контакта, поля данных, группы рассылок и теги буду присвоены тому контакту, идентификатор которого равен значению mainChannel

В случае добавления контакта из поп-апа mainChannel по умолчанию равен email, поэтому действуют следующие правила:

• создаем контакт, если он не существует
• обновляем, если он существует
• восстанавливаем контакт из удаленных, с сохранением истории и со значениями полей данных, имя перезаписываем на то, что передано из поп-апа, непереданные поля не изменяем, но восстанавливаем их значения
• если переданы емейл и телефон контакта, и обоих идентификаторов нет в базе - создаем новый контакт с емейлом и телефоном
• если переданы емейл и телефон контакта, и при этом в базе уже есть переданный емейл, то:
  • при совпадении сессий существующего и нового контакта телефон будет добавлен контакту с емейлом
  • при несовпадении сессий существующего и нового контакта будет создан новый контакт только с телефоном, емейл сохранится за существующим контактом
• если переданы емейл и телефон контакта, и при этом в базе уже есть переданный телефон, то:
  • при совпадении сессий существующего и нового контакта емейл будет добавлен контакту с телефоном
  • при несовпадении сессий существующего и нового контакта будет создан новый контакт только с емейлом, телефон сохранится за существующим контактом
• если переданы емейл, телефон и сессия, и при этом в базе уже есть оба идентификатора, но у разных контактов, то телефон и сессия будут присвоены существующему контакту с емейлом (если у существующего контакта уже была сессия и она отличается от новой, то контакт будет иметь две сессии)
• если передан емейл и телефон контакта, и при этом в базе уже есть оба идентификатора, но у разных контактов, то переданные основные поля контакта и группы рассылок буду присвоены контакту с емейлом

При работе с сессией вне поп-апов действуют следующие правила:

• создаем контакт, если он не существует
• обновляем, если он существует
• восстанавливаем контакт из удаленных, с сохранением истории и со значениями полей данных, имя перезаписываем на то, что передано из поп-апа, непереданные поля не изменяем, но восстанавливаем их значения
• если переданы емейл и телефон контакта, и обоих идентификаторов нет в базе - создаем новый контакт с емейлом и телефоном
• если переданы емейл и телефон контакта, и при этом в базе уже есть переданный емейл, то:
  • при совпадении сессий существующего и нового контакта телефон будет добавлен контакту с емейлом
  • при несовпадении сессий существующего и нового контакта будет создан новый контакт только с телефоном, емейл сохранится за существующим контактом
• если переданы емейл и телефон контакта, и при этом в базе уже есть переданный телефон, то:
  • при совпадении сессий существующего и нового контакта емейл будет добавлен контакту с телефоном
  • при несовпадении сессий существующего и нового контакта будет создан новый контакт только с емейлом, телефон сохранится за существующим контактом

Ниже с помощью примеров описаны еще несколько сложный кейсов с сессиями, так как общими формулировками невозможно полноценно объяснить логику работы:

Если переданы емейл 1, телефон 1 и сессия 1, при этом в базе существуют два контакта:

• Контакт 1: емейл 1, сессия 1
• Контакт 2: телефон 1, сессия 2

в таком случае:

• если mainChannel = email, то получим:
  • Контакт 1 с полями: емейл 1, телефон 1, сессия 1 и сессия 2
  • Контакт 2 исчезнет
• если mainChannel = phone, то получим:
  • Контакт 2 с полями: емейл 1, телефон 1, сессия 1 и сессия 2
  • Контакт 1 исчезнет

Если переданы емейл 1, телефон 1 и сессия 2, при этом в базе существуют два контакта:

• Контакт 1: емейл 1, сессия 1
• Контакт 2: емейл 2, сессия 2

в таком случае:

• если mainChannel = email, то будут существовать:
  • Контакт 1 с полями: емейл 1, телефон 1, сессия 1, сессия 2
  • Контакт 2 с полями: емейл 2
• если mainChannel = phone, то будут существовать:
  • Контакт 1 с полями: емейл 1, телефон 1, сессия 1, сессия 2
  • Контакт 2 с полями: емейл 2

Если переданы емейл 1, телефон 2 и сессия 2, при этом в базе существуют два контакта:

• Контакт 1: емейл 1, телефон 1, сессия 1
• Контакт 2: емейл 2, телефон 2, сессия 2

в таком случае:

• если mainChannel = email, то будут существовать:
  • Контакт 1 с полями: емейл 1, телефон 2, сессия 1, сессия 2
  • Контакт 2 с полями: емейл 2
• если mainChannel = phone, то будут существовать:
  • Контакт 1 с полями: телефон 1, сессия 1
  • Контакт 2 с полями: емейл 1, телефон 2, сессия 2