Как интегрировать ваш магазин с API GetResponse?

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

Создание вашего магазина

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

• Name – название вашего магазина. Это внутреннее название, которое будет отображаться в вашем аккаунте.
• Locale – язык и региональные настройки для вашего магазина.
• Currency – валюта, используемая в вашем магазине.

После отправки информации о вашем магазине вы получите ответ с shopID, а также с деталями, которые вы предоставили. Этот shopID будет использоваться во всех API-вызовах, связанных с вашим магазином.

Создание продукта

Чтобы создать продукт, используйте вызов API createProduct. Вам понадобятся следующие данные:

• Name – название вашего продукта.
• URL – URL вашего продукта. Этот параметр является необязательным, но если вы его укажете, он будет использоваться во всех ссылках на ваш продукт в сообщениях, на лендингах и страницах из конструктора сайтов.
• Variants – это варианты вашего продукта, которые будут доступны для покупки клиентам. Если у вашего продукта есть несколько вариантов, таких как цвета или размеры, укажите их здесь. Для каждого варианта необходимо предоставить следующую информацию:
  • Name – название вашего варианта.
  • SKU – уникальный идентификатор варианта, используемый для отслеживания запасов.
  • Price – цена без налога. Эта цена будет отображаться во всех элементах, показывающих ваш продукт в сообщениях, лендингах и страницах конструктора сайтов.
  • priceTax – цена с налогом. Эта цена нигде не отображается.

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

Этот шаг является необязательным.

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

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

Чтобы создать категорию, используйте вызов API createCategory. Для создания категории необходимо указать только её название, но если вы хотите создать подкатегории, вы также можете указать parentId родительской категории.

Добавление вариантов к вашему продукту

Если вам нужно добавить дополнительные варианты к вашему продукту, вы можете сделать это с помощью вызова API createProductVariant. Вам нужно будет указать следующую информацию:

• Name – название вашего варианта.
• SKU – уникальный идентификатор варианта, используемый для отслеживания запасов.
• Price – цена без налога. Эта цена будет отображаться во всех элементах, показывающих ваш продукт в сообщениях, лендингах и страницах из конструктора сайтов.
• priceTax – цена с налогом. Эта цена нигде не отображается.

Обработка корзин и заказов клиентов

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

Создание корзины

Первый шаг в обработке корзины и заказа клиента — создать корзину для клиента с помощью вызова API createCart. Для этого необходимо предоставить следующую информацию:

• Contact ID – идентификатор вашего контакта. Этот ID можно получить с помощью вызова getContactList, getContactsFromCampaign или через вебхуки и обратные вызовы.
• TotalPrice – общая стоимость товаров в корзине.
• Currency – валюта для заказа.
• selectedVariants – выбранные клиентом варианты. Эти варианты должны содержать следующую информацию:
  • variantId – идентификатор варианта выбранного продукта.
  • quantity – количество выбранного продукта.
  • price – общая цена выбранного варианта.
  • taxPrice – цена варианта с учетом налога.
  • cartUrl – URL корзины. Этот параметр является необязательным, но он будет использоваться в кнопке призыва к действию в модуле брошенной корзины, поэтому рекомендуется его указать.

Удаление корзины

Вы можете удалить корзину с помощью вызова API deleteCart. Это используется, если вы хотите полностью закрыть корзину клиента или если корзина была преобразована в заказ.

Обновление корзины

Функция updateCart позволяет обновить вашу корзину.

Вы можете использовать её для добавления или удаления вариантов из корзины, обновления цены, изменения URL корзины или добавления внешних идентификаторов.

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

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

Заказ можно создать с помощью вызова API createOrder. Вы можете создать заказ без предварительного создания корзины, если не хотите обрабатывать брошенную корзину. Обязательные поля следующие:

• Contact ID – идентификатор вашего контакта. Этот ID можно получить с помощью вызова getContactList, getContactsFromCampaign или через вебхуки и обратные вызовы.
• TotalPrice – общая стоимость товаров в корзине.
• Currency – валюта для заказа.
• selectedVariants: Варианты, выбранные клиентом. Эти варианты должны содержать следующую информацию:
  • variantId – идентификатор варианта выбранного продукта.
  • quantity – количество выбранного продукта.
  • price – общая цена выбранного варианта.
  • taxPrice – цена варианта с учетом налога.
  • cartId – идентификатор корзины. Используется, если вы хотите привязать заказ к ранее созданной корзине.
• status (необязательно) – статус заказа. Это поле необязательно, но полезно, если вы хотите использовать отчеты по электронной коммерции в панели GetResponse.

Визуальное представление вашего магазина