Menu da documentação

Shopify

Conecte uma loja Shopify para sincronizar seus clientes em uma lista de contatos do MailInApp, disparar jornadas a partir de eventos reais da loja, e ver a receita ser atribuída de volta a uma campanha ou variante.

Vídeo em inglês

Conecte sua loja

Para conectar uma loja, você cria um pequeno app para ela no seu próprio admin da Shopify e depois cola as duas chaves desse app no MailInApp. Leva cerca de cinco minutos. Você não precisa de uma conta Shopify Partner nem de código, e o app fica privado da sua loja.

Você precisa ser o proprietário da loja na Shopify (ou um colaborador com permissão para desenvolver apps) e o proprietário da sua conta MailInApp.

Passo 1: abra o Dev Dashboard

No admin da Shopify, vá em Configurações → Apps e clique em Develop apps, no canto superior direito.

A página Configurações → Apps do admin da Shopify, com o botão Develop apps destacado

Na página App development, clique em Build apps in Dev Dashboard. Na primeira vez, a Shopify pede que você confirme seu e-mail e entre de novo, e então cria uma organização de desenvolvedor com o nome da sua loja. Se a página Stores do Dev Dashboard disser "No stores yet", tudo bem: sua loja não precisa aparecer ali.

A página App development, com o botão Build apps in Dev Dashboard destacado

Passo 2: crie o app

No Dev Dashboard, abra Apps e clique em Create app e depois em Create app manually. Está tudo em um só formulário:

  • App name: qualquer nome que você reconheça, por exemplo MailInApp.
  • App URL: https://mailinapp.com/dashboard/settings/integrations. A Shopify abre esta página depois que você instala o app, então você cai no formulário de conexão do MailInApp com o endereço da loja já preenchido.
  • Embed app in Shopify admin: desmarque. Seu app não tem uma página dentro da Shopify.
  • Scopes: read_customers,read_orders,read_products,write_discounts. Eles permitem que o MailInApp leia seus clientes, pedidos e produtos e crie os códigos de desconto de uso único descritos abaixo. O MailInApp nunca altera seus produtos, pedidos ou clientes. Para alcançar pedidos com mais de uns 60 dias, adicione também read_all_orders: a Shopify o concede automaticamente ao seu próprio app.
  • Webhooks API version: deixe o padrão.

O formulário Create an app, com App URL, a caixa Embed app in Shopify admin desmarcada, os scopes e o botão Create app destacados

Clique em Create app. A Shopify pede que você lance a primeira versão: clique em Release.

A caixa de diálogo Release version, com o botão Release destacado

Passo 3: instale o app na sua loja

Na página Overview do app, clique em Test app no cartão Installs e escolha sua loja.

A página Overview do app, com o botão Test app destacado

A Shopify mostra a tela de instalação com os acessos de que o app precisa. Ela também avisa que o app não foi revisado. Isso é esperado, porque o app é seu e nunca passa pela App Store. Clique em Install.

A tela de instalação de app da Shopify, com o botão Install destacado

Agora sua loja lista o app em Configurações → Apps.

Passo 4: cole as chaves no MailInApp

De volta à página Overview do app no Dev Dashboard, o cartão Credentials tem o Client ID e o Client secret. O secret fica oculto; o botão de copiar dele copia o valor.

O cartão Credentials na página Overview do app, com os campos Client ID e Client secret

No MailInApp, abra Configurações → Integrações. No cartão da Shopify, informe o endereço da loja (sua-loja.myshopify.com), cole o Client ID e o Client secret e clique em Conectar Shopify. O MailInApp pode pedir que você entre de novo antes, já que as chaves dão acesso total aos dados da sua loja.

O cartão do Shopify em Configurações → Integrações, com o endereço da loja preenchido e o botão Conectar Shopify destacado

O MailInApp verifica as chaves com a Shopify, criptografa o Client secret e nunca mais o exibe. Depois cria uma lista de contatos para a loja e, em segundo plano, sincroniza seus clientes (até 5.000 nesta primeira passagem; os seguintes chegam à medida que são criados) e seu catálogo de produtos.

Deixe a IP allowlist nas configurações do seu app desativada. Se estiver ativada, a Shopify recusa as solicitações do MailInApp.

Conectar a Shopify é grátis em todos os planos, incluindo o Gratuito. Seu plano MailInApp é cobrado pela MailInApp como sempre, em Configurações → Plano e uso. Todo o seu catálogo de produtos é sincronizado em todos os planos, e cada plano inclui uma cota mensal de códigos de desconto da loja.

Se a conexão falhar

O cartão da Shopify diz o que deu errado:

  • A Shopify não aceitou esse Client ID e esse Client secret: copie os dois de novo do cartão Credentials. Se você gerou um novo secret, use o novo.
  • O app não está instalado nesta loja: refaça o passo 3 (Test app e depois Install).
  • Faltam estes scopes de acesso no seu app: no Dev Dashboard, abra Versions do app, crie uma nova versão com os scopes do passo 2, lance-a e conecte de novo.
  • Este app pertence a outra organização da Shopify: crie o app pelo admin da sua própria loja, como no passo 1, e não por outra conta Partner ou de desenvolvedor.
  • Esse não é um endereço de loja Shopify: use o endereço myshopify.com que aparece abaixo do nome da loja em Configurações, não o seu domínio próprio.

O que isso faz

  • Sincronização de clientes: os clientes do Shopify chegam em uma lista de contatos restrita a esta integração, mantida atualizada depois disso pelos próprios webhooks do Shopify (customers/create, além de checkouts/create e orders/paid para os gatilhos abaixo) em vez de uma nova varredura periódica.
  • Gatilhos de jornada: uma loja conectada pode disparar o gatilho Carrinho abandonado de uma jornada (um checkout iniciado, mas não concluído) e seu gatilho Compra (um pedido pago), para que uma série de boas-vindas ou uma automação de carrinho abandonado possa rodar a partir de atividade real do Shopify, em vez de depender apenas do checkout do bloco Produto próprio do MailInApp. Veja Jornadas.
  • Atribuição de receita: a campanha/variante do próprio pedido, quando identificável, entra nos mesmos números de receita de resposta e de teste A/B que um pedido do checkout nativo já produz.
  • Segmentos de histórico de compras e ofertas de desconto: os itens de linha do pedido sincronizam junto com os clientes, então um filtro de público pode corresponder a "comprou o produto X entre a data A e B" (veja Histórico de compras), e um projeto pode gerar um código de desconto do Shopify de uso único por destinatário correspondente, resgatável no checkout da sua própria loja (veja Oferta de desconto). Novos pedidos sincronizam automaticamente a partir do webhook orders/paid. Para pedidos feitos antes de você conectar, use Trazer histórico de pedidos uma vez em Configurações → Integrações; a Shopify limita isso a aproximadamente os últimos 60 dias. Um bloco Produto importado do seu catálogo pode gerar independentemente seu próprio Desconto por produto, restrito apenas a esse item, sem necessidade de filtro de público: veja Descontos nativos da loja e Códigos de desconto de produto do Shopify.
  • Catálogo de produtos para o estúdio: as próprias listagens ativas da sua loja também sincronizam com o MailInApp, atualizadas automaticamente na mesma frequência que os clientes (sem botão separado). O seletor Importar da loja do bloco Produto busca nesse catálogo sincronizado e preenche o nome, a descrição, a imagem e o preço de um bloco a partir de um produto real. É uma cópia única, não um link ao vivo, então nada em um e-mail enviado pode se distanciar do que você revisou. Ele também sincroniza a página própria de cada produto (a partir do seu handle do Shopify) e, quando ela está disponível, define o bloco para Link para checkout de loja externa apontando direto para ela, então um produto importado já fica pronto para vender na sua loja Shopify sem mais nada a configurar. Volte manualmente para Checkout do MailInApp se preferir receber o pagamento pela sua conta Stripe conectada.

Avaliações da loja

O Shopify não guarda avaliações próprias, então o MailInApp as lê do Judge.me, o app de avaliações da sua loja:

  1. No Judge.me, abra Settings → Integrations e clique em View API token. Copie o token privado.
  2. No MailInApp, abra Configurações → Integrações. No cartão da sua loja, em Judge.me, cole o token e clique em Conectar Judge.me.

O MailInApp verifica o token com o Judge.me e depois sincroniza suas avaliações, e de novo a cada sincronização da loja. Ele guarda só as avaliações publicadas na sua loja (nem ocultas nem aguardando aprovação no Judge.me), no máximo as 5.000 mais recentes. Uma avaliação que você oculta ou exclui no Judge.me some depois da próxima sincronização. O MailInApp nunca guarda o e-mail de quem avaliou e mostra o nome como primeiro nome e inicial do sobrenome. O cartão mostra quantas avaliações estão sincronizadas, e Sincronizar avaliações agora sincroniza na hora.

O token só é usado para ler avaliações. Desconectar Judge.me exclui o token e as avaliações sincronizadas, assim como desconectar a loja. As estrelas dos produtos importados não precisam do token: vêm da nota que o Judge.me já salva em cada produto no Shopify. Veja Avaliações da loja para estrelas, avaliações nos e-mails e publicação.

Integridade da conexão e atualização das chaves

O MailInApp troca as chaves do seu app por um token de acesso de curta duração da Shopify (vale cerca de um dia) e obtém um novo sozinho antes que ele expire. Em uso normal, nada precisa ser feito.

Se as chaves pararem de funcionar, o MailInApp interrompe a sincronização, e o cartão da Shopify em Configurações → Integrações mostra Requer atenção e diz o motivo:

  • As chaves do seu app da Shopify pararam de funcionar: o secret foi revogado ou o app foi excluído. Clique em Atualizar chaves e cole o Client ID e o Client secret atuais do app.
  • Seu app da Shopify não está mais instalado na loja: o app foi desinstalado da sua loja. Instale-o de novo pela página Overview dele (Test app). As chaves continuam as mesmas, então o MailInApp se reconecta sozinho em até 6 horas e configura seus webhooks de novo. Para reconectar na hora, clique em Atualizar chaves e cole-as.

Para trocar o Client secret (por exemplo, como hábito de segurança regular), faça em duas etapas para que a loja nunca se desconecte:

  1. No Dev Dashboard, abra Settings do app e clique em Generate new secret. Os dois secrets funcionam até você revogar o antigo.
  2. No MailInApp, clique em Atualizar chaves no cartão da Shopify e cole o novo secret.
  3. De volta ao Dev Dashboard, revogue o secret antigo.

A Shopify continua assinando seus webhooks com o secret antigo até você revogá-lo, e o MailInApp aceita qualquer um dos dois nesse meio-tempo, pelo tempo que for preciso. Atualizar chaves também muda uma loja para outro app seu: cole o Client ID e o secret desse app.

Desconectando

Desconectar em Configurações → Integrações interrompe a sincronização e qualquer processamento adicional de webhook imediatamente. O MailInApp remove seus webhooks do seu app e apaga as chaves armazenadas. Depois você pode desinstalar o app da sua loja ou excluí-lo no Dev Dashboard.

Desinstalar o app sem desconectar antes só pausa a loja: o cartão diz que o app não está instalado, e uma reinstalação continua de onde parou. Se o app ficar desinstalado por 30 dias, o MailInApp apaga as chaves armazenadas e desconecta a loja. Para conectar de novo uma loja desconectada, preencha o formulário no cartão da Shopify. Ele começa com o endereço da loja, e a loja mantém sua lista de contatos.

Os códigos de desconto que o MailInApp já criou na sua loja (começam com MIA-) continuam na Shopify quando você desinstala o app ou desconecta, e funcionam até expirar, então os códigos dos emails já enviados continuam valendo. A tela de desinstalação da Shopify diz que os descontos do app serão excluídos; isso se refere aos descontos que o próprio app executa, e o MailInApp não cria esse tipo. Para encerrar os códigos antes, exclua-os no admin da Shopify, em Discounts.

Os clientes já sincronizados permanecem na lista de contatos: desconectar uma integração nunca exclui contatos, já que eles podem já ser um público de envio para outros projetos. Exclua a lista você mesmo se não precisar mais dela.

O MailInApp guarda os clientes da sua loja em seu nome. Seu próprio app não repassa ao MailInApp as solicitações de exclusão de dados de clientes da Shopify, então, quando um cliente pedir para você excluir os dados dele, apague-o também no MailInApp, pelo perfil do contato (veja Exportando ou apagando os dados de um Destinatário). O mesmo vale para uma desinstalação: a tela de desinstalação da Shopify diz que o desenvolvedor do app será solicitado a excluir os dados dos clientes em até 48 horas. No seu próprio app, esse desenvolvedor é você, e a Shopify não repassa essa solicitação ao MailInApp, então exclua você mesmo a lista de contatos da loja se quiser que ela suma.