Como integrar a tua loja com a API da GetResponse?

Se não estiver a utilizar nenhuma das plataformas de comércio eletrónico comuns com as quais nos integramos, pode criar uma integração personalizada através da API com a sua loja para utilizar a automatização para vários fluxos de trabalho de comércio eletrónico, como a recuperação de carrinhos abandonados.

Criar a tua loja

Para começar, cria primeiro uma loja utilizando a chamada à API createShop. Na chamada à API, tens de fornecer as seguintes informações:

Depois de submeteres a tua loja, receberás uma resposta com o ShopID e os dados que submeteste. Este ShopID será utilizado em todas as chamadas API relacionadas com a tua loja.

Criar um produto

Para criar um produto, utiliza a chamada createProduct. Precisarás dos seguintes dados:

• Nome – o nome do teu produto.
• URL – o URL do teu produto. É opcional, mas este é o URL que será utilizado em todas as ligações ao teu produto em mensagens, páginas de destino e páginas do construtor de sítios Web.
• Variantes – estas variantes são o que os teus clientes vão comprar. Se o teu produto tiver várias variantes, como cores ou tamanhos, podes listá-las aqui. As variantes requerem as seguintes informações:
  • Nome – o nome da tua variante.
  • SKU – Unidade de Manutenção de Stock, uma identificação única da tua variante utilizada para controlar o stock.
  • Preço – preço sem impostos. Este preço será apresentado em todos os elementos que apresentam o teu produto em mensagens, páginas de destino e páginas do construtor de sítios Web.
  • priceTax – preço com imposto. Este preço não é apresentado em lado nenhum.

Criar uma categoria

Este passo é opcional.

Uma vez criada a loja, podes criar algumas categorias para facilitar a ordenação dos teus produtos.

Os clientes que compraram algo de uma categoria podem ser usados em segmentos dinâmicos.

Para criar uma categoria, utiliza a chamada à API createCategory. Esta categoria requer apenas o nome da tua categoria, mas se quiseres ter subcategorias, podes também atribuir um parentId da categoria principal.

Adicionar variantes ao teu produto

Se precisares de acrescentar variantes adicionais ao teu produto, podes fazê-lo através da chamada createProductVariant . As informações que tens de incluir são:

• Nome – o nome da tua variante.
• SKU – Stock Keeping Unit, uma identificação única da tua variante utilizada para controlar o stock.
• Preço – preço sem impostos. Este preço será apresentado em todos os elementos que apresentam o teu produto em mensagens, páginas de destino e páginas do construtor de sítios Web.
• priceTax – preço com imposto. Este preço não é apresentado em lado nenhum.

Processar os carrinhos e as encomendas dos clientes

Quando este temporizador expirar, o contacto corresponderá à condição do carrinho abandonado e passará para o passo seguinte no fluxo de trabalho.

Criar um carrinho

O primeiro passo para processar o carrinho e a encomenda de um cliente é criar um carrinho para o cliente utilizando a chamada createCart. O carrinho requer as seguintes informações:

• ID do contacto – a ID do teu contacto. Esta ID pode ser obtida utilizando getContactList, getContactsFromCampaign ou através de webhooks e callbacks.
• TotalPrice – o preço total dos produtos no carrinho.
• Moeda – a moeda da encomenda.
• selectedVariants – as variantes selecionadas pelo cliente. Estas variantes têm de conter as seguintes informações:
  • variantId – o ID da variante de um produto selecionado.
  • quantidade – a quantidade do produto selecionado.
  • price – o preço total da variante selecionada.
  • taxPrice – o preço da variante com imposto.
  • cartUrl – este é o URL do carrinho. É opcional, mas será utilizado no botão de chamada para ação do carrinho no módulo de carrinho abandonado, pelo que se recomenda a sua inclusão.

Eliminar um carrinho

Podes eliminar um carrinho utilizando a chamada da API deleteCart. Isto é utilizado se quiseres fechar completamente o carrinho do cliente ou se o carrinho tiver sido convertido numa encomenda.

Atualização de um carrinho

A função updateCart permite-te atualizar o teu carrinho.

Podes utilizá-la para adicionar ou remover variantes do carrinho, atualizar o preço, atualizar o URL do carrinho ou adicionar quaisquer IDs externas.

Não são necessários valores nesta chamada, mas selectedVariants substituirá o conteúdo atual do carrinho, por isso certifica-te de que incluis todas as variantes selecionadas que o cliente tem no carrinho.

Criar uma encomenda

A encomenda pode ser criada utilizando a chamada à API createOrder. Podes criar uma encomenda sem criar um carrinho primeiro, se não quiseres processar um carrinho abandonado. Os campos obrigatórios são:

• ID do contacto – o ID do teu contacto. Esta ID pode ser obtida utilizando getContactList, getContactsFromCampaign ou através de webhooks e callbacks.
• TotalPrice – o preço total dos produtos no carrinho
• Moeda – a moeda da encomenda
• selectedVariants: As variantes selecionadas pelo cliente. Estas variantes têm de conter as seguintes informações:
  • variantId – o ID da variante de um produto selecionado
  • quantidade – a quantidade do produto selecionado
  • price – o preço total da variante selecionada.
  • taxPrice – o preço da variante com imposto
  • cartId – o ID do carrinho. Utilizado se quiseres associar a encomenda a um carrinho criado anteriormente.
• status (opcional) – o status da encomenda. Este campo é opcional, mas é útil se quiseres usar o relatório de comércio eletrónico no painel da GetResponse.

Uma representação visual da tua loja