AmoCRM

Как подключить и настроить интеграцию AmoCRM с Carrot Quest

Двусторонняя интеграция Carrot quest с AmoCRM позволяет отправлять данные о контактах и сделках в AmoCRM и обратно — из AmoCRM в Carrot quest. Вы сможете создавать контакты и сделки, а также обновлять свойства контактов автоматически и вручную по слеш-команде.

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

◾ Передача из Carrot quest в AmoCRM

Автоматическое создание контактов и обновление информации происходит после того, как пользователь совершит одно из заранее установленных событий на вашем сайте. Чтобы отправить контакт вручную, введите команду /amocrm прямо в диалоге с пользователем.

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

◾ Передача из AmoCRM в Carrot quest 

После обновления данных контакта в AmoCRM соответствующие свойства будут обновлены в карточке лида в Carrot quest.

После обновления статуса сделки у пользователя будут создаваться события и добавляться свойства. Эти события могут служить триггерами для дальнейшей коммуникации. Например, если статус сделки не меняется в течение 5 дней, отправьте пользователю триггерное письмо или сообщение в чат с помощью Carrot quest. Возможно, ему нужна помощь или просто напоминание.

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

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

Создание интеграции

❗ Важно: В AmoCRM передаются только свойства лидов. О том, как создать свойство пользователя на основе его событий, читайте по этой ссылке.

Перейдите в раздел Интеграции и найдите amoCRM в списке интеграций. Нажмите на кнопку "Настроить" для создания новой интеграции. 

На первом шаге настройки выберите название интеграции.

Нажмите кнопку "Далее" и перейдите ко второму шагу для авторизации в интеграции. 

Выполните авторизацию в появившемся окне, выбрав аккаунт, который вы хотите подключить к Carrot quest:

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

После авторизации нажмите кнопку "Далее" для перехода к настройкам передачи данных в интеграции.

Настройка передачи данных лида

Важно:  ограничение интеграции — один запрос в секунду.

◾ Выберите события, после которых вы хотите отправлять данные в AmoCRM

Выберите события, после которых данные о лидах будут отправляться из Carrot quest в amoCRM. Также вы можете вручную запускать создание или обновление контакта в разделе диалоги через команду /amocrm

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

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

◾ Определите, какие свойства будут передаваться из Carrot quest в AmoCRM

Сопоставьте, в какие свойства amoCRM должны записываться свойства лида из Carrot quest. 
Важно: поля должны быть созданы в amoCRM заранее, тип поля "текст". Имя, email и телефон отправляются по умолчанию.

Сопоставьте информацию о событиях лида (дата первого/последнего свершения или количество выполнений) со свойствами в amoCRM.

Если такого поля не существует или название написано некорректно, данные в это поле не будут записаны.

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

◾ Определите, какие свойства будут передаваться из amoCRM в Carrot quest

❗ Важно: Информация будет передаваться только о тех контактах, у которых есть Carrot ID. То есть о тех, которых вы сначала передали из Carrot quest.

Когда в amoCRM меняется информация о контакте, отправленном из Carrot quest, в Carrot quest запишется актуальная информация. Впишите свойства контакта, которые будут отправляться из amoCRM в Carrot quest, и укажите, в какие свойства лида они должны записываться. Необходимо помнить, что информация будет собираться только из дополнительных полей контакта.

Имя контакта, email и телефон получаются из стандартных полей amoCRM и записываются в стандартные свойства Carrot quest. Вы можете отключить их сбор, но изменить соответствие между этими полями amoCRM и свойствами Carrot quest нельзя.

❗ Важно: Вы можете передавать в Carrot quest только пользовательские свойства AmoCRM, стандартные не передаются (за исключением имени, емейла и телефона).

Настройка передачи данных сделки

◾ Выберите события, после которых в amoCRM будет создаваться сделка для контакта. 

Это событие не зависит от настроенного триггера 1. Однако мы не рекомендуем настраивать одинаковые триггеры для создания сделки и контакта, чтобы избежать создания дублей контактов.

Это единственный способ создать сделку в amoCRM через Carrot quest.

Сделки называются по имени контакта в Carrot quest. Например, Иванов Иван Иванович или Алексей (в зависимости от того, как пользователи записаны у вас в системе).

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

◾  Выберите начальный статус сделки

Этот статус будет назначаться всем новым сделкам.

◾ Выберите данные сделки, которые будут отправляться из amoCRM в Carrot quest

При обновлении статуса сделки, созданной на основе лида из Carrot quest, и полей в Carrot quest будет приходить актуальная информация.

Настройте, какие свойства сделки необходимо возвращать из amoCRM в Carrot quest, а также какие события должны срабатывать в Carrot quest в зависимости от текущего статуса сделки.

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

❗ Важно: Данные сделки записываются только в основной контакт. Дополнительные контакты игнорируются. Если у основного контакта сделки нет Carrot ID (даже если он есть у дополнительных контактов) информация о сделке не будет передана в Carrot Quest.

Вы можете добавить свойства событий. Нажмите на иконку шестерёнки справа от поля события. Откроется всплывающее окно настройки. Нажмите “Добавить ещё свойство” и введите название свойств события. Затем нажмите кнопку “Обновить настройки”.

Помните, что стандартные свойства Carrot Quest начинаются со знака доллар “$”. Полный список стандартных свойств можно посмотреть здесь. Если свойство начинается не с $, то будет создано кастомное свойство с таким названием.

Чтобы указать в качестве свойства события Бюджет сделки введите в качестве названия свойства amoCRM текст price. 

◾ Выберите свойства сделки, которые запишутся в свойства лида Carrot quest

 image7.png

 

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

❗ Важно: Имя, емейл и телефон записываются в карточку пользователя Carrot Quest только из контакта, не из сделки.

🎉Сохраните интеграцию. Поздравляем! Ваша двусторонняя интеграция настроена.

Частые проблемы

amoCRM имеет ограничение — один запрос в секунду. При слишком частых запросах amoCRM может ограничить пользователю доступ к API.

Другими словами, если вы будете отправлять слишком много запросов в amoCRM, вас могут забанить. Чтобы избежать этого, внимательно отнеситесь к выбору триггера, отправляющего запрос в amoCRM (шаг 1 в настройке передачи свойств лидов/контактов и шаг 1 в настройке передачи свойств сделок).

Хорошим триггером будет достаточно специфическое событие. Например: добавил товар в корзину, оставил телефон/емейл.

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

Также проверьте, как у вас обновляются сделки в amoCRM. Если у вас настроена автоматизация и много сделок отправляются одновременно, это повлечёт создания большого количества запросов от Carrot quest и, как следствие, возможную блокировку в amoCRM.

Если amoCRM все-таки заблокировала передачу данных из-за частых запросов, проверьте настройки в Carrot quest (чтобы избежать повторения блокировки) и обратитесь в службу техподдержки amoCRM для разблокировки.

Работает на