Introdução ao livro Workflow Transactional Email

Shopify Flow inicia fluxos de trabalho e decide o que fazer. O que ele não consegue fazer por conta própria é acessar recursos fora do Shopify: enviar um e-mail com a identidade visual da sua marca a partir da sua própria caixa de correio ou chamar uma API externa. O Workflow Transactional Email oferece exatamente isso. Ele oferece ao Shopify Flow três ações: “Enviar e-mail transacional”, “Enviar e-mail de marketing” e “Solicitação HTTP”, de modo que um fluxo de trabalho possa enviar um e-mail a um cliente a partir do seu domínio, com o seu design e os seus dados, além de enviar dados para qualquer serviço, sem precisar escrever uma única linha de código.

Como tudo se encaixa

1. Conecte um remetente. Sua caixa de correio do Microsoft 365 ou do Google com um clique, ou seu próprio servidor SMTP. Todos os e-mails são enviados sob o seu domínio e com a sua reputação.
2. Crie o e-mail. O editor visual monta um layout a partir de blocos; ou cole seu próprio código HTML. Cabeçalhos e rodapés reutilizáveis garantem que todas as mensagens estejam alinhadas à identidade visual da marca.
3. Adicione a ação em Shopify Flow. Selecione o remetente e o layout nessa etapa, transfira os dados por meio do campo “Variáveis (JSON)”, e o fluxo de trabalho será enviado.

O que o senhor recebe

• Envie e-mails a partir de sua própria caixa de correio. O Microsoft 365, o Google Workspace e o Gmail se conectam via OAuth; qualquer servidor SMTP também funciona. Testes de envio e verificações de conexão estão integrados, e o aplicativo avisa quando um remetente deixa de funcionar. Consulte Visão geral dos remetentes de e-mail.
• Um verdadeiro editor de e-mails. Texto, títulos, imagens, botões, divisórias, colunas e uma tabela de itens de linha, além de blocos de comércio: ficha de produto e grade de produtos, preço, código de desconto, contagem regressiva, rastreamento de pedidos, classificação por estrelas, depoimentos, links de redes sociais, vídeo, assinatura, tabela e visualização no navegador. As seções podem ser exibidas somente quando uma condição for verdadeira. Consulte Crie um layout de e-mail e Blocos de conteúdo: produto, desconto, contagem regressiva, rastreamento e muito mais.
• Códigos de desconto exclusivos e contagens regressivas em tempo real. Um bloco de desconto pode gerar um código de uso único em sua loja para cada e-mail; o bloco de contagem regressiva exibe a contagem regressiva na caixa de entrada na forma de uma imagem animada.
• E-mails no idioma do seu cliente. Um modelo contém traduções; o campo “Idioma” da etapa do Shopify Flow (geralmente {{order.customerLocale}}) seleciona a tradução correta. Consulte Envie e-mails no idioma do seu cliente.
• Anexos. Faça o upload de um arquivo, recupere-o a partir de um link no momento do envio ou anexe o arquivo que outro aplicativo tenha salvo no pedido ou no cliente, como, por exemplo, um PDF de fatura em um metacampo. Consulte Anexos e imagens e Anexar um arquivo a partir de um metacampo de pedido ou de cliente.
• E-mails de marketing com opção de cancelamento. Um modelo de e-mail de marketing envia um e-mail por destinatário, contendo seu próprio link para cancelamento de inscrição e os dados da sua empresa; os clientes que cancelarem a inscrição não receberão mais e-mails a partir de então. Consulte E-mails de marketing e cancelamentos de inscrição.
• Solicitações HTTP em todos os planos do Shopify. A ação “Enviar solicitação HTTP” do próprio Shopify requer um plano superior. Esta ação, por outro lado, não. Consulte Faça uma solicitação HTTP a partir de Shopify Flow.
• Segredos e Liquid. As chaves de API e senhas são armazenadas uma única vez, criptografadas e referenciadas como {{ secrets.keyName }}; assuntos, corpos, URLs e cargas úteis recebem {{ variables.xxx }} do Shopify Flow. Consulte Segredos e Variáveis e Líquido.
• Crie e traduza layouts com IA, mantenha todas as versões e sincronize os layouts com um repositório do GitHub. Consulte Crie, edite e traduza layouts com IA, Histórico de versões do layout e Mantenha um histórico ilimitado de layouts no GitHub.
• Um histórico completo. Cada envio e cada solicitação são registrados com o status, o horário e o conteúdo enviado, podendo ser reenviados. Consulte Histórico e solução de problemas.
• Nada será lido da sua loja, a menos que o senhor autorize. O aplicativo é instalado sem escopos de acesso. Existem quatro permissões opcionais, cada uma correspondente a um recurso (anexar um arquivo de metacampo, criar códigos de desconto), concedidas no momento da instalação e revogáveis na página “Permissões”. Consulte Permissões: o que o aplicativo pode acessar na sua loja.
• Uma API e um servidor MCP para suas próprias ferramentas e assistentes de IA. Consulte API para desenvolvedores e MCP.

As três ações do Shopify Flow

Enviar e-mail transacional

Envia um modelo transacional: confirmações de pedidos, atualizações de remessa, avisos sobre a conta. Essas mensagens são enviadas a todos, inclusive aos clientes que cancelaram a inscrição nas comunicações de marketing.

Campo em Shopify Flow	O que ele faz
Para e-mail(s)	Um ou mais destinatários, um por linha. Normalmente, uma variável do Shopify Flow, como {{customer.defaultEmailAddress.emailAddress}}
E-mail(s) em CC, E-mail(s) em CCO	Opcional, um por linha
Variáveis (JSON)	Dados para o layout, por exemplo, {"customerName": "John", "orderId": "12345"}, utilizados como {{ variables.customerName }}
Idioma	Opcional. Seleciona a tradução do layout, geralmente {{order.customerLocale}}
Campo “Responder para”, Nome do remetente	Opcional. Substituir as configurações padrão do remetente para esta etapa
Pedido, Cliente	Opcional. O pedido ou cliente ao qual a etapa se refere; necessário apenas quando o layout anexa um arquivo a partir de um metacampo

O remetente e o layout são selecionados na própria página de configuração da ação (Enviar de e Layout), e não nesses campos.

A ação retorna um resultado com base no qual as etapas posteriores do Shopify Flow podem se ramificar:

Campo de retorno	Valores
status	SENT ou FAILED, ou SKIPPED, quando um layout direcionado ao marketing continha apenas destinatários que haviam cancelado a assinatura
messageId	O ID da mensagem do provedor, quando disponível
provider	GOOGLE, MICROSOFT, SMTP ou DEFAULT

Enviar e-mail de marketing

Envia um modelo de marketing: um boletim informativo, um pedido de avaliação, uma oferta de reconquista. Os campos são os mesmos descritos acima, mas apenas os modelos de marketing estão disponíveis, e o envio ocorre de maneira diferente:

• um e-mail por destinatário do campo “Para” (no máximo 20 por ação), cada um com seu próprio link para cancelar a inscrição,
• sua frase de cancelamento de inscrição e os dados da empresa no rodapé,
• os clientes que cancelaram a assinatura são ignorados.

Campo de retorno	Valores
status	SENT, FAILED ou SKIPPED (todos os destinatários haviam cancelado a inscrição)
messageId	O ID da mensagem do provedor do primeiro e-mail enviado, quando disponível
provider	GOOGLE, MICROSOFT, SMTP ou DEFAULT

Todas as informações sobre layouts de marketing, o rodapé e a lista de cancelamento de inscrição estão disponíveis em E-mails de marketing e cancelamentos de inscrição.

Solicitação HTTP

Executa uma solicitação HTTP que o(a) senhor(a) salvou no aplicativo: método, URL, cabeçalhos e corpo, incluindo segredos e variáveis em qualquer um desses elementos.

Campo em Shopify Flow	O que ele faz
Substituição de variáveis ou do corpo (JSON)	Seja por meio de variáveis utilizadas como {{ variables.xxx }} na URL, nos cabeçalhos e no corpo da mensagem, seja por meio de uma substituição do corpo: {"body": {...}} substitui integralmente o corpo configurado

Campo de retorno	Valores
status	O código de status HTTP
response	O corpo da resposta como JSON convertido em string

Navegando pelo aplicativo

Página	Para que serve
Página inicial	Guia de configuração, utilização em relação ao seu plano, taxa de sucesso, status de envio, gráfico de ações e atividades recentes
Remetentes de e-mail	Contas conectadas do Microsoft 365 e do Google, servidores SMTP e a caixa de diálogo de envio de teste
Layouts de e-mail	Os próprios e-mails, nas abas “Transacional” e “Marketing”: assunto, design, idiomas, anexos, variáveis de teste
Cabeçalho e rodapé	Predefinições reutilizáveis de cabeçalho e rodapé compartilhadas entre layouts
Solicitações HTTP	Solicitações salvas: método, URL, cabeçalhos, corpo
Segredos	Valores criptografados aos quais o senhor faz referência como {{ secrets.keyName }}
História	Cada execução com detalhes sobre status, tempo, solicitação e resposta, além de um reenvio
Cancelamentos de assinatura	Clientes que cancelaram o recebimento de seus e-mails de marketing, com opções de pesquisa, adição manual, reinscrição e exportação em CSV
Desenvolvedor	Chaves de API, o comando “MCP connect”, IA e conexões com o GitHub
Permissões	As permissões opcionais das lojas, cada uma com uma concessão e uma revogação
Configurações	Configurações padrão de e-mail, textos do rodapé de marketing por idioma, cores da marca, fontes personalizadas e alertas
Ajuda	Suporte, links para a documentação e seu plano

Planos e limites

Plano	Preço	Ações por período móvel de 30 dias	Armazenamento de anexos
Gratuito	$0	500	500 MB
Entrada	US$ 15 por mês	5.000	2 GB
Crescer	US$ 35 por mês	15.000	10 GB
Ilimitado	US$ 100 por mês	Ilimitado	50 GB

O faturamento anual está disponível em todos os planos pagos e sai mais barato do que o mensal. Uma ação corresponde a um e-mail enviado ou a uma solicitação HTTP executada; um e-mail de marketing enviado a vários destinatários ainda conta como uma ação. Todos os planos incluem todos os recursos; os planos diferem apenas em volume e espaço de armazenamento. Consulte Planos e uso.

Comece por aqui

Neste pedido, o primeiro e-mail será enviado em cerca de quinze minutos:

1. Instalar e configurar - o aplicativo no seu painel de administração.
2. Visão geral dos remetentes de e-mail - conecte a caixa de correio ou o servidor SMTP de onde os e-mails são enviados.
3. Crie um layout de e-mail - crie o e-mail ou comece a partir de um dos modelos disponíveis em Modelos de fluxo de trabalho.
4. Transmissão de dados de umShopify Flow - adicione a ação a um fluxo de trabalho e transfira os dados.
5. Verificando a configuração do seu e-mail - envie um teste e consulte o resultado no Histórico.

Então, conforme for necessário: Envie e-mails no idioma do seu cliente, E-mails de marketing e cancelamentos de inscrição, Anexar um arquivo a partir de um metacampo de pedido ou de cliente, Faça uma solicitação HTTP a partir de Shopify Flow, Notificações e alertas e Perguntas frequentes.