amoCRM

Как подключить интеграцию amoCRM в чат-бота

Подключение интеграции

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

На странице интеграций нажимаем кнопку "Добавить интеграцию", затем выберем amoCRM. Откроется окно выдачи доступа. Выбираем нужный нам аккаунт и нажимаем кнопку Разрешить

Готово, интеграци подключена. Создаем бота, в котором мы будем собирать и передавать данные в amoCRM

Действия со сделками

Перед работой с переменными, рекомендуем ознакомиться со статьей по работе со сложными переменными

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

Создать сделку

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

Для дальнейшей возможности работы со сделкой пользователя нам нужно получить ID этой сделки. При создании сделки, ID будет хранится в переменной {%i.response.lead.id%}

У каждой сделки ID индивидуальный, поэтому сохраняем его в пользовательскую переменную

Пример бота

После прохождения данного бота, в amoCRM у нас будет создана сделка

Изменить сделку

В поле ID сделки вставляем переменную, в которую мы ранее сохранили ID созданной сделки. Заполняем все поля. Если оставить поле пустым, то в самой сделке в amoCRM данное поле тоже обнулится. Например, нам надо изменить цену сделки и этап в воронке. Чтобы новое примечание не создалось, поле оставляем пустым

Изменить этап сделки

Например, нам нужно только поменять этап сделки и добавить примечание от пользователя. Создаем действие Изменить этап сделки, заполняем поля

Пример бота

После прохода пользователем бота, информация в amoCRM обновится

Установить тег сделки

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

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

Дополнительное поле

Есть несколько типов дополнительных полей, каждому полю вы можете дать свое имя

Текст - позволяет создать дополнительно поле и передать в него текст
Флаг - позволяет создать чек-бокс, который вы можете переключать
Дата - создает поле с датой, в котором есть возможность открыть календарь
Выпадающий список - создает выпадающий список

Создать дополнительное поле

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

Создаем действие и заполняем поля. Тип поля выберем текст. Для возможности в будущем работать с данным поле в amoCRM нам нужно получить ID этого поля. ID первого созданного поля будет хранится в переменной {%i.response.custom_fields_values.0.field_id%} Cохраняем в пользовательскую переменную с названием нашего поля (Рекомендуем самостоятельно проверять в какой переменной у вас хранится нужный вам ID, так как в массиве custom_fields_values могут быть и другие данные)

Пример бота

Теперь в amoCRM у нас появилось новое поле с названием Город

Изменить дополнительно поле

Данное действие позволяет изменить значение в дополнительном поле. Создаем действие, заполняем поля. ID поля мы получили ранее и сохранили в пользовательскую переменную

После прохождения пользователем бота, информация в сделке обновляется

Удалить дополнительно поле

Данное действие позволит удалить дополнительное поле. Поле удалится у всех сделок

После прохода бота, дополнительное поле будет удалено

Получить значение дополнительного поля

Данное действие позволит получить нам значение из дополнительного поля сделки. Создаем действие и заполняем информацию

Значение полученно из amoCRM хранится в переменной {%i.response%}

Пример бота с получением ответа

Примечание

Создать примечание

Действие создает новое примечание в карточке сделки. Создаем действие, заполняем поля. Для того, чтобы иметь возможность работать с данным примечанием, нам нужно получить его ID. ID будет хранится в переменной {%i.response.id%} Сохраняем в пользовательскую переменную

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

Изменить примечание

Данное действие позволит изменить существующее примечание. Для этого нам понадобится ID примечания. Его мы ранее сохранили в пользовательскую переменную. Заполняем поля

После прохождения данного блока, созданное ранее примечание будет отредактировано

Получить значение примечания

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

Ответ от amoCRM будет хранится в переменной {%i.response%}. Выводим ее пользователю

Пример бота

Действия с контактами

Создать/обновить контакт

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

Создаем действие, заполняем поля. Для возомжности взаимодействия с контактом в будущем, нам нужно получить ID этого контакта и сохранить в пользовательскую переменную. ID будет гаходится в переменной {%i.response.contact.id%}

Пример бота

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

Дополнительное поле

Так же как и в сделках, у нас есть 4 тип дополнительного поля, а именно

Текст - позволяет создать дополнительно поле и передать в него текст
Флаг - позволяет создать чек-бокс, который вы можете переключать
Дата - создает поле с датой, в котором есть возможность открыть календарь
Выпадающий список - создает выпадающий список

Принцип работы с полями в Контакте точно такой же как и в Сделке

Примечание

Создать примечание

Действие создает новое примечание в карточке контакта. Создаем действие, заполняем поля. Для того, чтобы иметь возможность работать с данным примечанием, нам нужно получить его ID. ID будет хранится в переменной {%i.response.id%} Сохраняем в пользовательскую переменную