Perguntas frequentes

Perguntas frequentes

Copiar página

Perguntas frequentes sobre e-mails transacionais e solicitações HTTP no Shopify Flow: planos, entregabilidade, permissões, provedores e dados.

Respostas às perguntas que recebemos com mais frequência. Caso a sua pergunta não esteja aqui, o guia Histórico e solução de problemas aborda as falhas em detalhes; caso contrário, utilize a Central de ajuda para entrar em contato conosco.

Preciso de um plano pago do Shopify para enviar solicitações HTTP?

Não. A ação Enviar solicitação HTTP do próprio Shopify está restrita a determinados planos, mas a ação HTTP Request deste aplicativo funciona em todos os planos do Shopify, inclusive no Básico. Essa é uma das principais razões pelas quais os lojistas o instalam.

A quais dados do Shopify o aplicativo tem acesso?

Nenhum. O aplicativo não solicita nenhum escopo de acesso. Ele não pode acessar seus produtos, pedidos ou clientes.

Quaisquer dados de clientes que acabem em um e-mail chegam lá porque o(a) senhor(a) os transmitiu do Shopify Flow por meio do campo Variáveis (JSON). Shopify Flow lê os dados da sua loja, e o(a) senhor(a) escolhe o que deseja transmitir.

Quais provedores de e-mail posso utilizar?

Três tipos de remetente:

  • Microsoft 365 - Outlook.com e caixas de correio do Microsoft 365, além de caixas de correio compartilhadas e caixas de correio de grupo.
  • Google - Caixas de correio do Gmail e do Google Workspace, além de seus aliases do tipo “Enviar e-mail como”.
  • SMTP - qualquer servidor SMTP, incluindo SendGrid, Mailgun, Amazon SES, Postmark ou o seu próprio.

A Microsoft e o Google se conectam por meio do OAuth; portanto, não há credenciais para armazenar ou atualizar.

Qual é a diferença entre um layout transacional e um layout de marketing?

O tipo de e-mail que o(a) senhor(a) escolhe ao criar um layout. Transacional é a opção padrão, e todos os layouts criados antes da existência dessa opção são transacionais: confirmações de pedidos, atualizações de remessa, avisos sobre a conta, enviados como antes para todos os destinatários na linha “Para”.

O marketing é destinado a boletins informativos, promoções, solicitações de avaliações e e-mails de reconquista. Um e-mail de marketing é enviado com uma mensagem por destinatário, cada uma com seu próprio link para cancelar a inscrição, termina com sua frase de cancelamento de inscrição e os dados da empresa, e ignora os clientes que cancelaram a inscrição. Ele é enviado por meio da ação Send Marketing Email no Shopify Flow; a ação Send Transactional Email oferece apenas modelos transacionais. Consulte E-mails de marketing e cancelamentos de inscrição.

Como posso saber se o remetente e o layout de uma etapa do Shopify Flow foram salvos?

Depois de clicar em Salvar na página de configuração da etapa, a mensagem Configuração salva com sucesso aparecerá na parte inferior da página. Caso o salvamento falhe, uma mensagem em vermelho informará que suas alterações não foram salvas: feche a página, abra a etapa novamente a partir do seu fluxo de trabalho e salve mais uma vez.

Ao abrir a etapa novamente, a página exibe o remetente e o layout salvos, com uma visualização do layout abaixo deles. No fluxo de trabalho, o cartão da etapa indica o nome do layout e do remetente.

Se o(a) senhor(a) duplicar um fluxo de trabalho ou copiar e colar a etapa de e-mail, abra a etapa na cópia e selecione novamente o remetente e o layout: o Shopify Flow trata a cópia como uma nova etapa.

Como um cliente cancela a assinatura e o que acontece a seguir?

Todo e-mail de marketing contém um link para cancelar a inscrição no rodapé. Ele abre uma página de confirmação no idioma do e-mail com um botão Cancelar inscrição; apenas abrir o link não altera nada. E-mails enviados por meio de um servidor SMTP ou de um remetente do Google também contêm os cabeçalhos que permitem que o Gmail, o Apple Mail e outros programas exibam seu próprio botão de cancelamento de inscrição com um clique. Remetentes do Microsoft 365 não podem definir esses cabeçalhos; portanto, nesse caso, o link do rodapé é a única opção disponível.

A partir de então, o endereço é omitido de todos os e-mails de marketing. Se todos os destinatários do campo “Para” de uma etapa tiverem cancelado a inscrição, nada será enviado: o histórico mostra o evento como Ignorado (cancelou a inscrição), a etapa do fluxo retorna SKIPPED e nenhuma ação do seu plano é acionada. Os e-mails transacionais continuam sendo enviados ao cliente. A página Cancelamentos de inscrição lista todas as pessoas que cancelaram a inscrição, permite que você adicione um endereço manualmente, reinscreva alguém quando o cliente solicitar e exporte a lista como CSV.

Posso enviar um e-mail de marketing para vários clientes de uma só vez?

Até 20 destinatários por ação. Cada um recebe seu próprio e-mail com seu próprio link para cancelar a inscrição, e toda a etapa ainda conta como uma ação no seu plano e uma entrada no Histórico, com o resultado de cada destinatário nela. Os destinatários além do 20º são registrados como não enviados. Para um público maior, configure o fluxo de trabalho de forma que o Shopify Flow execute a etapa uma vez por cliente.

Por que minha variável está aparecendo em branco?

Os modelos são projetados para serem tolerantes: uma variável desconhecida é substituída por uma string vazia, em vez de gerar um erro; assim, um erro de digitação nunca bloqueia o e-mail de um cliente. A desvantagem é que um erro de digitação aparece como um espaço em branco.

Agora, o aplicativo identifica isso para você. Um envio em tempo real em que um marcador de lugar não gerou nenhum resultado é sinalizado como** Variáveis vazias** no Histórico; ao abri-lo, é indicado exatamente quais são essas variáveis e se o Shopify Flow as enviou vazias ou nem as enviou.

Para evitar isso desde o início, utilize o cartão “Use in Shopify Flow” em seu layout - ele gera as variáveis (JSON) com todas as chaves já corretas. Consulte Transmissão de dados de umShopify Flow.

Meu e-mail de teste parece estar correto, mas o e-mail real está em branco. Por que isso acontece?

Porque utilizam dados diferentes.

As variáveis de teste no editor de layout influenciam apenas a visualização prévia e o envio do e-mail de teste. Uma execução real do Shopify Flow ignora completamente as variáveis e utiliza o que quer que a ação do Shopify Flow envie no campo Variáveis (JSON).

Portanto, um e-mail de teste com boa aparência comprova que seu design funciona. Isso não comprova nada sobre sua configuração do Shopify Flow. Sempre execute o fluxo de trabalho de verdade uma vez e, em seguida, verifique o Histórico.

Como devo preencher o campo “Variáveis (JSON)”?

Não digite manualmente. Abra o layout do seu e-mail e localize o cartão “Usar no Shopify Flow” - ele contém o JSON exato para esse layout, com todos os nomes das chaves corretos. Clique em Copiar JSON e cole-o na ação do Shopify Flow.

O aplicativo preenche automaticamente a propriedade “Shopify Flow” para os campos que reconhece (nome do cliente, nome do pedido, valor total do pedido, URL da página de status). Qualquer outro campo exibe <pick a Flow variable>, para que o senhor possa substituí-lo utilizando o próprio seletor de variáveis do Shopify Flow.

Guia completo: Transmissão de dados de umShopify Flow.

Por que meu item de linha/variante do produto/variável de produto está sempre vazia?

Como um pedido possui muitos itens de linha, não há um único valor a ser lido. {{ order.lineItems.variant.title }} não retorna nada.

Você pode enviar a lista completa e percorrê-la em seu layout usando um bloco Loop, ou transformá-la em uma string dentro do Shopify Flow com um loop {% for %}. Ambas as abordagens estão descritas em Transmissão de dados de umShopify Flow.

Essa é a causa mais comum de uma variável vazia; por isso, o aplicativo exibe um aviso quando o nome de uma variável se assemelha a dados de itens de linha.

Meus e-mails vão acabar na pasta de spam?

A capacidade de entrega depende da caixa de correio de origem, e não deste aplicativo. Como as mensagens são enviadas por meio do seu provedor e do seu domínio, você herda sua própria reputação de remetente.

Para aumentar suas chances:

  • Envie a partir de um domínio com SPF, DKIM e DMARC devidamente configurados.
  • Utilize um endereço de remetente em um domínio de sua propriedade, e não um endereço gratuito destinado ao consumidor.
  • Mantenha os e-mails transacionais como tal. Os destinatários esperam receber atualizações sobre pedidos e avisos relativos à conta; já o envio em massa de mensagens de marketing a partir de uma configuração transacional não é esperado. Utilize um layout de marketing para boletins informativos e promoções, de modo que cada um deles contenha um link para cancelar a inscrição e que os clientes que optaram por não receber essas mensagens sejam excluídos. Consulte E-mails de marketing e cancelamentos de inscrição.
  • Inclua um endereço postal válido e dados de identificação no seu modelo de rodapé e preencha os dados da empresa na seção “Configurações”, “E-mails de marketing”.
Posso enviar para mais de um destinatário?

Sim. Os campos Para, CC e CCO aceitam vários endereços, um por linha. O envio completo conta como uma única ação no seu plano.

Um modelo transacional é enviado como um único e-mail para todos os destinatários da linha “Para”. Um modelo de marketing é enviado como um e-mail por destinatário da linha “Para” (no máximo 20), cada um com seu próprio link para cancelar a inscrição, com CC e CCO em todos eles; trata-se, ainda assim, de uma única ação.

Um e-mail de teste consome minha cota?

Não. O envio de e-mail de teste e o botão Testar da solicitação HTTP são gratuitos. Apenas as ações acionadas pelo Shopify Flow são contabilizadas. As ações que falham antes de serem executadas - seja por uma configuração incorreta ou por uma tentativa repetida - têm sua cota reembolsada.

Por que meu e-mail exibe [object Object]?

O senhor interpolou um objeto inteiro, em vez de um campo desse objeto. As solicitações HTTP serializam objetos para JSON automaticamente; os e-mails, não.

Utilize {{ variables.customer.firstName }} em vez de {{ variables.customer }}, ou utilize um bloco de loop para percorrer um array.

O que acontece se eu excluir algo que ainda está em uso?

É permitido. O aplicativo exibe um aviso e informa quantas etapas do Shopify Flow fazem referência ao item, mas não impede que o senhor faça isso.

Posteriormente, qualquer etapa do Shopify Flow que ainda aponte para o item excluído apresentará uma falha com um erro claro que aparecerá no Histórico - por exemplo, Email template not found (Modelo de e-mail não encontrado). Para corrigi-las, redirecione essas etapas para um substituto.

Deliberadamente, não bloqueamos isso. A referência é mantida até que o aplicativo seja desinstalado; portanto, um aviso de “ainda em uso” costuma ser um resquício de um fluxo de trabalho que o(a) senhor(a) já excluiu ou reconstruiu no Shopify Flow, e não há como distinguirmos essa situação.

Uma exceção: um arquivo enviado é verificado adequadamente antes de ser removido, pois o mesmo arquivo pode ser reutilizado em vários layouts.

É possível alterar um layout do Visual Builder para HTML posteriormente?

Não. A escolha do editor é definida no momento em que o layout é criado, pois os dois armazenam seu conteúdo de maneiras diferentes. Crie um novo layout no modo desejado e redirecione sua ação do Shopify Flow para ele.

No modo de texto rico/HTML, é possível alternar entre o editor de texto rico e o HTML bruto; no entanto, voltar ao modo de texto rico pode simplificar tabelas complexas e estilos embutidos.

Posso reutilizar um modelo em vários e-mails?

Sim, de duas maneiras:

  • A opção Salvar como modelo armazena um projeto completo na seção Meus modelos, pronto para ser utilizado como ponto de partida para um novo layout. Essa galeria contém apenas os projetos que o próprio usuário salvou.
  • As predefinições de cabeçalho e rodapé são compartilhadas em tempo real: basta editar a predefinição uma vez e todos os layouts que a utilizam serão atualizados.

Você também pode exportar um layout e importá-lo para outra loja.

O que acontece quando eu atingir o limite do meu plano?

Outras ações do Shopify Flow são rejeitadas com um erro de limite do plano, e o Shopify Flow marca a etapa como malsucedida. Nada é colocado na fila; portanto, essas mensagens não são enviadas posteriormente.

A cota é calculada em um período contínuo de 30 dias; portanto, a capacidade é liberada à medida que as ações mais antigas são excluídas. Ative as notificações de cota para receber alertas quando atingir 80% e 100%. Consulte Planos e uso.

Posso anexar uma fatura em PDF a um e-mail?

Sim. Os anexos podem ter até 15 MB por arquivo e 20 MB por layout, no modo Anexar. Acima desses limites - ou ao enviar por meio do Microsoft 365, que rejeita anexos incorporados com mais de 4 MB, mude para o modo Link e o e-mail conterá um link para download. Consulte Anexos e imagens.

Por que a Microsoft ou o Google exibem um nome diferente para o aplicativo?

A tela de consentimento pode exibir Shopify Flow Extensions, o nome anterior do aplicativo. Trata-se do mesmo aplicativo - o nome de registro no OAuth ainda não foi atualizado. É seguro aprovar.

O Shopify Sidekick pode utilizar este aplicativo?

Sim, somente para leitura. O Sidekick pode listar seus layouts, remetentes, solicitações HTTP e nomes de segredos, apresentar o histórico de execuções e explicar por que uma ação específica falhou.

Ele nunca retorna valores confidenciais, senhas SMTP, tokens OAuth ou o conteúdo das mensagens, e não pode alterar nada - em vez disso, ele o conecta ao aplicativo.

Onde meus dados são armazenados?

Na UE. As bases de dados e os caches são locais, por região, com criptografia em repouso, e as credenciais - senhas SMTP, tokens OAuth e segredos - recebem uma camada adicional de criptografia de envelope por meio de um serviço dedicado de gerenciamento de chaves. As credenciais em texto simples nunca são armazenadas.

Ainda precisa de ajuda?

Utilize a Central de ajuda para relatar um bug, solicitar um recurso ou entrar em contato diretamente com o suporte. O balão de bate-papo no aplicativo está presente em todas as páginas do aplicativo e costuma ser a forma mais rápida, já que mantém a conversa vinculada à sua loja.