CRM
Действие CRM позволяет отправлять данные в CRM-систему и принимать их обратно. Поддерживаются amoCRM и Битрикс24 — работа основана на API этих CRM.
- Платный аккаунт в amoCRM или Битрикс24 (API доступно только на платных тарифах CRM).
- Подключённая интеграция в Quescha.
Как использовать
- Добавьте интеграцию с нужной CRM.
- В действии CRM укажите направление обмена: отправить в CRM или принять из CRM.
- Выберите CRM (amoCRM или Битрикс24).
- Выберите нужную операцию и настройте её.
Состав полей вашей CRM — воронки, этапы, ответственные, дополнительные поля — подтягивается автоматически при подключении интеграции. В настройках операции дополнительные поля выбираются из списка по названию, ID подставляется сам.
Если вы изменили поля в CRM, нажмите «Обновить состав полей» рядом с выбором CRM. Рядом с кнопкой видно, загружен состав полей или нет.
Список полей может не загрузиться, если у пользователя интеграции нет прав администратора в CRM. Тогда поле ID остаётся обычным текстовым — как раньше, и ID можно найти через Помощник сущностей. Уже настроенные действия продолжают работать в любом случае.
[Self] после созданияПосле создания сделки или контакта из бота для дальнейших операций можно использовать шаблон [Self] в качестве ID сделки или контакта.
Так же дописывается карточка, созданная переключателем
«Создавать сделку при первом обращении»:
собрали в боте имя и телефон — и операцией «Изменить сделку» или
«Изменить контакт» с [Self] в поле ID дописали их в карточку. Отдельно
искать ID не нужно.
В операциях изменения [Self] в остальных полях означает текущее значение
поля — удобно, чтобы дописать к тексту, а не заменить его.
Рецепт создаёт новую сделку, а переключатель уже создал свою — на клиента получится две. Выберите одно: переключатель (сделка на каждое обращение, дальше дописываем операциями изменения) либо Рецепт (сделка после заполнения формы, сразу со всеми данными).
Сделка без настройки сценария
Если нужно просто, чтобы каждое обращение попадало в CRM, собирать сценарий не обязательно. На странице Интеграции у подключённой CRM нажмите «Связь с ботом» и включите переключатель «Создавать сделку при первом обращении». При появлении нового подписчика создастся сделка с контактом и привяжется к нему.
Переключатель создаёт обычный сценарий действий — его можно открыть и доработать.
Рядом есть второй переключатель — «Писать всю переписку в карточку»: сообщения клиента и ответы бота попадают в сделку примечаниями, отдельных действий для этого настраивать не нужно.
Подробнее: Связь CRM с ботом.
Операции amoCRM
Примечания сделок
| Операция | Что делает |
|---|---|
| Получить текст примечания сделки | Чтение существующего примечания. |
| Добавить примечание в сделку | Создание нового примечания. |
| Изменить примечание в сделке | Редактирование существующего. |
Примечания контактов
| Операция | Что делает |
|---|---|
| Получить текст примечания контакта | Чтение существующего примечания. |
| Добавить примечание в контакт | Создание нового примечания. |
| Изменить примечание в контакте | Редактирование существующего. |
Сделки
| Операция | Что делает |
|---|---|
| Получить сделку | Чтение данных сделки. |
| Создать сделку | Создание новой сделки. |
| Изменить сделку | Обновление полей сделки. |
| Добавить тег к сделке | Назначение тега. ID сущности может быть [Self]. |
| Удалить тег у сделки | Снятие тега. ID сущности может быть [Self]. |
Контакты и компании
| Операция | Что делает |
|---|---|
| Получить контакт | Чтение данных контакта. |
| Создать контакт | Создание нового контакта. |
| Изменить контакт | Обновление полей контакта. |
| Получить компанию | Чтение данных компании. |
| Создать компанию | Создание новой компании. |
| Изменить компанию | Обновление полей компании. |
Задачи
| Операция | Что делает |
|---|---|
| Получить задачу | Чтение данных задачи. |
| Добавить задачу | Создание новой задачи. |
| Изменить задачу | Обновление полей задачи. |
| Выполнить задачу | Перевод задачи в статус «выполнена». |
Неразобранное
| Операция | Что делает |
|---|---|
| Принять неразобранное | Перевод в работу. |
| Отклонить неразобранное | Отказ. |
Видеоинструкция
Операции Битрикс24
Комментарии
| Операция | Что делает |
|---|---|
| Получить комментарий | Чтение существующего комментария. |
| Добавить комментарий | Создание нового комментария. |
| Изменить комментарий | Редактирование комментария. |
| Удалить комментарий | Удаление комментария. |
Сделки
| Операция | Что делает |
|---|---|
| Получить сделку | Чтение данных сделки. |
| Создать сделку | Создание новой сделки. |
| Изменить сделку | Обновление полей сделки. |
| Удалить сделку | Удаление сделки. |
Лиды
| Операция | Что делает |
|---|---|
| Получить лид | Чтение данных лида. |
| Создать лид | Создание нового лида. |
| Изменить лид | Обновление полей лида. |
| Удалить лид | Удаление лида. |
Контакты и компании
| Операция | Что делает |
|---|---|
| Получить контакт | Чтение данных контакта. |
| Создать контакт | Создание нового контакта. |
| Изменить контакт | Обновление полей контакта. |
| Удалить контакт | Удаление контакта. |
| Получить компанию | Чтение данных компании. |
| Создать компанию | Создание новой компании. |
| Изменить компанию | Обновление полей компании. |
| Удалить компанию | Удаление компании. |
Задачи
| Операция | Что делает |
|---|---|
| Получить задачу | Чтение данных задачи. |
| Добавить задачу | Создание новой задачи. |
| Изменить задачу | Обновление полей задачи. |
| Удалить задачу | Удаление задачи. |
| Принять задачу | Подтверждение принятия задачи в работу. |
| Перевод в статус «завершена» | Закрытие задачи как выполненной. |
| Перевод в статус «отложена» | Откладывание задачи. |
| Отклонить задачу | Отказ от задачи. |
Видеоинструкция
Прикрепить файл
Операция «Прикрепить файл» есть у обеих CRM. Она забирает файл по адресу и загружает его в CRM — менеджер видит вложение прямо в карточке.
| Поле | Что указать |
|---|---|
| Куда прикрепить / Тип сущности | Сделка, контакт или компания. Не выбрано — сделка. |
| ID сущности | ID или переменная. Шаблон [Self] — сделка, привязанная к подписчику. |
| Адрес файла | По умолчанию #{media_url} — файл, который прислал подписчик. |
| Имя файла | Необязательно. Без него имя берётся из адреса. |
| Подпись к файлу только Битрикс24 | Текст комментария, к которому прикрепится файл. |
| Причина отказа | Переменная. Пустая при успехе, иначе короткое слово: download, size, upload, link. |
Ссылка #{media_url} ведёт на временную копию файла на сервере Квесчи: она
удаляется через минуту после пересылки, а для WhatsApp Business, Instagram
и Facebook — через 10 минут. Ставьте операцию сразу за получением файла,
иначе прикреплять будет уже нечего.
Именно поэтому файл загружается в CRM, а не даётся ссылкой: в карточке он должен остаться навсегда.
Переменная #{media_url} заполняется по-разному:
- сразу при получении сообщения — WhatsApp Business, Instagram, Facebook, Avito, Wildberries, Ozon, Циан, TikTok. Достаточно операции «Прикрепить файл».
- только после действия «Прием и пересылка медиа» — Telegram, VK, Viber, MAX, WhatsApp (green). Именно оно скачивает файл и заполняет переменную.
То есть в Телеграме цепочка такая: «Прием и пересылка медиа» → «Прикрепить файл», подряд в одном сценарии. Получателей пересылки указывать не нужно — файл достаточно скачать. Если клиент может прислать скриншот и картинкой, и файлом, поставьте два действия приёма подряд: с типом «Изображение» и с типом «Файл». Действие с несовпавшим типом просто пропускается.
Действие приёма медиа доступно на тарифах с пересылкой медиа.
До 20 МБ для amoCRM и до 8 МБ для Битрикс24 — в Битриксе файл передаётся внутри комментария, а такая передача увеличивает объём на треть.
Если в переменной с ID лежит выборка (массив), файл прикрепится к каждой сущности — как в остальных массовых операциях.
Массовые операции
В конструкторе можно проводить операции над сущностями CRM массово.
Для этого:
- Сделайте выборку из списка.
- Поместите её в переменные — так переменные будут содержать множество значений (массивы).
- Используйте эти переменные в поддерживаемой массовой операции.
Поместите в переменную выборку ID сделок, которые хотите изменить — и одной операцией обновите их все.
Поддерживаемые массовые операции
| amoCRM | Битрикс24 |
|---|---|
• Добавить примечание к сделке | • Добавить комментарий |
Не все операции с CRM поддерживают массовый режим. Перед запуском проверьте, есть ли нужная операция в таблице выше.