Настройка модуля Tilda-RetailCRM

• • Настройка в системе RetailCRM
  • Базовая настройка модуля
  • — Вкладка «Магазин»
  • — Вкладка «Пользовательские поля»
  • — Вкладка «Доставка»
  • — Вкладка «CDEK»
  • — Вкладка «Оплата»
  • — Вкладка «ЮКасса»
  • Настройка сайта Tilda
  • Настройка каталога товаров
  • Настройка полей заказа

  Настройка в системе RetailCRM

   

  • Перейдите в RetailCRM «Настройки/Магазины/Магазины».
  • В данном блоке настроек нажмите кнопку «Добавить».
  • Для каждого магазина Tilda создайте магазин в RetailCRM.

   

  

   

  — Создание API-ключа в RetailCRM

  Для работы модуля, потребуется создать API-ключ в системе RetailCRM. Для этого перейдите в блок настроек «Настройки/Интеграция/Ключи доступа к API» . На данной странице настроек нажмите синюю кнопку «Добавить».

  Примечание: Не рекомендуется использовать уже существующий API-ключ. Для каждой интеграции создавайте новый API-ключ.

  Необходимые доступы расположены в Приложении 1.

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

  

   

   

  — Подключение модуля

  Для перехода в личный кабинет модуля требуется перейти в следующий блок настроек «Настройки/Интеграция/Маркетплейс». Находим модуль » Tilda (студия Сергея Ткаченко)» — «Перейти в личный кабинет».

   

  

   

   

  Базовая настройка модуля

         1. Настройка блока «Модуль»

  В поле «Ссылка на RetailCRM» введите адрес вашей RetailCRM.
  В поле «Ключ доступа к API» введите ключ, скопированный вами в пункте 2 документации.

  

   

         2. Настройка блока «WebHooks»

  Нажмите зеленую кнопку Добавить WebHooks.

  
  Появится вариант работы экземпляра модуля. Заказы или Клиенты
  Заказы — работа в стандартном режиме. Передача заказов/клиентов/товаров
  Клиенты — по этому вебхуку будут создаваться только клиенты.
  Далее в появившемся окне появится справочник, в который автоматически подтянутся созданные магазины в RetailCRM. Максимально возможно добавить до 4 магазинов. Выберите нужный магазин, и нажмите «Сохранить».После нажмите на синюю кнопку с иконкой гаечного ключа.

  Режим передачи Клиентов

  — Вкладка «Основные»

  Поставить метку о подписке — Выбор пользовательских полей типа Флажок (да/нет). У клиентов, созданных этим экземпляром модуля, выбранное поле будет устанавливаться в состояние «да»
  Поставить метку formid — Выбор пользовательских полей заказа Retail типа Строка/Текст. У клиентов, созданных этим экземпляром модуля, в выбранное поле будет записываться название формы, с которой пришла информация о клиенте. Пример значения: «form426484400».
  Веб-хук URL — данных вебхук необходимо будет подключить в Tilda к тем формам, с которых потребуется создавать клиентов.

  — Вкладка «POST-запрос»
  После того, как подключите вебхук к форме и отправите на него информацию о клиенте, посмотреть её можно будет в запросе на этой вкладке.

  Добавление клиентов, созданных модулем, в сегменты RetailCRM:
  — Для начала перейдите в Retail в Маркетинг — Сегменты
  — Добавить фильтр. В перечне выберите поле, которое выбрали в предыдущей настройке «Поставить метку formid».
  — Добавьте этому полю необходимое значение/значения формы, у нас это было form426484400(проверить можно на вкладке «POST-запрос»

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

  

  
  Режим передачи Заказов

  — Вкладка «Магазин»

  «Магазин RetailCRM» подтягивается автоматически, но также можно изменить его, нажав на поле и выбрав нужный из выпадающего списка

  «Способ оформления заказов» — необходимо из выпадающего списка выбрать нужный способ оформления (будет проставляться в заказе)

  «Статус нового заказа» — это поле позволяет выбрать статус, в котором будут приходить новые заказы в RetailCRM из Tilda

  «Идентификатор продуктов» — необходимо выбрать тот способ связи, по которому будет происходить синхронизация (смотрите Приложении 2)

  Внешний ID торгового предложения — используем, если товары подтягиваются из Tilda

  Артикул товара — используем, если товары подтягиваются из любых источников, кроме Tilda

  Название продукта и Артикул торгового предложения —  используем, если товары подтягиваются из любых источников, кроме Tilda

  При работе с товарами включающими модификации, на веб-хук сформированный модулем теперь приходит externalid товара-модификации для последующей связи с системой RetailCRM

  Скопируйте Веб-хук URL он нам понадобится для дальнейшей настройки

  

   

  Настройка сайта Tilda

  — Настройка Webhook

  1) На сайте Tilda перейдите во вкладку «Мои сайты». Выберите нужный магазин, и нажмите «Редактировать сайт/Настройки сайта/Формы»

   

  

  

   

  В данном блоке настроек в списке выберите Webhook в подгруппе «Другое»

  

   

  В поле WEBHOOK URL внесите скопированный вами в шаге 4 Веб-хук URL.

  Поле API METHOD нам не понадобится.

  Нажимаем Добавить.

  

   

  Затем во вкладке «Формы», в списке подключенные сервисы, появится запись формата «Webhook: (Скопированный вами URL)». Нажмите Настройки.

  

   

  Поле WEBHOOK URL — изменения не нужны.

  Поле API METHOD нам не понадобится.

  «Дополнительные настройки» :

  — Посылать Cookies — заполняется по желанию.

  — Передавать данные по товарам в заказе — массивом — обязательно включить

  — Передавать externalid в товарах — понадобится при сопоставлении товаров, если есть связка Tilda — МойСклад или Tilda — 1С. Если же такой связки нет — каталог выгружается из Tilda — оставляем неактивной (смотрите Приложение 2)

  — Отправлять данные в виде application/json — не используется

  — Отправлять только после оплаты — проставляем, если необходимо получать только оплаченные заказы. В случае, если необходимо сразу получать даже не оплаченные заказы, не включаем.
  В дальнейшем статусы будут приходить на второй вебхук. Найти его можно на вкладке модуля «Оплаты»
  Название в списке — заполните RetailCRM-Tilda (нужно для удобной идентификации веб-хука)

  

  Создайте в Tilda тестовый заказ или дождитесь заказа от покупателя.

  Заполните ссылаясь на Post-запрос (Пример будет ниже)

  После нажмите кнопку Сохранить и «Подключить сервис ко всем формам на сайте» (маленькая надпись снизу страницы)

  

   

  Теперь требуется переопубликовать страницы на сайте. Заходим в редактирование нужного сайта и нажимаем Опубликовать все страницы

  

   

  Настройка каталога товаров

  На странице «Редактировать сайт» выберете пункт Товары

  

   

  На открывшейся странице наведите курсор на троеточие и выберите «Скачать список товаров в YML«, так как он наиболее близок к формату RetailCRM

  

   

  1. Заполните название компании (можно любое слово написать, не играет роли);
  2. Выберите нужный раздел для выгрузки товаров, если нужно выгрузить всё — не вносите изменение;
  3. Заполните дополнительные настройки при необходимости;
  4. Активируйте ССЫЛКА НА YML и скопируйте появившуюся ссылку;
  5. Нажмите Начать экспорт;

  Примечание: теперь мы передаём ещё и остатки!

  Далее понадобится только скопированная ссылка.

   

  

   

  Дальнейшая настройка модуля

   

  — Загрузка каталога в RetailCRM

  Вернитесь в личный кабинет модуля в RetailCRM, зайдите в вкладку магазины и перейдите в раздел Каталог.

  В данном блоке выберите способ формирования «Ссылка на YAML файл» и вставьте ссылку, скопированную ранее. Нажмите Сохранить.

  Перезагрузите страницу и скопируйте постоянную ссылку (Постоянная ссылка на ICML каталог)

  

   

  Загружаем каталог в магазин RetailCRM:

  1. Перейдите в RetailCRM «Настройки/Магазины/Магазины»
  2. Перейдите в нужный магазин, во вкладку «Каталог»
  3. В поле «Каталог» выберите «Загружать из ICML
  4. В поле URL ICML-файла вставьте скопированную ранее ссылку
  5. Поставьте галку напротив «Загрузить каталог из ICML сейчас»

  

   

  Можно также производить выгрузку каталога не только с Tilda, но и с других источников — МойСклад, 1С и тд. Но тогда для этого нужно использовать другие способы.

  Итак, если используем МойСклад, 1С и тд, то необходимо совершить экспорт каталога из настроек, а потом загрузить этот каталог в  RetailCRM (как это сделать описано ранее).

   

  Настройка полей заказа

  1. Имя — Имя в RetailCRM. Если в файле ФИО заполняется в одну строку, необходимо передавать в поле имя. Если необходимо, чтобы в RetailCRM ФИО попадали раздельно, то на сайте потребуется сделать раздельную форму
  2. Сопоставлять клиентов по E-mail — активируйте чек-бокс, если при заполнении заявки клиенты не указывают номер, но указывают почту.
  3. Передавать Свойства товаров — активируйте чек-бокс, если нужно передавать свойства товаров Tilda в одноименное поле RetailCRM.

  Чек-бокс Сопоставлять клиентов по E-mail — активируйте чек-бокс, если при заполнении заявки клиенты не указывают номер, но указывают почту.

  Чек-бокс Передавать Свойства товаров — активируйте чек-бокс, если нужно передавать свойства товаров Tilda в одноименное поле RetailCRM.

  

   

  Пример заполнения полей:

  Смотрите на название поля в POST- запросе (справа) и выбираете его из списка к полю RetailCRM (слева)

  

   

   

  — Вкладка «Пользовательские поля»

  В модуле возможно сопоставление пользовательских полей в RetailCRM с полями в Тильде.

  1. Нажмите Добавить новое сопоставление

  

   

  2.  Выберите пользовательское поле RetailCRM и символьный код поля в Тильде
  3. Нажмите Сохранить

  

  Передача ClientID из заказа Tilda в Кастомное поле Retail.
  При активированной в вебхуке Tilda передаче Cookies, передаются идентификаторы клиента.
  На примере Yandex Client ID, сопоставление этого идентификатора с полем заказа выглядит следующим образом:
  

   

  Создаём кастомное поле

  Переходим в Настройки/Системные/Пользовательские поля и нажимаем «Добавить». Добавить для сопоставления можно только поля в заказе

  

   

  Теперь заполняем основные поля и нажимаем «Сохранить». После возвращаемся в настройки модуля, обновляем страницу и делаем сопоставление полей.

   

  — Вкладка «Доставка» 

  Поля данной вкладки заполняются аналогично настройкам на вкладке Основные поля. Для выбора значений необходимо обратиться к POST-запросу и сопоставить поля.

  

   

  Для добавления типа доставки нажимаем Добавить новое сопоставление.

  Выбираем тип доставки RetailCRM и прописываем название доставки из Тильда — значение, содержащее наименование доставки. Тип доставки чаще всего находится в блоке payment(delivery)

  При внесении изменений в доставки на стороне Tilda — создание новых или переименование существующих, необходимо обновить настройки на стороне модуля

  Пример приведён ниже. 

  

   

  Пример заполнения раздела Доставка

  Основные поля

  

  Важно: Настройка времени доставки обрабатывает строки вида: 00:00 или 00:00-01:00
  В заказе Retail это поле не выбирается, а сопоставляется со стандартным полем «время доставки»

  Обращаем ваше внимание, что для лучшей передачи адресов в RetailCRM, производится их корректировка по следующему принципу:
  ‘кв/оф.’ — ‘кв.’
  ‘build.’ —  ‘корп.’
  ‘struct’ — ‘стр.’
  ‘пер’ — ‘пер.’
  ‘пр-кт’ — ‘пр-кт.’
  ‘ш’ — ‘ш.’
  ‘пл’ — ‘пл.’
  ‘проезд’ — ‘пр-д.’
  ‘ул’ — ‘ ул.’

   

  Тип доставки

  
  — Вкладка «CDEK»

  Тип интегрированной доставки CDEK в RetailCRM — Здесь выбираем тип доставки, автоматически созданной подключенным модулем СДЕК 2.0
  Идентификатор клиента API CDEK — Идентификатор из настроек интеграции Личного Кабинета СДЕК
  Ключ API CDEK — Ключ из настроек интеграции Личного Кабинета СДЕК
  
  

   

  — Вкладка «Оплата» 

  1. Нажимаем «Добавить новое сопоставление»
  2. Заполняем данные:

  • —  Веб-хук для оплат — Дополнительный вебхук, по которому будет передаваться статус оплаты заказ после его оплаты в Тильде
    При добавлении его в формы обязательно включите опцию «Отправлять данные после оплаты». Остальные настройки хука аналогичные тому, который подключали ранее.
  • — Оплата в RetailCRM — вид платежа в RetailCRM;
  • — Код статуса НЕ оплаты в RetailCRM — статус оплаты Retail для неоплаченных заказов;
  • — Код статуса оплаты в RetailCRM — статус оплаты Retail, в который будет переводиться заказ после оплаты в Тильда;
  • — Код типа оплаты в Tilda — оплата, с которой будет сопоставляться оплата в RetailCRM

  
  При добавлении сопоставления оплат выбрать можно только неинтегрированные способы оплаты. Т.е., если и на сайте, например, используется Юkassa, и в RetailCRM Юkassa, то это должны быть два разных типа оплаты.

  При сопоставлении статусов оплаты возможны 2 способа работы модуля. По первому способу в систему будут приходить только оплаченные заказы, соответственно потребуется добавить сопоставление статуса по коду «Оплачен(paid)»

  Код оплаты в Tilda можно посмотреть в блоке настроек сайта «Заявки».  Потребуется создать тестовый заказ с необходимым типом оплаты, после чего в заявках в графе оплаты можно будет увидеть символьный код оплаты в строке «Система»

  

   

  По второму способу в систему будут приходить все заказы независимо от статуса оплаты, и менеджеру потребуется проставить их вручную. Изменение способа передачи заказов с сайта в систему происходит с помощью изменения настроек на стороне сайта следующим образом. В настройках Tilda перейдите в «Настройка сайта/Платежные системы».

  

  В данном блоке перейдите в настройки используемой вами платежной системы. Затем пролистайте страницу настроек до блока настроек «Отправлять данные в сервисы приема данных только после оплаты»

  

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

  Для каждой платежной системы возможно выставить разные способы передачи заказов.

   

  — Вкладка «ЮKassa»

  Если вы используете в Tilda оплату ЮKassa, то теперь возможно получать информацию об оплате в RetailCRM непосредственно из самой ЮKassa после оплаты клиентом заказа . В модуле реализованы 2 похода .  Получение статуса оплаты из Тильды и получение оплаты напрямую из кассы. Мы рекомендуем переходить на  первый вариант  ( вкладка «Оплаты») и получать все оплаты из Тильды. Т.е. клиент оплатил на сайте , затем оплата пришла в Тильду и затем по веб-хуку пришла в Retailcrm.

  

   

  Заполняем поля:

  Идентификатор заказа RetailCRM — заказы идентифицируется по полю платежа description, укажите с чем его сопоставить.

  Тип оплаты RetailCRM — тип оплаты RetailCRM, который добавляться в заказ.

  Статус успешной оплаты — статус оплаты RetailCRM.

  Статус отмены платежа — статус оплаты RetailCRM.

  Статус возврата платежа — статус оплаты RetailCRM.

  URL для HTTP-уведомления — вставляем в ЮKassa для перенаправления запроса в редактировании запроса.
  ВАЖНО: Не должна быть выбрана «Готовая интеграция», иначе URL поменять не удастся

   

  
  

   

  В каждом из блоков вы можете нажать надпись «(Помощь)», справа от названия блока настроек — это мини-подсказки 

   

  Приложение 1.

  Необходимые методы API для ключа RetailCRM:

  

  Приложение 2.
  Сопоставление товаров необходимо для связи товаров между системами.

  С стороны Tilda это может быть:

  • Внешний код (externalId);

  • Артикул (sku);

  • Название.

  Стороны RetailCRM:

  • Внешний код торгового предложения;

  • Артикул товара;

  • Артикул торгового предложения;

  • Название торгового предложения;

  • Название продукта и Артикул торгового предложения.

  Возможные варианты:

  1. Товары заведены руками в RetailCRM;
  2. Товары загружены из складской МойСклад.

  Чаще всего при таких вариантах с стороны RetailCRM выбирается Артикул, а с стороны Tilda Артикул (sku) или внешний код (externalId)

  Пример как определять:

  1. Выбираем товар и копируем его артикул (рис. 1)
  2. Заходим в товары и вставляем в поле для поиска (рис. 2)

  Если всё подошло, то с обоих сторон будет идентификатор Артикул, если нет, то заходим в товар и смотрим на поле ВНЕШНИЙ КОД ТОВАРА (рис. 3)

  Итог идентификатор в обоих системах — артикул

  

  Рисунок 1

   

  

  Рисунок 2

   

  

  Рисунок 3

   

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

  1. В RetailCRM перейти Настройки/Системные/Заказы
     
  2. В строку строке указать {externalid}, так как именно в этот параметр фида передаётся номер заказа
     

  Стоит учесть, что в RetailCRM номер заказа будет приходить в виде Tilda-12345
  Если вам необходимо убрать этот префикс Tilda-, то вы можете к нам обратиться за доп. настройкой