Перейти к содержанию

AmoCRM

Внимание!

Перед интеграцией необходимо установить счетчик Roistat!

Как работает интеграция

При оформлении заявки на сайте автоматически создается новый лид в CRM (в рамках интеграции нет возможности автоматически создать сделку), в который передается номер визита из куки браузера roistat_visit в дополнительное поле с именем roistat

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

Если менеджер принимает заказ по телефону, он может спросить промокод (настраивается отдельно) и ввести этот код в поле roistat.

Внимание!

Roistat не может размечать формы amoCRM.

Внимание!

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

Roistat загружает из amoCRM полную историю изменения сделок.

Отправка заявки в CRM

Если заявка не была помечена как дубль, то:

  1. Осуществляется поиск контактов (по всем контактам в CRM системе) по номеру телефона или e-mail адресу.
  2. Если контакт найден, то создается привязанная к нему новая сделка. Если контакт не найден, создается новый контакт с типом "Мобильный" и новая сделка. При создании контакта проверяются все типы телефонов. 

Внимание!

Если в контактах прописано несколько номеров, то проверка на дубли будет срабатывать только по первому номеру.

Шаг 1. Добавьте дополнительное поле roistat

  1. В amoCRM откройте раздел Сделки.
  2. В правом верхнем углу нажмите Новая сделка.
  3. В окне свойств сделки перейдите на закладку Настроить. Откроется окно Настройка свойств полей и групп. В этом окне можно настраивать поля, которые будут доступны для всех сделок amoCRM.

  4. В конце первого блока полей нажмите кнопку Добавить поле: amoCRM - добавление поля roistat.jpg

  5. В качестве типа поля выберите Текст. В поле Название введите roistat: amoCRM - добавление поля roistat2.jpg !!! warning "Внимание!" Дополнительное поле обязательно должно иметь название roistat, иначе интеграция работать не будет.

  6. Нажмите кнопку Сохранить.

ID поля отображается в левом верхнем углу в окне настройки уже созданного поля: ID поля.jpg

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

Чтобы отнести сделку к определенному рекламному каналу, вводите в поле roistat следующие маркеры:

  • yamarket{ID}, если хотите отнести сделку к каналу Яндекс.Маркет. Здесь и далее ID - идентификатор рекламного канала. Например, yamarket1.
  • direct{ID}, если хотите отнести сделку к каналу Яндекс.Директ. Например, direct2.
  • google{ID}, если хотите отнести сделку к каналу Google Adwords. Например, google3.
  • merchant{ID}, если хотите отнести сделку к каналу Google Merchant Center. Например, merchant4.
  • vk{ID}, если хотите отнести сделку к каналу ВКонтакте. Например, vk5.
  • facebook{ID}, если хотите отнести сделку к каналу Facebook. Например, facebook6.
  • mytarget{ID}, если хотите отнести сделку к каналу myTarget.
  • seo_yandex, если хотите отнести сделку к каналу SEO - Яндекс.
  • seo_google, если хотите отнести сделку к каналу SEO - Google.

Внимание!

Если в поле roistat вместо одного из перечисленных маркеров вы введете название соответствующего рекламного канала, то в проекте Roistat будет создан пользовательский несистемный рекламный канал и сделка будет отнесена к созданному рекламному каналу. В отчете Аналитики системный рекламный канал отличается от пользовательского наличием пиктограммы, расположенной  справа от названия:

Roistat - Аналитика - Пиктограмма системного канала.jpg

Шаг 2. Настройте интеграцию с amoCRM в каталоге интеграций

Подключение интеграции с AmoCRM в каталоге интеграций

  1. Откройте Каталог интеграций.

  2. В блоке CRM выберите amoCRM и нажмите кнопку Настроить интеграцию.

Настройка авторизации с CRM-системой

  1. В поле Адрес введите URL-адрес вашего проекта в amoCRM. Обычно он выглядит так: https://<название проекта>.amocrm.ru .

  2. В поле Логин введите адрес электронной почты для авторизации в amoCRM.

  3. В поле API-ключ введите API-ключ amoCRM. Для этого скопируйте его из профиля пользователя: API ключ.png

  4. По кнопке Сохранить перейдите на следующий шаг.

Распределение статусов из CRM-системы

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

Расширенные настройки интеграции

  1. Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.

  2. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей.

  3. Нажмите кнопку Сохранить.

Отправка заявок в "Неразобранное"

Внимание!

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

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

  1. Установите флажок Отправлять лиды в Неразобранное
  2. В amoCRM подключите форму, даже если вы не будете размещать ее на сайте. Это необходимо из-за особенностей реализации передачи заявок в CRM через Roistat. В настройках интеграции с amoCRM в поле Идентификатор формы введите идентификатор формы, подключенной в amoCRM.

    Как узнать идентификатор формы в amoCRM

    1. В проекте amoCRM откройте раздел Сделки.
    2. В правом верхнем углу нажмите Настроить.

    3. Пройдите по ссылке с названием формы, чтобы открыть ее настройки.

    4. Перейдите на вкладку Настройка формы, скопируйте Название формы - это Наименование формы на следующем шаге.

    5. Перейдите на закладку Размещение формы.
    6. В коде формы для размещения на сайте скопируйте ID формы - это Идентификатор формы на следующем шаге. ID формы.jpg
  3. В поле Идентификатор формы вставьте ID формы из предыдущего шага.

  4. В поле Наименование формы вставьте Название формы из предыдущего шага.  

  5. В поле Расположение формы введите текст, который будет отображаться в заголовке сделок со статусом Неразобранное.

    Как узнать идентификатор воронки статусов

    1. В проекте amoCRM откройте раздел Сделки. В верхнем левом углу отображается название воронки, которую вы просматривали в прошлый раз.
    2. Нажмите на название воронки. Откроется список всех имеющихся в проекте воронок: amoCRM - список воронок статусов 2.jpg

    3. Нажмите на название той воронки, идентификатор которой вы хотите узнать.

    4. В адресной строке браузера скопируйте идентификатор воронки: amoCRM - идентификатор воронки.jpg

    В поле Идентификатор воронки введите идентификатор той воронки статусов в аmoCRM, к которой будут отнесены поступающие из Roistat сделки со статусом Неразобранное. Если вы не укажете идентификатор воронки, сделки будут отнесены к воронке статусов, которая расположена первой в списке воронок статусов в amoCRM:

amoCRM - список воронок статусов.jpg

Внимание!

Если в настройках интеграции отключить создание заявок в "Неразобранное", и условия создания сделок не будут установлены, то новые сделки будут отправляться в первый статус воронки продаж, исключая "Неразобранное"

Создание задач

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

создание задач.png

Внимание!

Механизм работает только при создании заявок как Сделки в AmoCRM. При отправке в Неразобранное задачи устанавливаться не будут.

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

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

  1. Выберите тип задачи: Звонок, Встреча, Письмо
  2. Введите текст задачи, который будет отображаться в CRM.

Распределение заявок

Вы можете указать, на каких менеджеров ставить новые заявки в CRM-системе. Менеджеры будут назначаться по порядку.

В поле Ответственные за заявки выберите менеджеров из выпадающего списка: ответственные за заявки.png После этого Roistat будет автоматически распределять сделки по указанным менеджерам. Чтобы узнать идентификатор менеджера, выберите его из выпадающего списка.

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

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

Внимание!

Вы не сможете назначать ответственных за сделки менеджеров при включённой опции оправки сделок в статус Неразобранное.

Настройка даты продажи сделок

По умолчанию, датой продажи сделки считается время, когда сделка в Roistat получила статус из группы "Оплачено". В этом случае дата продажи берется из поля "Дата оплаты" (date_paid) amoCRM.

При загрузке сделок из только что подключенной CRM, датой продажи считается время загрузки сделок в проект.

Если вы хотите, чтобы дата продажи загружалась из вашей CRM системы, то на 4 шаге интеграции включите опцию Использовать дату продажи из CRM.

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

Шаг 3. Настройте автоматическую отправку сделок в amoCRM

Рекомендуем настроить передачу сделок в CRM через Roistat - механизм отправки сделок, при котором сделки сначала передаются в Roistat, затем отправляются в CRM. Механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.

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

Пример кода, с помощью которого можно получить значение этой куки:

$roistatVisitId = array_key_exists('roistat_visit', $_COOKIE) ? $_COOKIE['roistat_visit'] : "неизвестно";

Как заполнять дополнительные поля в amoCRM при создании сделки

Дополнительные поля в amoCRM могут быть заполнены: 

Поля, которые поддерживаются системой amoCRM по умолчанию

Идентификатор посетителя

Уникальный идентификатор посетителя. Системное название (id поля) - visitor_uid.

Бюджет

Бюджет сделки. Системное название (id поля) - sale.

Идентификатор воронки

Создает сделку в определенной воронке. Системное название (id поля) - pipeline_id.

Статус

Создает сделку с определенным статусом в определенной воронке. Системное название (id поля) - status_id.

Теги

Создает теги через запятую. Системное название (id поля) - tags.

Менеджер

Идентификатор ответственного за сделку менеджера. Системное название (id поля) - responsible_user_id.

Произвольное пользовательское поле

Поле, созданное вручную в amoCRM. Системное название (id поля) - ID поля в amoCRMID поля в amoCRM. 

Внимание!

Roistat поддерживает все типы пользовательских полей. Однако, если у клиента полем является не строка, а выпадающий список, то нужно передавать не значение поля (например, Яндекс Директ), а ID, которое закреплено за этим значением в выпадающем списке.

Внимание!

Roistat забирает значение из поля мультисписок.

Как узнать ID поля в amoCRM

Откройте сделку в amoCRM и нажмите Настроить:

id поля1.jpg

Кликните на поле. Перед вами появится окно с ID поля:

id поля2.jpg

Как работают поля amoCRM при интеграции с Roistat

DATE - поле типа "Дата". Возвращает и принимает значения в формате год-месяц-день час-минута-секунда (Y-m-d H:m:s). 

SMART_ADDRESS - поле типа "Адрес" (в интерфейсе является набором из нескольких полей). Передает первое значение, введенное в списке.

Поле "Переключатель" работает с Roistat при передаче по API в PHP-скрипте.

Проверка работы

  1. Создайте заявку на сайте.
  2. В проекте Roistat откройте Каталог интеграций.
  3. В блоке Сейчас подключено на виджете настроенной интеграции с amoCRM   нажмите кнопку Настроить.
  4. В окне настройки интеграции пройдите по ссылке Список отправленных заявок и найдите созданную заявку: проверка работы.png
  5. Проверьте, что в поле Промокод указан номер визита.
  6. Проверьте статус отправки заявки: в поле Отправлен должен появиться успешный статус отправки (V), а в CRM - новая заявка с номером визита.  

Внимание!

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

После настройки интеграции рекомендуем воспользоваться следующими вспомогательными инструментами: