AMO CRM

Интеграция заключается в изменении и/или создании контактов в enKod при совершении в АМО CRM следующих событий:

• Добавление контакта
• Изменение контакта
• Добавление сделки
• Изменение сделки

1. Установите веб-хук (один на все события или отдельный для каждого)

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

Менеджер предоставит вам URL вебхука, который необходимо установить в АМО → АМО маркет → Webhooks

2. Выберите необходимые события

Мы поддерживаем 4 типа событий, изменения в которых являются триггером для изменения/добавления контакта в enKod.

• Добавление контакта
• Изменение контакта
• Добавление сделки
• Изменение сделки

Настройте те из четырех событий, которые вам необходимы.

Добавление контакта в АМО → Добавление/обновление контакта в enKod

При добавлении контакта в АМО:

• контакт будет создан в enKod, если он не был найден
• контакт будет обновлен в enKod, если он был найден

Изменение контакта в АМО → Добавление/обновление контакта в enKod

При изменении контакта в АМО:

• контакт будет создан в enKod, если он не был найден
• контакт будет обновлен в enKod, если он был найден

Сопоставление полей контакта в АМО с полями данных в enKod

У контакта в АМО есть два типа полей - системные (существующие изначально, не отображаются в интерфейсе) и пользовательские (созданные вручную). Емейл, телефон, имя и фамилия контакта будут переданы по умолчанию.

Обработка системных полей контакта

В АМО у контакта есть системные поля:

Для каждого системного поля контакта, которое необходимо передавать в enKod, создайте поле данных с системным именем в виде amo_contact_id, amo_contact_name, amo_contact_responsible_user_id и тд.

Если поле передавать не нужно, просто не создавайте его в enKod. Ознакомьтесь со списком полей, которые мы можем и не можем обрабатывать в этом разделе.

Обработка пользовательских полей:

В АМО у пользовательских полей контакта есть свой уникальный id, который можно посмотреть здесь:

Для передачи таких полей в enKod создайте в сервисе поля данных с системными именами в виде:

• amo_contact_1
• amo_contact_2

где 1 и 2 - id пользовательских полей контакта в АМО.

Если поле передавать не нужно, просто не создавайте его в enKod. Ознакомьтесь со списком полей, которые мы можем и не можем обрабатывать в этом разделе.

Добавление и изменение контакта в enKod при добавлении и изменении сделки в АМО

В таком случае мы можем обрабатывать события:

Добавление сделки в АМО → Добавление/обновление контакта в enKod

При добавлении сделки в АМО:

• контакт будет создан в enKod, если он не был найден
• контакт будет обновлен в enKod, если он был найден

Изменение сделки в АМО → Добавление/обновление контакта в enKod

При изменении сделки в АМО:

• контакт будет создан в enKod, если он не был найден
• контакт будет обновлен в enKod, если он был найден

Сопоставление полей сделки в АМО с полями данных контакта в enKod

У сделки в АМО есть два типа полей - системные (существующие изначально, почти все не отображаются в интерфейсе) и пользовательские (созданные вручную).

Обработка системных полей сделки

В АМО у сделки есть системные поля:

Для каждого системного поля сделки, которое необходимо передавать в enKod, создайте поле данных с системным именем в виде amo_lead_id, amo_lead_name, amo_lead_status_id и тд.

Если поле передавать не нужно, просто не создавайте его в enKod. Ознакомьтесь со списком полей, которые мы можем и не можем обрабатывать в этом разделе.

Обработка пользовательских полей:

В АМО у пользовательских полей сделки есть свой уникальный id, который можно посмотреть здесь:

Для передачи таких полей в enKod создайте в сервисе поля данных с системными именами в виде:

• amo_lead_1
• amo_lead_2

где 1 и 2 - id пользовательских полей сделки в АМО.

Если поле передавать не нужно, просто не создавайте его в enKod. Ознакомьтесь со списком полей, которые мы можем и не можем обрабатывать в этом разделе.

Из АМО в enKod может прийти: емейл, несколько емейлов, емейл и телефон, только телефон, несколько телефонов. Множественные поля с емейлами или телефонами мы можем получить в том случае, если они были добавлены вручную в АМО (пользовательские поля).

• Если пришло несколько емейлов - мы ищем контакт в enKod по первому, остальные игнорируем
• Если пришли емейл и телефон - ищем по емейлу (если никого не нашли, то по телефону)
• Если пришел только емейл - ищем по емейлу
• Если пришел только телефон - ищем по телефону

Если в емейле или телефоне, по которому мы матчим, передано невалидное значение (например, емейл без собаки, буквы в телефоне), то такие запросы мы не обрабатываем (для случаев когда передан только емейл или только телефон). Если мы получили емейл и телефон, а один из идентификаторов невалидный, то мы будем искать контакт по второму (корректому) идентификатору.

Если контакт был найден - мы обновляем его поля.

Если контакт не был найден - мы его создаем.

• Если один и тот же контакт привязан к нескольким сделкам в АМО, то мы будем хранить в полях только последнюю измененную из них.
• Если в сделке в АМО не создано поле email, то мы не сможем привязать сделку к контакту в enKod.
• В enKod будут изменены только те поля контакта, которые были предварительно созданы по всем правилам.
• Если в enKod будет передан невалидный емейл, в котором присутствует пробел, то при передаче мы заменим пробел на плюс. Это связано с логикой работы веб-хуков в АМО. В данном случае контакт будет добавлен, как валидный.

При необходимости вы можете подписать контакты на группы рассылок при добавлении в enKod. В таком случае подписка будет работать по логике “всех, включая отписчиков”, но контакты, которые находятся в ЧС или ГЧС, подписаны не будут.

Для подписки добавьте после основной части URL системные имена необходимых групп в следующем виде:

https://wh.enkod.ru/amo/MzJjamJ1YXWZvZA==tfhodg/?groups=sysname1,sysname2